Skip to main content
The Email Analytics page is the reporting view for your email channel. It shows how many emails your AI agents are handling, how those conversations end, and how much of your volume gets resolved. Its companion view, Email History, lets you read any single thread in full — and step into one that is still running.

Getting there

1
In the left sidebar, find the Optimize section.
2
Select Email Analytics for the dashboard, or Email History to work with individual threads.
Neither Email History nor Email Analytics is in the default sidebar for account users, so add them with Customize sidebar at the foot of the sidebar, or press Cmd/Ctrl+K and search for Email History or Email Analytics. See Navigating Studio.
Email figures only start appearing once at least one of your agents is working email. Email agents pick tickets up from a connected Freshdesk mailbox — see Email Agents for the connection steps.

What the dashboard tracks

The page opens on Last 7 Days and shows five headline metrics, two outcome charts and a daily volume chart. The controls at the top apply to everything on the page.

Filters and time range

  • Agents — the menu reads All agents until you pick some. Choose one or more to see only their email conversations.
  • Time range — choose Today, Last 7 Days (the default), Last 30 Days or Custom Range.
  • Refresh — reloads the figures for your current agents and time range. The button reads Refreshing… while it loads.
Days are counted in your browser’s time zone. To count them in UTC instead, switch on Use UTC under Time zone in the time range menu. The caption on the Email volume by day chart (All times in …) shows which zone is in use.

Headline metrics

metric
The number of email conversations that ended in the selected period. It also counts customer emails an agent couldn’t answer, usually because your balance couldn’t cover an email session; see Insufficient-Balance and Error under Email outcomes.
metric
The number of distinct senders who emailed your agents in the period.
metric
The average number of messages per email conversation, which shows how much back-and-forth a typical thread takes. Every message in a thread’s transcript counts as one, so it includes the customer’s messages and the agent’s replies, and on a thread handed to a person, their replies and the handoff notices as well.
metric
The percentage of email conversations that were not User-Abandoned, Insufficient-Balance or Error. In other words, Contained plus Transferred, out of all emails in the period. A conversation handed to a person still counts as resolved, so read it alongside the Contained share of Email outcomes. Manage containment moves conversations between the Contained and Transferred slices of the charts, but it doesn’t change this figure.
metric
The percentage of rated email conversations the AI judged Satisfied. The AI infers this from the thread when the conversation ends; no survey is sent to the customer. It reflects how well the agent handled the thread, not the customer’s mood. See Customer Satisfaction (CSAT), which describes the same score for calls.
Each metric also shows its % change compared with the previous period of the same length, for example +5.0% vs previous 7 days. The label reads vs yesterday on Today, vs previous 7 days on Last 7 Days and vs previous 30 days on Last 30 Days. No % change is shown on a Custom Range.

Charts

chart
A donut chart of how the email conversations in the period ended: Contained, Transferred, User-Abandoned, Insufficient-Balance and Error. Each outcome shows its share and its count, and only outcomes that occurred appear. Hover over a slice to see its count. See Email outcomes below for how each conversation is bucketed.
chart
A donut chart that breaks down the dispositions recorded on every email conversation except User-Abandoned, Insufficient-Balance and Error, for example Contained, Escalated or an outcome you added to the agent. A blank disposition shows as Unknown Disposition. Under the chart, each disposition shows its share and count, with a plus or minus button beside it that adds it to or removes it from your containment list. Use Manage containment to review the list.
chart
A stacked bar chart of the email conversations for each day in the period. Each bar is split by outcome — Contained, Transferred, User-Abandoned, Insufficient-Balance and Error — so you can see both total volume and the mix on any given day. Hover over a bar to see the day’s total and each outcome’s count.

Manage containment

By default only the built-in Contained outcome counts as contained. If a handoff recorded under a particular disposition is a successful result in your workflow, you can mark that disposition as contained, so those conversations move from the Transferred slice to the Contained slice.
1
In the Transfer dispositions chart, select Manage containment. The Manage contained dispositions drawer opens.
2
To add one, type the disposition’s name in the Add disposition box (the example reads More_Info) and select Add, or press Enter. Type the name exactly as it appears in the Transfer dispositions chart, because matching is exact.
3
To take one off the list, select Remove beside it. Once the list has more than five entries, a Filter dispositions box helps you find one.
4
Select Close when you’re done.
You can also use the plus and minus buttons under the chart to add or remove a disposition without opening the drawer. A Containment list updated message confirms each change.
Manage containment only changes whether those conversations are labelled Contained or Transferred in the charts. It doesn’t change your Resolution rate, because both count as resolved.The list belongs to the workspace, so everyone using Email Analytics in it sees the same list, and a change re-labels past conversations as well as new ones. It applies to email conversations only. Each change is recorded in Audit Logs.

