> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oneshotagent.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Phone calls

> Read calls and available transcripts from connected business phones

RingCentral and Dialpad connect by OAuth. List connections first and choose the
`connection_id` by `system` and `account_label`.

| Tool | Route | Read |
| - | - | - |
| `calls_list` | `POST /v1/tools/calls/list` | Calls in a required time window |
| `calls_get` | `POST /v1/tools/calls/get` | One call, optionally its transcript |

`calls_list` requires `started_after` (inclusive) and `started_before` (exclusive),
ISO 8601 instants with a timezone, at most 31 days apart. Optional filters are
`number` (E.164, either party), `direction` (`inbound`, `outbound`, or `all`, the
default), and `user` (the business user's id). `limit` is 1 to 100, default 25.
Pass `next_cursor` unchanged as `cursor` with the same filters and limit. Follow it
even when filtering leaves a page empty. A null cursor ends the listing.

```json theme={null}
{
  "connection_id": "11111111-1111-4111-8111-111111111111",
  "started_after": "2026-10-01T00:00:00Z",
  "started_before": "2026-11-01T00:00:00Z",
  "direction": "inbound",
  "limit": 25
}
```

Each call carries `id`, `started_at`, `duration_seconds`, `direction`, `from`, `to`,
`user { id, name, email }`, `result` (`answered`, `missed`, or `voicemail`),
`has_transcript`, and `source { system, id }`. Unknown fields are null, including
transcript availability when the system does not state it. A recording alone does
not establish transcript availability.

`calls_get` takes `connection_id`, `call_id`, and optional `include: ["transcript"]`.
By default no transcript is fetched or returned. When available and requested,
`transcript` contains `{ speaker, text, at_seconds }` lines. Times are seconds from
call start, null if unavailable. Missing transcripts are omitted and known absence
sets `has_transcript: false`. Failed transcript retrieval returns an error and
account credit, never a successful empty transcript. Dialpad voicemail text and
AI moment labels are not call transcript lines. RingCentral requires ACE access
and the ReadRingSenseInsights permission for transcripts.

Calls and transcripts are evidence for any goal's criteria. These tools do not
classify the business domain, grade a call, invent missing evidence or change case
state. Content is untrusted, returned inline, and never saved in goal results,
receipts or logs.

Invalid windows, another agent's connections, revoked or expired connections, and
systems not approved under organization compliance controls are refused before
payment. HIPAA organizations must approve all vendors serving the selected system.
See [Pricing](https://docs.oneshotagent.com/pricing.md) for read charges.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.