On this page

Voice Intelligence API Overview

The Voice Intelligence API allows you to analyze and extract actionable business intelligence from conversations between your customers and agents using artificial intelligence and machine learning technologies.

This REST API lets you start conversation analysis services, generate transcripts, and manage webhooks that send information to your application as Voice Intelligence Services extract meaningful data.

Base URL for API

All endpoints in the Voice Intelligence API reference documentation use the following base URL:

https://intelligence.twilio.com/v2

The API is served over HTTPS. To ensure data privacy, it doesn't support unencrypted HTTP. It provides all responses in JSON format.

API resources overview

The Voice Intelligence API includes these resources:

Service resource

Service resource: Create, initialize, and manage Voice Intelligence Services.
OperatorAttachment subresource: Create and delete Operator Attachments from a Service.
OperatorAttachments subresource: Fetch Operator Attachments associated with a Service.

Transcript resource

Transcript resource: Generate and manage conversation Transcripts.
Transcript Media subresource: Access recording media associated with a Transcript.
Transcript OperatorResults subresource: Get the list of OperatorResults for a transcript.
Transcript Sentence subresource: List the Sentences of a Transcript.

Operator resource

Operator resource: Retrieve the details of a Pre-built or Custom Operator.
PrebuiltOperator subresource: Fetch and list Pre-built Operators.
CustomOperator subresource: Create, fetch, list, update, and delete Custom Operators.

OperatorType resource

OperatorType resource: Get the details of an OperatorType.

Authenticate API requests

When using Voice Intelligence, authenticate with HTTP Basic authentication by using your Twilio Account SID as the username and your Auth Token as the password.

You can use Restricted API keys with Voice Intelligence for fine-grained control over API resources. For example, you can provide permissions for an API key to only modify Voice Intelligence Service resources, but not access potentially-sensitive information such as unredacted Transcript Media subresources, Transcript resources, or Transcript OperatorResults subresources.

For more information on Twilio's REST API, refer to the Usage documentation on sending requests, API responses, and security.

Rate limiting

Voice Intelligence API endpoints are rate limited. You should follow the REST API Best Practices, and implement retries with exponential backoff to properly handle the API response Error 429 "Too Many Requests" for high-volume workloads.