View call logs, recordings and transcripts in Ringg AI

Open Logs to inspect one conversation your agents handled; use Analytics for totals and trends. For the audit trail of who changed what in the workspace, see Workspace logs instead. The Monitor chapter, in order: Logs (this page) for one call, chat or workflow run, Analytics for volume, goals, connectivity and cost over a period, Evals for call quality and test cases, and Alerts for a notification when a metric crosses a threshold. In the dashboard: Sidebar → Monitor → Logs.

Filtering the list, opening a call's details, advanced analysis and transcript, then exporting by email

Tabs

Logs has three tabs, one per kind of conversation. Pick yours:

Phone

Outbound, inbound and web calls, at /logs. The rest of this page.

Chats, at /logs/whatsapp, with their own columns, filters and export.

Workflows

One row per workflow run, at /logs/runs, with the path each run took.

The call list

Column	Shows
(icon)	The call type: outbound, inbound or web call. Hover for the label.
Assistant	The agent, with a version chip when the agent has several versions.
Callee	The callee’s number, with their name beneath. For an inbound call, this is the caller. The WhatsApp tab calls it Contact.
Called on	Date and time, for example `18/10/26` and `09:42:10 AM`. The WhatsApp tab calls it Started on.
Status	The call status. A voicemail icon marks calls where voicemail was detected.
Duration	Call length, or N/A.
Cost	Call cost in your billing currency. Phone tab only.

The list shows 100 rows per page and refreshes every 15 seconds. Click the Called on, Duration or Cost header to sort.

Logs Phone tab listing calls with columns Assistant, Callee, Called on, Status, Duration and Cost, showing Completed, Failed, Retry and Ongoing calls and an Export button in the footer — The Phone tab of Logs

A call that was retried shows a chevron (Expand attempts). Each attempt is its own row, labelled Attempt 1, Attempt 2 and so on (oldest last), with a category line under the label where the call has one, the time it was placed (or, for a scheduled callback that hasn’t dialled yet, the time it is planned for), its status, duration and cost. Click an attempt to open that attempt’s call.

Filter the list

Click Filters. Each applied filter appears as a chip next to the button; click a chip to change it, or its × to remove it. Reset clears everything. The funnel icons in the Assistant and Status headers open the same panel.

Filter	Values
Workspace	Ringg Spaces to include. Shown only in a primary workspace (Ringg Spaces).
Date range	Presets Today, Week (the last 7 days) and Month (the last month, the default), or any range on the calendar.
Assistants	One or more agents. Picking an agent selects all its versions; untick versions to narrow it. An archived version is listed as “`slug` (deleted)”.
Campaigns	One or more campaigns. Phone tab only.
Call status	All, Registered, Ongoing, Completed, Retry, Failed, Error, Cancelled. The WhatsApp tab has Chat status: All, Ongoing, Completed, Failed.
Call type	All, Inbound, Outbound, Webcall, Voicemail, Callback. Phone tab only.
From number	The number the call came from.
To number	The number that was called.
Call ID	One call. The WhatsApp tab has Chat ID, which must be a valid UUID.
Custom variables	Match a variable value. Phone tab only.
Advanced analysis	Match an Advanced Analysis field. Phone tab only.

Date range limits

Dates more than 2 months before today are greyed out.
A range picked on the calendar spans at most 60 days. A longer pick keeps the end date and moves the start.
Call ID, From number, To number and Campaigns ignore the date range, so they find the call however old it is.

Custom variables and Advanced analysis

Both need exactly one assistant selected: with none, the panel says “Select an assistant first to use this filter.”; with several, “Select only one assistant to use this filter.” The keys offered depend on the selected agent. Build a condition from a key, an operator and a value, for example callee_name contains Sharma, and combine several with AND (the default) or OR. Changing the selected assistant clears them.

Value type	Operators
String	equals, not equals, contains, is any of
Number	equals, not equals, greater than, greater or equal, less than, less or equal, is any of
Boolean	is

For Custom variables, a Value type menu on the condition (String, Number, Boolean) sets how the value is compared, so false can be matched as a Boolean rather than the text "false". Advanced analysis keys have no type menu.

