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

Voice Insights Settings Resource


Voice Insights Settings determine whether

  • Advanced Features and/or
  • Voice Trace

are activated for a given account.

Using the Voice Insights Settings Resource, you can

for an account or a specific subaccount.


Voice Insight Settings properties

voice-insight-settings-properties page anchor
Property nameTypePIIDescription
account_sidSID<AC>
Not PII

The unique SID identifier of the Account.

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

advanced_featuresboolean

A boolean flag indicating whether Advanced Features for Voice Insights are enabled.


voice_traceboolean

A boolean flag indicating whether Voice Trace is enabled.


urlstring<uri>

The URL of this resource.


Get the Voice Insights Settings

get-the-voice-insights-settings page anchor
GET https://insights.twilio.com/v1/Voice/Settings

Query parameters

query-parameters page anchor
Property nameTypeRequiredPIIDescription
SubaccountSidSID<AC>Optional

The unique SID identifier of the Subaccount.

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

Get the Voice Insights Settings for the account

get-the-voice-insights-settings-for-the-account page anchor
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.insights.v1.settings()
_10
.fetch()
_10
.then(setting => console.log(setting.advancedFeatures));

Output

_10
{
_10
"account_sid": "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
_10
"voice_trace": true,
_10
"advanced_features": true,
_10
"url": "https://insights.twilio.com/v1/Voice/Settings"
_10
}


Update Voice Insights Settings

update-voice-insights-settings page anchor
POST https://insights.twilio.com/v1/Voice/Settings

To manage subaccount Settings pass the subaccount SID as a parameter in the request.

Property nameTypeRequiredPIIDescription
AdvancedFeaturesbooleanOptional

A boolean flag to enable Advanced Features for Voice Insights.


VoiceTracebooleanOptional

A boolean flag to enable Voice Trace.


SubaccountSidSID<AC>Optional

The unique SID identifier of the Subaccount.

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

Update Settings to activate Advanced Features for the account

update-settings-to-activate-advanced-features-for-the-account page anchor
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.insights.v1.settings()
_10
.update({advancedFeatures: true})
_10
.then(setting => console.log(setting.advancedFeatures));

Output

_10
{
_10
"account_sid": "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
_10
"voice_trace": true,
_10
"advanced_features": true,
_10
"url": "https://insights.twilio.com/v1/Voice/Settings"
_10
}

Update Settings to activate Voice Trace for a subaccount

update-settings-to-activate-voice-trace-for-a-subaccount page anchor
Node.js
Python
C#
Java
Go
PHP
Ruby
twilio-cli
curl

_13
// Download the helper library from https://www.twilio.com/docs/node/install
_13
// Find your Account SID and Auth Token at twilio.com/console
_13
// and set the environment variables. See http://twil.io/secure
_13
const accountSid = process.env.TWILIO_ACCOUNT_SID;
_13
const authToken = process.env.TWILIO_AUTH_TOKEN;
_13
const client = require('twilio')(accountSid, authToken);
_13
_13
client.insights.v1.settings()
_13
.update({
_13
subaccountSid: 'ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaab',
_13
voiceTrace: true
_13
})
_13
.then(setting => console.log(setting.advancedFeatures));

Output

_10
{
_10
"account_sid": "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
_10
"voice_trace": true,
_10
"advanced_features": true,
_10
"url": "https://insights.twilio.com/v1/Voice/Settings"
_10
}


Rate this page: