The section shows all users who have interacted with the agent - their activity, message statistics, and last contact date.
How to access this section
Note: In the current version, the "Users" tab is temporarily disabled in the agent interface (commented out in code).
- From agent list: click "Open" on agent card → "Users" tab (unavailable)
- Direct link:
/agents/{id}/users
Main features
User table
Shows detailed information about each agent user:
Table columns:
- Name - username (if specified)
- Platform - platform through which user contacts (Web, Telegram)
- Last Message - date of last message from user
- Sessions - total number of interaction sessions
- Chat Msg - number of messages in chats
- Sent Msg - number of sent messages
Pagination
- Records per page: configurable (default 20)
- Page switching: "Back/Forward" buttons and direct page selection
- Automatic reset: when changing page size, returns to first page
Search (in development)
There's a search field at the top, but it's currently disabled with "coming soon" note.
Useful user information
User types by platforms
- Web - web interface users
- Telegram - Telegram bot users
Activity metrics
- totalSessions - how many times user started new dialogue
- totalChatMessages - total number of messages in correspondence
- totalMessagesSent - how many messages user sent
Additional fields (hidden)
There are commented fields in code:
- Subscription - user subscriptions (with tags)
- userCost - cost of serving the user
Usage scenarios
Active audience analysis
- Open agent users section
- Sort by last message date
- Study which users have been active recently
- Note number of sessions for each
Understanding user behavior
- Compare number of sessions and messages
- Users with many sessions but few messages - possibly have trouble formulating requests
- Users with few sessions but many messages - active users
Platform popularity assessment
- Review "Platform" column
- Assess which platform has more contacts
- This helps understand where to focus improvement efforts
Interface states
Data loading
A full-screen spinner is displayed during loading.
Empty list
If the agent has no users, the table will be empty.
Loading error
In case of data loading problems, corresponding message will be displayed.
Limitations
Search unavailable
User search is not yet implemented and marked as "coming soon".
Lack of detailed information
Cannot view:
- Message history of specific user
- Detailed analytics per user
- User profile
No user management
Cannot:
- Block user
- Delete user
- Change settings for specific user
Frequently asked questions
Why don't I see Users tab?
The tab is temporarily disabled in the interface. Access is only possible via direct link.
How to understand message statistics?
- Sessions - number of separate dialogues
- Chat Msg - all messages in chats (including from agent)
- Sent Msg - only messages from user
Why are some users without names?
Users may not specify name during registration or use anonymous access.
Can I export user list?
Export is not supported in current version.
Planned improvements
Search and filtering
- Search by username
- Filter by platform
- Filter by activity date
Detailed information
- View message history
- User statistics
- Activity graph
Management
- Ability to block user
- Settings for specific user
- Data export
Related sections
- Agent analytics - general user statistics
- Agent settings - access and limitation settings
- User management - general system user management