Group by | Sarvam API Docs

Group by is a tab under Monitor → Agent Analytics. It lets you slice the same connectivity metrics by a chosen dimension: campaign, agent, language, bot number, or an agent variable. Use it when the Overview looks healthy in aggregate but you need to identify which campaign, number, or language is dragging the numbers down.

Group by tab showing a table grouped by campaign, with attempts, connected, connectivity rate, unique recipients, unique connects, average duration, average turns, bot latency, average retry attempts per connect, and goal achieved columns. — Group by tab

When to use Group by

Group by is most useful when:

One campaign looks healthy in Overview but you suspect another is failing.
You want connectivity by bot number without relying on the Connectivity tab’s phone-health table alone.
You are comparing languages or agents side by side.
You need a rollup by a custom agent variable, which requires a single-agent selection.

Choose a dimension

The dimension you select determines what a single row represents:

Dimension	What each row is
Campaign	One campaign (includes an Agent column when the campaign maps to an agent)
Agent	One agent
Language	One language
Bot number	One outbound bot number
Agent variable	One value of a selected agent variable, available only when exactly one agent is selected in the toolbar

The default dimension is Campaign. Changing the dimension resets the table to page 1.

Agent variable stays disabled until a single agent is selected. If you switch back to All Agents while that dimension is active, the tab falls back to Campaign.

Columns

Every row shares the same metric columns:

Column	Meaning
[Dimension]	Campaign name, agent name, language, bot number, or variable value
Agent	Shown when grouping by campaign
Attempts	Total dial attempts
Connected	Connected calls
Connectivity Rate	Connected ÷ attempts
Unique Recipients	Distinct end users contacted
Unique Connects	Distinct users who connected
Avg Duration	Average connected-call duration
Avg Turns	Average conversation turns
Bot Latency	Average agent response latency
Avg Retry Attempts per Connect	Average retries needed per successful connect

The default sort is Attempts descending. Click a column header to re-sort. The table is paginated.

How to use Group by

Pick a dimension

Start with Campaign or Bot number for outbound health. Use Language when engagement or connect quality differs by locale.

Sort on the metric that moved

If connectivity fell, sort by Connectivity Rate. If volume concentrated somewhere unexpected, sort by Attempts.

Confirm with Call Logs

Open Call Logs with the same filters and sample rows from the underperforming group before you change the agent or campaign.

Connectivity

Break down failure reasons and phone-number health.

Engagement

Explore the funnel and conversation depth.

Call Logs

Inspect the calls behind an underperforming group.