Skip to main content
POST
Phone calls
RingCentral and Dialpad connect by OAuth. List connections first and choose the connection_id by system and account_label. 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.
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 for read charges.