Documentation Index
Fetch the complete documentation index at: https://docs.wittify.ai/llms.txt
Use this file to discover all available pages before exploring further.
Open this page by clicking any agent in the All Agents Overview panel on the dashboard, the My Agents sidebar list, or the in-sidebar agent switcher. The route is
/agents/{agentId}. This is the landing tab for Manage Agent and the default destination of every agent link in the app.How this page works
Every chart, KPI, and table on the page is filter-reactive. Pick a date range from the hero (Last 7 days / Last 30 days / Last 90 days / Custom) and every section recomputes against that window. There is no Apply button, the page updates as you change the range. The selected range is shared across the whole page, you don’t pick it twice.Manage Agent shell
Before the content, the surrounding chrome:Sidebar nav
When you’re on a Manage Agent route, the dashboard sidebar swaps in a per-agent navigation. From top to bottom:- Back to Home , returns you to the main dashboard active view.
- Agent switcher dropdown , lists every agent you can switch to, plus a Create an Agent entry at the bottom that opens a 3-card type picker (Text Agent, Voice Agent, Hybrid Agent) and routes straight into the Create Agent wizard for the variant you pick.
- Main items:
- Agent Overview (the page you’re reading, highlighted)
- Chat Conversations , hidden for voice-only agents
- Voice Conversations , hidden for text-only agents
- Leads / Tickets
- WhatsApp Campaigns (text + hybrid only), Outbound Voice Campaigns (voice + hybrid only). Both groups have an Archived + Deleted chevron toggle.
- Agent Settings collapsible , deep-links into each wizard section as an inline editor: Text Settings / Voice Settings / Appearance / Knowledge Base / Tickets & Leads / Integrations / Deployment. Auto-expands when you’re on a settings sub-route.
- Assigned Users collapsible , placeholder rows for upcoming team features (every item shows a Coming Soon chip).
Topbar
The standard dashboard topbar with two additions on this surface:- Test Your Agent button on the end edge, present on every Manage Agent page. Opens the test sheet documented at Test Your Agent.
- A breadcrumb that reads Dashboard / Agents /
{agent name}.
Hero with date range
The first section of the page. Shows:- Agent name in a large heading
- Type chip , one of Text (blue), Voice (indigo), Hybrid (purple)
- Status chip , Active (green) or Draft (muted)
- Date range selector on the end edge, four buttons:
| Range | What it covers |
|---|---|
| Last 7 days | Most recent week |
| Last 30 days | Default. Most recent 4 weeks. |
| Last 90 days | Most recent quarter |
| Custom | Opens a calendar popover for any From / To pair |
KPI strip (5 cards)
A 5-column grid (collapses to 2 + 3 on smaller screens). Each card shows a title, a number, a delta vs. the previous window of the same length (green up-arrow / red down-arrow), and a small sparkline at the bottom.| Card | What it counts |
|---|---|
| Conversations | Total chat + call sessions in the range |
| Avg Response Time | Mean time from a customer message to the agent’s reply |
| Tickets Created | New support tickets the agent filed |
| Leads Captured | New leads the agent collected via the lead form |
| Avg Rating | Average post-conversation rating, on a 5-star scale |
Channel chart
A donut chart titled Channels showing where conversations came from in the date range:- Web (indigo)
- WhatsApp (green)
- Messenger (blue)
- Instagram (gradient pink)
- X (black / white)
- Telegram (sky blue)
- Phone (slate, voice only)
Day chart
Bar chart titled Conversations by Day. X axis is days of the week (Sunday-first per product direction in Arabic, Monday-first in English). Y axis is conversation count.Hour chart
Bar chart titled Conversations by Hour. X axis is 0 to 23. Y axis is conversation count. Useful for spotting peak hours and staffing your phone line accordingly.Widget Funnel
5-stage funnel showing how many visitors made it through each step of the chat:- Opened , widget appeared on the page
- Started , visitor clicked into the chat
- First message , visitor sent at least one message
- Resolved , conversation reached a resolved state (positive sentiment + no handoff)
- Rated , visitor rated the conversation
Voice metrics card (voice + hybrid only)
A grid of voice-specific KPIs:- Avg Call Duration , mean call length
- Peak Hour , the busiest single hour in the range
- AHT (average handle time) , total call time including hold and post-call work
- Call Drops , calls that ended abnormally (caller hung up before agent responded)
Text metrics card (text + hybrid only)
A grid of text-specific KPIs:- Avg Response Latency , how long from customer message to agent reply
- Messages per Conversation , mean message count
- Character Counts , total inbound + outbound character count
Resolved card
A donut showing the split between Resolved and Unresolved conversations. The center number is the resolved percentage.Sentiment card
A stacked horizontal bar with three segments: Positive (green), Neutral (slate), Negative (red). Hovering shows the count for each segment.Ratings card
A 5-row chart showing rating distribution. Each row is one star count (1 through 5) with a horizontal bar showing how many conversations received that rating. The summary at the top shows the overall mean (e.g. 4.3 of 5 with 152 ratings).Intents card
The most common reasons customers contacted the agent. Each intent row shows:- The intent name
- A horizontal bar with the count
- A delta vs. the previous window
Customize Intents modal
Title: Customize Intents. Description: Toggle the built-in intents your agent tracks, and add custom ones for your business. The modal has a draft pattern (your changes don’t persist until you click Save):- Built-in intents (toggle each on or off via switch). The active count is shown in the title (e.g. 14 of 18 intents enabled).
- Custom intents (rows you’ve added). Each has a delete trash icon. Removing a custom intent opens a confirmation: Remove “
{intent name}”? This cannot be undone. Built-in intents cannot be deleted, only switched off. - Add custom intent input at the bottom. Up to 60 characters. Case-insensitive deduplication, you can’t add Refund if refund already exists.
Language card
Distribution of conversation languages (English, Arabic, plus any others detected). Each row shows language name, count, and a percentage bar.Escalations card
How many conversations escalated to a human. Two numbers: total escalations and percentage of conversations escalated. A small text under: Escalation = a conversation where the Human Handoff tool fired.Recent Conversations
A scrollable list of the most recent conversations in the range.Desktop layout (7-column grid)
| Column | Content |
|---|---|
#number | Conversation ID |
| Time | Relative timestamp (e.g. 2 hours ago) |
| Channel | Brand icon dot |
| Sentiment | Pill (positive / neutral / negative) |
| Status | Pill (open / resolved / handoff) |
| Duration | e.g. 3:42 |
| Summary | First line of the conversation |
Mobile layout (stacked card)
A two-row card per conversation: ID + time on the top row, channel + sentiment + status pills on the next, the summary as a line below. Tapping the card opens the same destination as desktop. Click any row to deep-link into the Chat Conversations inbox with?selected=<conversationId> so the conversation is pre-selected when the inbox opens.
Activity Log
A paginated event feed of agent-level events: Agent activated, Settings saved, Integration connected, Agent deactivated, Knowledge file uploaded, etc. Each row has an icon, a one-line label, and a timestamp. Pagination controls at the bottom: Prev / Next with Page X of Y.Variant differences (recap)
- Text-only agents hide: Voice Conversations sidebar item, voice settings deep-link, voice KPIs in the strip, the Voice metrics card.
- Voice-only agents hide: Chat Conversations sidebar item, text settings deep-link, text KPIs in the strip, the Text metrics card, social channel slices in the Channel chart.
- Hybrid agents see everything.
Common questions
The page shows zeros across the board for a brand-new agent.
The page shows zeros across the board for a brand-new agent.
That’s expected. Until the agent receives traffic on at least one connected channel, every chart is empty. Activate the agent in Deployment, connect a channel, and counts populate as conversations come in.
I changed the date range but the Recent Conversations list looks the same.
I changed the date range but the Recent Conversations list looks the same.
Recent Conversations always shows the latest conversations in the date range, but it caps at the most recent 50. If your agent had less than 50 in the wider range, the list won’t grow when you stretch it.
The Sentiment card has a thin red segment but the Ratings card averages 4 stars. Aren't these telling different stories?
The Sentiment card has a thin red segment but the Ratings card averages 4 stars. Aren't these telling different stories?
Sentiment is computed from message tone (the model’s read of how the customer felt). Ratings are explicit stars the customer gave at the end. They can disagree, customers often rate above their actual sentiment out of politeness, or below it after a bad final touchpoint. Use both as signals.
Can I export this data?
Can I export this data?
Not from this page directly. The Tickets & Leads page has CSV export, the Conversation pages can export individual transcripts, and a full data export is on the roadmap. For now, screenshot the dashboard for sharing.
How often does this update?
How often does this update?
Numbers are computed on every page load. There’s no live polling, refresh the page to see the latest.
Next
Chat Conversations
The full chat inbox for this agent.
Voice Conversations
Recordings, transcripts, and AI summaries.
Leads & Tickets
Captured records grid with filters and CSV export.
Agent Settings
Edit any wizard section without leaving Manage Agent.