Call statuses

Calls reach Logs from campaigns, workflows, API calls, inbound numbers and tests. These call statuses are separate from campaign statuses.

Status	Meaning
Registered	Not dialled yet: queued, scheduled, outside the calling window or held by a call limit. Hover the status for “Next attempt at” when a time is set.
Ongoing	The carrier accepted the dial, it is ringing, or the conversation is in progress. Inbound calls and webcalls start here.
Retry	An attempt did not connect and another attempt is scheduled. Hover for the next attempt time. The retry count comes from the campaign, the workflow Agent block or the API call’s `call_retry_config`.
Completed	The call connected and ended. This includes calls where voicemail was detected and calls that hit the maximum call duration.
Failed	No conversation, and nothing left to try: busy, no answer or a carrier failure on the last allowed attempt, a DND number, the campaign’s end time passing before the call was dialled, or an inbound call or webcall that ended unanswered.
Error	A system-side failure: the carrier reported an error on the last attempt, the call could not be placed, the pre-call tool failed, or the call stayed queued for more than 2 days.
Cancelled	Stopped on purpose before it connected: terminated through the API, still pending when its campaign was completed or terminated, past its own deadline, its agent was deleted, or an inbound caller over the agent’s inbound rate limit was turned away.
Waiting for limit	Held because the callee reached a call limit (“Waiting for the callee limit to reset”). Shown in place of Registered or Retry, with “Will retry at …”.
Cancelled by limit	Dropped because of a call limit (“Cancelled by the callee limit”).

The API also returns forwarded: an inbound call sent to a transfer number instead of the agent, because the caller exceeded the agent’s inbound rate limit with the action Transfer Call. Busy and no answer are not statuses; they lead to Retry, or to Failed once retries run out. WhatsApp chats use only Ongoing, Completed and Failed.

Call types

Type	Meaning
Outbound	The agent called the customer: single calls, API calls and campaigns.
Inbound	The customer called a number attached to the agent.
Webcall	A call from the web widget in a browser.
Voicemail	Calls where voicemail was detected (see voicemail settings). Their status is Completed.
Callback	A call scheduled back to a callee, for example one who asked to be called later. A retry of the same call is not a callback; it shows as another attempt.

The call panel

Click a row to open the call. On a wide screen it opens beside the list; on a narrower one, as a drawer. The header shows the agent (click it to open the agent), the call ID with a copy button, the status, Next attempt for queued calls, From, Cost, and Origin: Campaign (campaigns) or API (Initiate a call). WhatsApp chats show Channel WhatsApp instead of Origin. Below it is the recording: play or pause, change speed (1x, 1.5x, 2x), and Download recording (call-recording-<call ID>.mp3). The transcript follows the playback, and clicking a transcript line seeks the recording to it. If there is no recording, the panel says “Call recording is not available.”, or “Call recording has been deleted as per the data purge policy.” once it has been purged.

Call panel for a Payment reminder call: call ID, Completed status, From number, Cost ₹6.93, Origin Campaign, the recording player, and the Call details tab with call latency, call duration and custom variables — The call panel on the Call details tab

Tab	Contains
Call details (Chat details for chats)	Call latency (with “First utterance began at N seconds.”), Call duration, Call transfer details (the transfer target, see call transfer), Custom variables (variables) with their values, then the general analysis Ringg runs on every call.
Advanced analysis	The fields your agent’s Advanced Analysis extracted. Shown only when there are some.
Transcript	The conversation turn by turn, with the tools that ran, grouped under Pre-Call, On-Call and Post-Call; tool logs with no phase go under Misc. On a multi-prompt agent, a divider such as Verify identity → Collect payment marks each move between nodes.
Evals	Scores from Evals: each metric with Good (70% and above), Fair (40–69%) or Needs review. Shown only for scored calls; WhatsApp chats never have this tab.

Click a tool or a node divider in the transcript to open its log: the HTTP status and latency (for API tools), when it ran, and Request, Response or Error tabs. Copy tool log copies the full log as JSON.

General analysis