Live updates

On Today, Last 7 Days and Last 30 Days, and on a Custom Range that hasn’t ended, the dashboard updates live as email conversations finish. A green Live badge confirms it.
  • Pause live freezes the figures, which is useful when you want to study a snapshot without the numbers shifting. The badge changes to Live updates paused.
  • Resume live reloads the latest data and switches live updates back on.
  • On a Custom Range that has already ended, the page reads Viewing historical range. Resume live takes you back to Last 7 Days.
  • If the browser tab stays in the background for more than about 10 seconds, live updates stop, and the figures reload when you return to the tab.
While the page is live, an amber N in progress badge shows how many email conversations are open right now, and it refreshes about every 15 seconds. The count covers your whole workspace whichever agents you have selected, and it includes conversations that are with a human agent. Select the badge to open Email History with In-progress Only switched on, which lists the conversations the AI is still working. Switch on Escalated Only as well to include the ones with a person.

Email outcomes

Every email conversation is filed against one outcome once it ends. Two outcomes are built in:
  • Contained – the AI agent resolved the thread on its own.
  • User Abandoned – the conversation ended without a resolution because the customer stopped replying.
User Abandoned covers two situations that look different but count the same way: a customer who simply walked away mid-thread, and a thread that ran out of time through inactivity. Both are reported as abandoned, so a timeout is not a separate bucket to reconcile. A conversation handed to a human agent is recorded as Escalated when you escalate it yourself from Email History, and when the agent escalates it and you haven’t added any outcomes of your own. Once you have added some, the agent records an escalation under the one that fits best, and it appears under that name. See Outcomes in Email Agents. A customer email an agent couldn’t answer because your balance couldn’t cover an email session isn’t a conversation the agent took up, so it isn’t one of your outcomes. It is recorded as INSUFFICIENT_BALANCE, one record for each unanswered customer message, and the dashboard shows it as Insufficient-Balance. When the agent couldn’t answer for a reason other than your balance, such as a billing check the platform couldn’t complete, the record reads SYSTEM_ERROR and the dashboard counts it as Error instead. See Email History. The dashboard groups all of these into five buckets, which are the ones you see in Email outcomes and Email volume by day:
The dashboard spells the bucket User-Abandoned, with a hyphen. Email History’s Disposition column shows the outcome as it is recorded, so the same conversations read User Abandoned there.
Escalations are recorded when the human resolves the ticket, not at the moment of handover — whether the agent escalated or you selected Escalate in Email History. An escalated conversation stays open while a person works it, so its outcome, transcript and usage are written at their resolve time — and an escalation nobody closes stays out of reporting until someone does.

Email History

Optimize → Email History lists your workspace’s email conversations so you can review threads, replies and escalations. Select View on any row to open the full transcript drawer for that thread, with the customer’s messages and the agent’s replies in the order they were sent. The page opens on Last 7 Days. The controls work like this:
  • Search — type a sender email, an agent name or a Session ID. Matching is partial and ignores case. Search also checks the disposition as it is recorded.
  • Agents, time range and Refresh — in the header, and they work as they do on the dashboard, including Use UTC.
  • Filters — see Statuses and filters below.
  • Pin — select the pin on a row, or the Pin button in the drawer, to save a thread. Switch on Pinned Only to list just those.
  • Export — queues a file of your email conversations that match your time range, agents and Pinned Only setting. It runs in the background, so you are notified when it is ready for download, the same way as the Call History export. The file has an Agent Version column right after Agent Name; see What’s in the file.
