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

Service 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 Service provides control and configuration for how Transcripts are processed. Any Transcript created belongs to a particular Service and inherits its configuration.

The Service-level configuration includes features like data logging, auto-transcribe, and auto-redaction. Language Operator deployments to a Service are handled through the Twilio Console.


Service configuration

service-configuration page anchor

Automatically analyze all Twilio call recordings in your account

automatically-analyze-all-twilio-call-recordings-in-your-account page anchor

Enable auto_transcribe if you want to automatically transcribe all Twilio call recordings that are recorded in an account. Auto-transcribe can help you transcribe call recordings without the need of calling the create Transcript Resource. You can enable auto-transcribe through the Service Resource or on the Console, under Service settings.

If you enable auto_transcribe in more than one Service, the call recording will be sent and transcribed more than once, and charged accordingly.

With Voice Intelligence, you can redact Personal Identifiable Information (PII) from your call recording and transcript.

Update your Service with auto_redaction = true to automatically redact PII from all transcripts made on this Service. If you also want to automatically redact PII from all transcripts media sent to the Service, set media_redaction = true.

(warning)

Warning

If you change the PII redaction or auto-transcribe setting on a Service, it can take up to 10 minutes to come into effect.

The LanguageCode set during Service creation determines the Transcription language for all call recordings processed by that Service. Refer to Supported Languages for a list of available language codes. The default is en-US if no LanguageCode is set.

(information)

Info

A Service can only support one LanguageCode, and it cannot be updated once it's set. To transcribe call recordings in multiple languages, create a separate Service for each language.


Resource properties
account_sidtype: SID<AC>
Not PII

The unique SID identifier of the Account the Service belongs to.

Pattern:
^AC[0-9a-fA-F]{32}$
Min length:
34
Max length:
34

auto_redactiontype: boolean

Instructs the Speech Recognition service to automatically redact PII from all transcripts made on this service.


media_redactiontype: boolean

Instructs the Speech Recognition service to automatically redact PII from all transcripts media made on this service. The auto_redaction flag must be enabled, results in error otherwise.


auto_transcribetype: boolean

Instructs the Speech Recognition service to automatically transcribe all recordings made on the account.


data_loggingtype: boolean

Data logging allows Twilio to improve the quality of the speech recognition & language understanding services through using customer data to refine, fine tune and evaluate machine learning models. Note: Data logging cannot be activated via API, only via www.twilio.com, as it requires additional consent.


date_createdtype: string<date-time>

The date that this Service was created, given in ISO 8601 format.


date_updatedtype: string<date-time>

The date that this Service was updated, given in ISO 8601 format.


friendly_nametype: string

A human readable description of this resource, up to 64 characters.


language_codetype: string

The default language code of the audio.


sidtype: string

A 34 character string that uniquely identifies this Service.


unique_nametype: string

Provides a unique and addressable name to be assigned to this Service, assigned by the developer, to be optionally used in addition to SID.


urltype: string<uri>

The URL of this resource.


webhook_urltype: string

The URL Twilio will request when executing the Webhook.


webhook_http_methodtype: enum<string>

The HTTP method for the Webhook. One of GET or POST.

Possible values:
GETPOSTNULL

versiontype: integer

The version number of this Service.


POST https://intelligence.twilio.com/v2/Services

Parameters

create-parameters page anchor
Request body parameters
UniqueNametype: stringRequired

Provides a unique and addressable name to be assigned to this Service, assigned by the developer, to be optionally used in addition to SID.


AutoTranscribetype: boolean

Instructs the Speech Recognition service to automatically transcribe all recordings made on the account.


DataLoggingtype: boolean

Data logging allows Twilio to improve the quality of the speech recognition & language understanding services through using customer data to refine, fine tune and evaluate machine learning models. Note: Data logging cannot be activated via API, only via www.twilio.com, as it requires additional consent.


FriendlyNametype: string

A human readable description of this resource, up to 64 characters.


LanguageCodetype: string

The default language code of the audio.


AutoRedactiontype: boolean

Instructs the Speech Recognition service to automatically redact PII from all transcripts made on this service.


MediaRedactiontype: boolean

Instructs the Speech Recognition service to automatically redact PII from all transcripts media made on this service. The auto_redaction flag must be enabled, results in error otherwise.