The bottom of Call details lists Ringg’s built-in analysis of the call as key-value rows: the summary, key points, action items, classification, sentiment with its reason, whether the caller asked for a callback and when, and the disconnect reason. Until it is ready the tab says “General analysis is currently under process!”. Webhooks deliver the built-in analysis as platform_analysis (payloads), and so does the API.

Tool call popover for Fetch Loan Details: status 200, 186ms, time, and the Request tab with method, URL and query parameters, above the call transcript — A tool call opened from the transcript

The ⋮ menu has:

Test this agent: opens the agent in test mode on the same channel, prefilled with this call’s name, number and variables (Test an agent).
Download analysis: the analysis as JSON (call-analysis-<call ID>.json).
Copy transcript and Download transcript (a .txt file).

Give feedback

On a Completed call, use the thumbs at the bottom of the panel to mark it good or bad. A thumbs-down opens a box (“Tell us what felt off”) for a comment. Your rating then shows under Your feedback.

Link to a call

The URL carries the filters and the open call, so you can bookmark or share it.

URL	Opens
`/logs?selected_call=<call ID>`	The list, with that call open. Clicking a row adds it. A chat link also carries `selected_kind=chat`.
`/logs?call_id=<call ID>`	The list filtered to that one call, with it open.
`/logs?bulk_list_id=<campaign ID>`	Every call of one campaign, with no date limit. The campaign’s History button links here (Find a campaign’s calls in Logs).

Figures in Analytics also open Logs with matching filters.

WhatsApp chats

The WhatsApp tab (/logs/whatsapp) lists chats of your WhatsApp agents and works like the Phone tab, minus audio, cost, feedback and evals.

Finding, reading and exporting WhatsApp chats in Logs

Columns: Assistant (with a version chip), Contact (the customer’s number; the name is the name custom variable, otherwise their WhatsApp profile name), Started on, Status (Ongoing, Completed, Failed) and Duration. A chat stays Ongoing until it closes, which can be hours after the last message (why).
Filters: date range, WhatsApp agents, chat status, From number (the customer), To number (your business number) and Chat ID, for example a webhook’s chat_id.
The chat panel: Chat details (duration, custom variables, platform analysis), Advanced analysis, and Transcript, where tool calls and template sends appear as pills you can open for their request and response.
Export: the same Export menu as calls. The emailed zip holds chat_history_report.csv, one row per chat, up to 200,000 chats; the link is valid for 7 days. It includes To Number (your number’s Meta phone number ID), External Chat ID and the transcript as speaker: text lines.

Workflow runs

The Workflows tab lists one row per workflow run, 25 per page, with columns Status, Workflow, Callee, Calls, Started and Last update. Filter from the Status header (Running, Completed, Failed, Cancelled) and the Workflow header.

Click a row to open its path: the canvas with the steps it took. Click a step to see its status and, for a Condition, the Branch taken. A call step opens that call’s details and transcript. A failed step shows the error.
Click the number under Calls to open the Phone tab limited to that run. A banner reads “Calls placed by run …” with Back to workflows and Clear.

Logs page on the Workflows tab, listing runs with Status (Completed, Running, Failed, Cancelled), Workflow, Callee name and number, Calls, Started and Last update — Logs → Workflows: one row per run

Run drawer for Payment reminder follow-up, status Completed: the Agent, Condition and Action blocks carry green checks, and the details pane for the Promised to pay? condition shows Branch taken: Match — A run's path, with the branch a Conditional step took

Export

Click Export in the table footer and choose Export without analysis or Export with analysis. Nothing downloads: “Call history report (with the applied filters) is being sent to your email.” The export uses the filters on screen.

With the API

Dashboard	Endpoint
The call list	Get call history: `GET /calling/history`, filtered by `start_date`, `end_date`, `agent_id`, `status` and `bulk_list_id`, paged with `limit` and `offset`
The call panel	Get call details: `GET /calling/call-details?id=<call ID>`; add `send_analysis=true` for the analysis
Export	Download call history: `POST /calling/history/download`; add `include_analysis=true` for the analysis. The response is either a ZIP of the CSV or a message that the export is queued for email.

