Go to Rilla

Get a transcript

Read a conversation’s transcript as speaker turns.

GET/export/conversations/{conversationId}/transcript
Authentication
Authorization: YOUR_API_KEY

No Bearer prefix.

Base URL: https://customer.rillavoice.com

Parameters

conversationIdstring · uuid · pathrequired

The Rilla conversation ID, not the recording ID or the CRM event ID.

pageinteger · query

Page to return, from 1. Needs limit; without it, the whole transcript comes back on one page.

limitinteger · query

Turns per page, up to 10,000. Omit it to get the whole transcript at once.

Without limit, the whole transcript comes back on one page. A long call can run to thousands of turns, so page through it with limit.

Responses

conversationIdstring

ID of the conversation.

turnsTranscriptTurn[]

Turns in the order they were spoken.

currentPagenumber

The page returned.

totalPagesnumber

Pages available; request the next page to get more.

totalTurnsnumber

Turns in the whole transcript.

401Missing or invalid API key.
400Invalid request parameters.
404Record not found or outside your key’s scope.
Error reference

Common problems

400 · "Request body failed validation"

The message is the same for invalid query and path parameters. Read errors[].path and errors[].message. Send every parameter in the query string, URL-encoded; these GET requests take no body. page needs limit; each is a positive integer up to 10,000.

401 · Missing or invalid key

Use Authorization: YOUR_API_KEY, without Bearer, and the customer.rillavoice.com host. Use the key value, not its ID.

404 · Conversation not found

Use the conversation ID, not recordingId or crmEventID. Check that the conversation belongs to the organization and scope of your API key.