Each row shows the sender (ID), with a thumbs-up or thumbs-down beside it once the AI has judged the thread, then Date, Message Count, Status, Agent, Session ID (with a copy button), Disposition and Actions, plus a Cost column where your account shows costs (it isn’t shown on the in-progress and escalated lists). A small tag under the agent’s name shows the agent version the conversation started on: V5, Draft (the unpublished draft) or Deleted version. Conversations from before agent versions existed, refused emails, and conversations on the in-progress and escalated lists have no tag. See Version History. The drawer is headed Email Details, with the Session ID and Ticket ID at the top, an AI Summary with an Agent version chip (for example V5 · Spring prices) and a Satisfied or Dissatisfied label, and the conversation under Email Thread. A customer email an agent couldn’t answer, usually because your balance couldn’t cover an email session, is listed as a red REJECTED row, one for each unanswered message. Its ID is the sender’s address, its Agent reads N/A, its Message Count is 0, its Disposition is INSUFFICIENT_BALANCE (SYSTEM_ERROR when the refusal wasn’t about your balance) and its Cost is -. The Agents filter still includes it. Opening it shows Email Details with a Session ID that SquawkVoice generated and no Ticket ID, because the agent never took the thread up. The ticket stays untouched in your mailbox, nothing is sent to the customer and nothing is billed. Once your balance is topped up, the agent picks the thread up again when the customer next writes. Unanswered emails from before 14 October 2026 weren’t recorded, and those refused before 20 October 2026 all read INSUFFICIENT_BALANCE, whatever the reason. The list refreshes in place when you change a filter or a search rather than blanking while it reloads. With In-progress Only or Escalated Only on, it also updates itself within a few seconds of a conversation starting, ending or gaining a message. While a transcript is open the list waits, and it catches up as soon as you close it. An open email thread doesn’t stream, so reopen it to see new replies.

Statuses and filters

The Filters menu carries five independent switches. The number beside Filters shows how many are on. In-progress Only and Escalated Only can both be on at once, and then both kinds of live conversation are listed. While either is on, the list shows live conversations only. The time range, the search box and the other three switches aren’t applied, but the agent filter still is.

What the transcript contains

The transcript drawer shows the handoff itself, for a live conversation as well as a completed one:
  • The grey “Connecting you to a live agent for further assistance…” notice, and “Connected to a live agent.” when they pick it up.
  • The human agent’s replies, labelled Live Agent rather than credited to the AI.
  • “The agent has closed this conversation.” when they close it.
The actions your agent ran in the conversation are hidden until you switch on Action Logs. Use the switch in the Email Thread heading to show them between the messages, for live and completed threads alike.

Supervisor controls

Email History is also where a supervisor can step into a conversation that is still running, by handing it to a person or by closing it.
1
Switch on In-progress Only so the list shows only live conversations, or Escalated Only for conversations already with a person.
2
Each live row’s action cell now carries a View button plus a chevron menu. Open the menu to reach Escalate and Resolve. The same two controls appear as an Actions dropdown in the Email Thread heading inside the drawer, next to the Action Logs switch, when the conversation you have open is in progress.
3
Pick the one you want. A spinner appears while the request is in flight, then the row leaves the list and the drawer closes. The confirmation means the request was accepted; a conversation you escalated moves to the Escalated Only list shortly afterwards, once the handover has finished.
If the request does not go through you will see Failed to resolve email session or Failed to escalate email session instead, and the conversation is left as it was.
Only a conversation that is still open can be escalated or resolved this way. Once a conversation has completed — the agent resolved it, the human closed it, or it was abandoned — Escalate and Resolve no longer apply, and the row offers View only.
An escalated conversation is still open, and still yours to close: its row and its drawer offer View and Resolve, but not Escalate, since it is already with a person. Resolve closes it.
Both controls are safe to click twice. A second click on the same conversation does not escalate or resolve it again, so a double-click or an impatient retry cannot produce a duplicate handoff.

Behaviour worth knowing

  • The in-progress list shows only conversations that are still live. A conversation that ended in an error isn’t listed.
  • Escalate hands the thread over the same way the agent does when a customer asks for a person: the customer receives your Handoff Message, the agent’s post-conversation actions run, the AI stops replying, and the human’s replies on the Freshdesk ticket are recorded on the transcript. The conversation stays open until it is resolved. See The conversation stays open for what happens if nobody replies on the ticket. It is recorded under the Escalated outcome rather than one of your own outcome options. Use Escalate when a person needs to take the thread over, and Resolve when the conversation is finished and simply needs closing out.
  • In rare cases, such as when the handover can’t be set up, an escalation completes straight away instead of staying open.

Where to go next

Email Agents

Connect a Freshdesk mailbox and configure how your agent replies, resolves and escalates.

Chat Analytics

View the equivalent analytics dashboard for your chat channel.