WebhookUrltype: string

The URL Twilio will request when executing the Webhook.


WebhookHttpMethodtype: enum<string>

The HTTP method for the Webhook. One of GET or POST.

Possible values:
GETPOSTNULL
Node.js
Python
C#
Java
Go
PHP
Ruby
twilio-cli
curl

_10
// Download the helper library from https://www.twilio.com/docs/node/install
_10
// Find your Account SID and Auth Token at twilio.com/console
_10
// and set the environment variables. See http://twil.io/secure
_10
const accountSid = process.env.TWILIO_ACCOUNT_SID;
_10
const authToken = process.env.TWILIO_AUTH_TOKEN;
_10
const client = require('twilio')(accountSid, authToken);
_10
_10
client.intelligence.v2.services
_10
.create({uniqueName: 'unique_name'})
_10
.then(service => console.log(service.sid));

Output

_18
{
_18
"sid": "GAXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
_18
"unique_name": "something",
_18
"friendly_name": "some friendly name",
_18
"date_created": "2010-08-31T20:36:28Z",
_18
"date_updated": "2010-08-31T20:36:28Z",
_18
"account_sid": "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
_18
"auto_redaction": false,
_18
"media_redaction": false,
_18
"auto_transcribe": true,
_18
"data_logging": true,
_18
"language_code": "en-US",
_18
"webhook_url": "https://www.twilio.com",
_18
"webhook_http_method": "POST",
_18
"read_only_attached_operator_sids": "['LYXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX']",
_18
"version": 1,
_18
"url": "https://intelligence.twilio.com/v2/Services/GAXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
_18
}


GET https://intelligence.twilio.com/v2/Services/{Sid}

URI parameters
Sidtype: string
Path ParameterNot PII

A 34 character string that uniquely identifies this Service.

Node.js
Python
C#
Java
Go
PHP
Ruby
twilio-cli
curl

_10
// Download the helper library from https://www.twilio.com/docs/node/install
_10
// Find your Account SID and Auth Token at twilio.com/console
_10
// and set the environment variables. See http://twil.io/secure
_10
const accountSid = process.env.TWILIO_ACCOUNT_SID;
_10
const authToken = process.env.TWILIO_AUTH_TOKEN;
_10
const client = require('twilio')(accountSid, authToken);
_10
_10
client.intelligence.v2.services('GAXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX')
_10
.fetch()
_10
.then(service => console.log(service.friendlyName));

Output

_18
{
_18
"sid": "GAXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
_18
"unique_name": "something",
_18
"friendly_name": "some friendly name",
_18
"date_created": "2010-08-31T20:36:28Z",
_18
"date_updated": "2010-08-31T20:36:28Z",
_18
"account_sid": "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
_18
"auto_redaction": false,
_18
"media_redaction": false,
_18
"auto_transcribe": true,
_18
"data_logging": true,
_18
"language_code": "en-US",
_18
"webhook_url": "https://www.twilio.com",
_18
"webhook_http_method": "POST",
_18
"read_only_attached_operator_sids": "['LYXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX']",
_18
"version": 1,
_18
"url": "https://intelligence.twilio.com/v2/Services/GAXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
_18
}


GET https://intelligence.twilio.com/v2/Services

URI parameters
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.

Node.js
Python
C#
Java
Go
PHP
Ruby
twilio-cli
curl

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

Output

_33
{
_33
"services": [
_33
{
_33
"sid": "GAXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
_33
"unique_name": "something",
_33
"friendly_name": "some friendly name",
_33
"date_created": "2010-08-31T20:36:28Z",
_33
"date_updated": "2010-08-31T20:36:28Z",
_33
"account_sid": "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
_33
"auto_redaction": false,
_33
"media_redaction": false,
_33
"auto_transcribe": true,
_33
"data_logging": true,
_33
"language_code": "en-US",
_33
"webhook_url": "https://www.twilio.com",
_33
"webhook_http_method": "POST",
_33
"read_only_attached_operator_sids": [
_33
"LYXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
_33
],
_33
"version": 1,
_33
"url": "https://intelligence.twilio.com/v2/Services/GAXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
_33
}
_33
],
_33
"meta": {
_33
"key": "services",
_33
"page": 0,
_33
"page_size": 50,
_33
"first_page_url": "https://intelligence.twilio.com/v2/Services?PageSize=50&Page=0",
_33
"next_page_url": "https://intelligence.twilio.com/v2/Services?PageSize=50&Page=1",
_33
"previous_page_url": "https://intelligence.twilio.com/v2/Services?PageSize=50&Page=0",
_33
"url": "https://intelligence.twilio.com/v2/Services?PageSize=50&Page=0"
_33
}
_33
}


