Visitors
Track who is currently browsing your website in real time, see what pages they visit, and start a live chat conversation with any visitor instantly.
Overview
The Visitors page gives you a live view of every person currently active on a page where your Yaplet widget is installed. The list updates automatically as visitors arrive, navigate between pages, or leave — so you always have an accurate picture of who is on your site right now.
Navigate to Dashboard → Audience → Visitors to open the visitors table.
Visitor Table
Each row in the table represents a single active visitor and shows the following details:
| Column | Description |
|---|---|
| Visitor | Name or identifier (if known), otherwise a generated visitor ID |
| Widget | Which widget the visitor is connected through, shown with its avatar |
| Device | Icon indicating desktop, mobile, or tablet |
| Last URL | The most recent page the visitor viewed — clickable to open it in a new tab |
| Country | Country flag based on the visitor's IP geolocation |
| Last Seen | Timestamp of their most recent activity |
Filtering & Sorting
Use the filter bar above the table to narrow down results:
- Visitor — free-text search by visitor name or identifier
- Last URL — search by page URL
- Widget — select one or more widgets to show only their visitors
- Device — filter by desktop, mobile, or tablet
- Country — pick specific countries from the dropdown
Click any column header to sort the table. The Last Seen column supports date-based sorting so you can quickly find the most or least recently active visitors.
Recent Events
Each visitor row has a clock icon in the actions column. Clicking it opens a modal showing the visitor's last 10 events with timestamps. Events are loaded on demand — no data is fetched until you click — so the page stays fast even with many visitors online.
Event types you may see include page views, session starts, widget opens, agent requests, agent joins, transfers, email updates, ratings, and visitor bans/unbans. Page view events display the visited URL, while all events show a relative timestamp (hover for the full date).
Starting a Conversation
Every visitor row has a chat icon in the actions column. Click it to jump straight to that visitor's chat in the Inbox, where you can send them a message in real time.
Real-Time Updates
The visitor list refreshes automatically whenever the WebSocket connection receives new presence data. Updates are throttled to a minimum 10-second interval to keep the page responsive without hammering the API.