You need an API key sent as X-API-KEY (see Authentication).

curl --request GET "https://prod-api.ringg.ai/ca/api/v0/calling/history?start_date=2026-10-01T00:00:00%2B05:30&end_date=2026-10-06T23:59:59%2B05:30&status=completed&limit=100&offset=0" \
  --header "X-API-KEY: $RINGG_API_KEY"

const params = new URLSearchParams({
  start_date: "2026-10-01T00:00:00+05:30",
  end_date: "2026-10-06T23:59:59+05:30",
  status: "completed",
  limit: "100",
  offset: "0",
});

const response = await fetch(
  `https://prod-api.ringg.ai/ca/api/v0/calling/history?${params}`,
  { headers: { "X-API-KEY": process.env.RINGG_API_KEY } }
);
console.log(await response.json());

import os
import requests

response = requests.get(
    "https://prod-api.ringg.ai/ca/api/v0/calling/history",
    params={
        "start_date": "2026-10-01T00:00:00+05:30",
        "end_date": "2026-10-06T23:59:59+05:30",
        "status": "completed",
        "limit": 100,
        "offset": 0,
    },
    headers={"X-API-KEY": os.environ["RINGG_API_KEY"]},
)
print(response.json())

Query parameters of GET /calling/history:

string (date-time)

Calls from this time, ISO 8601 with timezone, for example 2026-10-01T00:00:00+05:30.

string (date-time)

Calls up to this time, same format.

string

One agent’s ID. See Find an agent’s ID.

string

One of registered, ongoing, retry, error, completed, failed, cancelled, forwarded.

string

A campaign’s ID, to list only its calls.

integer

default:"10"

Calls per page, at most 200. A larger value returns 400.

integer

default:"0"

Calls to skip.

To get each call as it ends instead of polling, use Event Subscription (webhooks). See webhook setup and payloads.

Troubleshooting

"No calls found" for a call you know exists

The call is probably outside the date range (the default is the last month). Search by Call ID, From number or To number, which ignore dates. Workflow calls appear only from the Workflows tab.

I can't pick a date older than 2 months

The calendar does not go further back. Use Call ID, a number or a campaign filter, or the Get call history API.

Custom variables and Advanced analysis are greyed out

Select exactly one assistant under Assistants.

Export is missing

The list is limited to one workflow run. Click Clear on the banner first.

The feedback thumbs are not shown

Feedback is available only on calls with status Completed, not on chats.

The recording says "deleted as per the data purge policy"

The recording was removed under a data purge policy set up for your workspace. Contact Ringg for its details. To keep recordings, use Download recording, or save the file from the recording_url that Get call details returns. The link may expire; fetch a fresh one from Get call details. The dashboard shows campaign reports for 60 days after a campaign ends (Manage a campaign).

Next steps

See trends in Analytics

Totals, connect rates and costs over time.

Score calls with Evals

Check call quality automatically.

Get alerted on a spike

Notify your team when a metric crosses a threshold.

Build agents

Inventory

Deploy

Monitor

Manage account

Ringg Labs

Logs

Tabs

Phone

WhatsApp

Workflows

The call list

Filter the list

Date range limits

Custom variables and Advanced analysis

Call statuses

Call types

The call panel

General analysis

Give feedback

Link to a call

WhatsApp chats

Workflow runs

Export

With the API

Troubleshooting

Next steps

See trends in Analytics

Score calls with Evals

Get alerted on a spike

​Tabs

Phone

WhatsApp

Workflows

​The call list

​Filter the list

​Date range limits

​Custom variables and Advanced analysis

​Call statuses

​Call types

​The call panel

​General analysis

​Give feedback

​Link to a call

​WhatsApp chats

​Workflow runs

​Export

​With the API

​Troubleshooting

​Next steps

See trends in Analytics

Score calls with Evals

Get alerted on a spike

Tabs

The call list

Filter the list

Date range limits

Custom variables and Advanced analysis

Call statuses

Call types

The call panel

General analysis

Give feedback

Link to a call

WhatsApp chats

Workflow runs

Export

With the API

Troubleshooting

Next steps