POST https://intelligence.twilio.com/v2/Services/{Sid}

(information)

Info

It can take up to 5 minutes to propagate any changes to a Service.

Transcripts generated just after updating parameters like AutoTranscribe, AutoRedaction or MediaRedaction may be generated with the old configuration. After 5 minutes, the newly-created Transcripts will have the new configuration.

Request headers
If-Matchtype: string

The If-Match HTTP request header


URI parameters
Sidtype: string
Path ParameterNot PII

A 34 character string that uniquely identifies this Service.


Request body parameters
AutoTranscribetype: boolean

Instructs the Speech Recognition service to automatically transcribe all recordings made on the account.


DataLoggingtype: boolean

Data logging allows Twilio to improve the quality of the speech recognition & language understanding services through using customer data to refine, fine tune and evaluate machine learning models. Note: Data logging cannot be activated via API, only via www.twilio.com, as it requires additional consent.


FriendlyNametype: string

A human readable description of this resource, up to 64 characters.


LanguageCodetype: string

The default language code of the audio.


UniqueNametype: string

Provides a unique and addressable name to be assigned to this Service, assigned by the developer, to be optionally used in addition to SID.


AutoRedactiontype: boolean

Instructs the Speech Recognition service to automatically redact PII from all transcripts made on this service.


MediaRedactiontype: boolean

Instructs the Speech Recognition service to automatically redact PII from all transcripts media made on this service. The auto_redaction flag must be enabled, results in error otherwise.


WebhookUrltype: string

The URL Twilio will request when executing the Webhook.


WebhookHttpMethodtype: enum<string>

The HTTP method for the Webhook. One of GET or POST.

Possible values:
GETPOSTNULL
Node.js
Python
C#
Java
Go
PHP
Ruby
twilio-cli
curl

_10
// Download the helper library from https://www.twilio.com/docs/node/install
_10
// Find your Account SID and Auth Token at twilio.com/console
_10
// and set the environment variables. See http://twil.io/secure
_10
const accountSid = process.env.TWILIO_ACCOUNT_SID;
_10
const authToken = process.env.TWILIO_AUTH_TOKEN;
_10
const client = require('twilio')(accountSid, authToken);
_10
_10
client.intelligence.v2.services('GAXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX')
_10
.update({autoTranscribe: true})
_10
.then(service => console.log(service.friendlyName));

Output

_18
{
_18
"sid": "GAXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
_18
"unique_name": "something",
_18
"friendly_name": "some friendly name",
_18
"date_created": "2010-08-31T20:36:28Z",
_18
"date_updated": "2010-08-31T20:36:28Z",
_18
"account_sid": "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
_18
"auto_redaction": false,
_18
"media_redaction": false,
_18
"auto_transcribe": true,
_18
"data_logging": true,
_18
"webhook_url": "https://www.sendgrid.com",
_18
"webhook_http_method": "GET",
_18
"language_code": "en-US",
_18
"read_only_attached_operator_sids": "['LYXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX']",
_18
"version": 2,
_18
"url": "https://intelligence.twilio.com/v2/Services/GAXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
_18
}


DELETE https://intelligence.twilio.com/v2/Services/{Sid}

URI parameters
Sidtype: string
Path ParameterNot PII

A 34 character string that uniquely identifies this Service.

Node.js
Python
C#
Java
Go
PHP
Ruby
twilio-cli
curl

_10
// Download the helper library from https://www.twilio.com/docs/node/install
_10
// Find your Account SID and Auth Token at twilio.com/console
_10
// and set the environment variables. See http://twil.io/secure
_10
const accountSid = process.env.TWILIO_ACCOUNT_SID;
_10
const authToken = process.env.TWILIO_AUTH_TOKEN;
_10
const client = require('twilio')(accountSid, authToken);
_10
_10
client.intelligence.v2.services('GAXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX').remove();


Rate this page: