Skip to contentSkip to navigationSkip to topbar
Twilio Docs
Rate this page:
On this page

Transcript Sentence Resource

(information)

Info

Public Beta

Voice Intelligence is currently available as a public beta release. Some features are not yet implemented and others may be changed before the product is declared as Generally Available. Beta products are not covered by a Twilio SLA.

Learn more about beta product support(link takes you to an external page).

A Transcript Sentence is the actual text of the recording transcription.

The GET Sentences request returns a list of Sentences of a Transcript. With the Redacted query param, the endpoint returns the PII redacted/unredacted Sentences.

Sentence Properties

sentence-properties page anchor
Resource properties
media_channeltype: integer
Not PII

The channel number.

sentence_indextype: integer
Not PII

The index of the sentence in the transcript.

start_timetype: number
Not PII

Offset from the beginning of the transcript when this sentence starts.

end_timetype: number
Not PII

Offset from the beginning of the transcript when this sentence ends.

transcripttype: string
PII MTL: 30 days

Transcript text.

sidtype: SID<GX>
Not PII

A 34 character string that uniquely identifies this Sentence.

Pattern:
^GX[0-9a-fA-F]{32}$
Min length:
34
Max length:
34
confidencetype: number
Not PII

Get Transcript Sentences

get-transcript-sentences page anchor
GET https://intelligence.twilio.com/v2/Transcripts/{TranscriptSid}/Sentences

Parameters

list-parameters page anchor
URI parameters
TranscriptSidtype: SID<GT>
Path ParameterNot PII

The unique SID identifier of the Transcript.

Pattern:
^GT[0-9a-fA-F]{32}$
Min length:
34
Max length:
34
Redactedtype: boolean
Query ParameterNot PII

Grant access to PII Redacted/Unredacted Sentences. If redaction is enabled, the default is true to access redacted sentences.

PageSizetype: integer
Query ParameterNot PII

How many resources to return in each list page. The default is 50, and the maximum is 1000.

Minimum:
1
Pagetype: integer
Query ParameterNot PII

The page index. This value is simply for client state.

Minimum:
0
PageTokentype: string
Query ParameterNot PII

The page token. This is provided by the API.

List multiple Sentences

list-multiple-sentences page anchor
Node.js
Python
C#
Java
Go
PHP
Ruby
twilio-cli
curl

_11
// Download the helper library from https://www.twilio.com/docs/node/install
_11
// Find your Account SID and Auth Token at twilio.com/console
_11
// and set the environment variables. See http://twil.io/secure
_11
const accountSid = process.env.TWILIO_ACCOUNT_SID;
_11
const authToken = process.env.TWILIO_AUTH_TOKEN;
_11
const client = require('twilio')(accountSid, authToken);
_11
_11
client.intelligence.v2.transcripts('GTXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX')
_11
.sentences
_11
.list({limit: 20})
_11
.then(sentences => sentences.forEach(s => console.log(s.sid)));

Output

_22
{
_22
"sentences": [
_22
{
_22
"media_channel": 1,
_22
"sentence_index": 0,
_22
"start_time": null,
_22
"end_time": null,
_22
"transcript": "test test",
_22
"sid": "GXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
_22
"confidence": null
_22
}
_22
],
_22
"meta": {
_22
"key": "sentences",
_22
"page": 0,
_22
"page_size": 50,
_22
"first_page_url": "https://intelligence.twilio.com/v2/Transcripts/GTXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Sentences?PageSize=50&Page=0",
_22
"url": "https://intelligence.twilio.com/v2/Transcripts/GTXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Sentences?PageSize=50&Page=0",
_22
"next_page_url": "https://intelligence.twilio.com/v2/Transcripts/GTXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Sentences?PageSize=50&Page=1",
_22
"previous_page_url": "https://intelligence.twilio.com/v2/Transcripts/GTXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Sentences?PageSize=50&Page=0"
_22
}
_22
}

Rate this page: