---
"@context": https://schema.org
"@type": TechArticle
"@id": https://www.twilio.com/docs/conversations/intelligence/conversation-insights/sync-with-data-destinations#article
headline: Sync Conversation Insights data with Data Destinations
description: Sync Conversation Insights ConversationSummary records, including sentiment, AI agent task completion, hallucination detection, and custom measures, to your data warehouse or other tools with Twilio Data Destinations.
url: https://www.twilio.com/docs/conversations/intelligence/conversation-insights/sync-with-data-destinations
inLanguage: en
dateModified: 2026-11-16T22:26:17.000Z
author:
  "@type": Organization
  name: Twilio Developer Education Team
publisher:
  "@type": Organization
  name: Twilio
---

# Sync Conversation Insights data with Data Destinations

> \[!IMPORTANT]
>
> Data Destinations is currently available as a Private Beta product and the information contained in this document is subject to change. Data Destinations is not a HIPAA Eligible Service or PCI compliant and should not be enabled in workflows that are subject to HIPAA or PCI. To learn more, see [Private beta legal information](/docs/data-destinations#private-beta-legal-information).

## Join the Data Destinations private beta

[Sign up](https://airtable.com/appaJfyV6LiIFMxuP/pagIaOAtKsQVxTfdW/form)

Get early access to native destinations for data warehouses, observability tools, and event pipelines.

Conversations are most valuable when you can analyze them alongside the rest of your business. Use [Data Destinations](/docs/data-destinations) to sync Conversation Insights data to the data warehouses, BI, and product analytics tools your team already uses, such as Snowflake, BigQuery, or Amplitude. Join it with your proprietary data, such as CRM accounts, orders, or product usage, and build the reports and dashboards you need on top of it, without building or maintaining a custom ETL pipeline.

When a conversation closes, Conversation Insights sends a single record that summarizes it. The record includes:

* Conversation details, such as channels, timestamps, and participants.
* Operator results, such as sentiment, AI agent task completion, and hallucination detection.
* Your [custom measures](/docs/conversations/intelligence/conversation-insights/define-custom-fields).

Each conversation is one flat record, so you can query it, report on it, and visualize it without joining tables or reshaping data first.

Data Destinations sends individual records, not aggregated results. You aggregate and query them in your destination, and the Conversation Insights Query API doesn't read data from your destination.

|                       | Conversation Insights Query API                          | Data Destinations                                              |
| --------------------- | -------------------------------------------------------- | -------------------------------------------------------------- |
| **What you get**      | Aggregated results, such as last week's resolution rate. | Individual conversation records.                               |
| **Where you analyze** | In Twilio, through the API.                              | In your destination's own tools.                               |
| **Time range**        | Up to 31 days per request.                               | As long as you retain the records.                             |
| **Best for**          | On-demand answers about your conversations.              | Reporting that combines conversations with your business data. |

## How it works

1. A conversation closes in [Conversation Orchestrator](/docs/conversations/orchestrator).
2. Conversation Insights builds the [ConversationSummary](/docs/conversations/intelligence/conversation-insights/core-concepts#conversationsummary-cube) record and publishes it as a `com.twilio.insights.conversation.summarized` event.
3. Data Destinations delivers the event to each destination with a subscription to that event type.
4. You aggregate and query the records in your destination.

## Supported destinations

The `com.twilio.insights.conversation.summarized` event type is available in the United States (US1) region only.

| Category           | Destinations                                                                                                                                                                                                                                                                                                                          |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Warehouses         | [Snowflake](/docs/data-destinations/destination/snowflake), [BigQuery](/docs/data-destinations/destination/bigquery), [Databricks](/docs/data-destinations/destination/databricks)                                                                                                                                                    |
| Observability      | [Datadog](/docs/data-destinations/destination/datadog), [Splunk](/docs/data-destinations/destination/splunk), [Grafana Cloud](/docs/data-destinations/destination/grafana-cloud), [New Relic](/docs/data-destinations/destination/new-relic)                                                                                          |
| Product analytics  | [Amplitude](/docs/data-destinations/destination/amplitude), [Google Analytics 4](/docs/data-destinations/destination/google-analytics-4), [Mixpanel](/docs/data-destinations/destination/mixpanel)                                                                                                                                    |
| Raw data streaming | [Webhook](/docs/data-destinations/destination/webhook), [Amazon Kinesis](/docs/data-destinations/destination/amazon-kinesis), [Apache Kafka](/docs/data-destinations/destination/kafka), [Google Cloud Pub/Sub](/docs/data-destinations/destination/gcp-pubsub), [Azure Event Hubs](/docs/data-destinations/destination/azure-events) |
| Other              | [Airtable](/docs/data-destinations/destination/airtable), [Slack](/docs/data-destinations/destination/slack)                                                                                                                                                                                                                          |

Product analytics destinations track events per user, so Data Destinations uses the record's `customer_profile_id` as the user identifier. This is a [Conversation Memory](/docs/conversations/memory) profile ID, so it doesn't match user IDs you already send to these tools unless you map them.

> \[!NOTE]
>
> Slack and Airtable accept low request volumes. Every closed conversation produces one event, so use a warehouse or streaming destination for production-scale volume. To learn more, see the [Destination comparison](/docs/data-destinations/destination-comparison).

## Prerequisites

* Your account is enrolled in the [Data Destinations (private beta)](/docs/data-destinations).
* You're an Account Owner or Account Administrator, or you have a Data Destinations role. Account Owners and Account Administrators have access by default. Other users need one of these roles:

  * **Destinations Admin** to create and manage destinations and subscriptions.
  * **Destinations Viewer** to only view destinations and subscriptions.

  To assign a role, in the Twilio Console, go to [**Settings** > **Organization settings** > **Users**](https://1console.twilio.com/organization/settings/users/managed-users), click the user, click **Role Assignments**, and add the role. To learn more, see [RBAC in Twilio Console](/docs/iam/access-control/rbac-twilio-console).
* [Conversation Intelligence is set up](/docs/conversations/intelligence/create-intelligence-configuration) with [rules](/docs/conversations/intelligence/define-rules) that run the operators you want to export. Fields for operators that don't run on a conversation are `null`.
* To include custom measures, [register them](/docs/conversations/intelligence/conversation-insights/define-custom-fields).

## Set up a destination in the Console

1. Sign in to [Twilio Console](https://1console.twilio.com/).
2. In the left navigation, go to **Data** > **Data Destinations** > **Destinations**.
3. Click **Add destination subscription** to open the setup wizard.

   > \[!NOTE]
   >
   > If **Add destination subscription** is unavailable and shows **Destinations Admin permission required**, your user doesn't have the Destinations Admin role yet. [Assign the role](#prerequisites), then reload the page.
4. Under **Select existing destination**, select your destination. If you haven't set up a connection to it yet, click **Add new destination**.
5. Select a [destination that supports Conversation Insights](#supported-destinations). The list also includes destination types that don't support it.
6. Enter the credentials and configuration for your destination type, then save the destination. For destination-specific settings, see the page for your destination in [Data Destinations](/docs/data-destinations/destinations-overview).
7. The wizard returns you to **Add destination subscription**. Under **Create Subscription**, click **Get started**.
8. Enter a name for your subscription. Expand **Conversation Insights**, select the **Conversation Insights Summarized** event (`com.twilio.insights.conversation.summarized`), and keep **Use latest schema version** turned on. Then click **Save subscription**.

Your destination now receives a ConversationSummary record each time a conversation closes.

## Set up a destination with the API

To manage destinations programmatically instead of in the Console, use the Destinations API. Create a destination, then create a subscription to the `com.twilio.insights.conversation.summarized` event type. For a full walkthrough, including authentication, catalog lookups, and asynchronous operations, see the [Destinations API quickstart](/docs/data-destinations/api-quickstart).

The following example creates a [Snowflake destination](/docs/data-destinations/destination/snowflake) for illustration, to match the SQL in [Calculate metrics that match Conversation Insights](#calculate-metrics-that-match-conversation-insights). Create whichever destination type you want from the [supported destinations](#supported-destinations), and get its `config` shape from the destination type catalog with `GET https://destinations.twilio.com/v1/Catalog/DestinationTypes/{destinationType}`.

### Create a destination

Replace the uppercase placeholder values with your own Snowflake account identifier, database, schema, and key-pair credentials.

```bash title="Create a Snowflake destination"
curl -X POST "https://destinations.twilio.com/v1/ControlPlane/Destinations" \
  -u $TWILIO_API_KEY:$TWILIO_API_SECRET \
  -H "Content-Type: application/json" \
  -d '{
    "destinationType": "snowflake",
    "name": "Conversation summaries",
    "config": {
      "account": "ACCOUNT",
      "database": "DATABASE",
      "schema": "SCHEMA",
      "credentials": {
        "credentialType": "KEY_PAIR",
        "username": "USERNAME",
        "privateKey": "PRIVATE_KEY"
      }
    }
  }'
```

The response includes the destination `id`, such as `tde_dest_01k88r5c5fg21bzmsxpaz3d9r0`.

### Create a subscription

```bash title="Subscribe to ConversationSummary records"
curl -X POST "https://destinations.twilio.com/v1/ControlPlane/Subscriptions" \
  -u $TWILIO_API_KEY:$TWILIO_API_SECRET \
  -H "Content-Type: application/json" \
  -d '{
    "description": "Conversation Insights summaries",
    "destinationId": "tde_dest_01k88r5c5fg21bzmsxpaz3d9r0",
    "eventTypes": [
      {
        "eventType": "com.twilio.insights.conversation.summarized",
        "schemaVersion": 1
      }
    ]
  }'
```

## The ConversationSummary record

Each `com.twilio.insights.conversation.summarized` event carries one ConversationSummary record for a single conversation. The record is a variant of a [ConversationSummary cube](/docs/conversations/intelligence/conversation-insights/core-concepts#conversationsummary-cube) row, adapted for delivery to your systems, so it doesn't match the cube one to one:

* **Per-conversation values only.** The record holds the values for one conversation, not the cube's measures, such as counts and rates. You calculate those in your destination. See [Calculate metrics that match Conversation Insights](#calculate-metrics-that-match-conversation-insights).
* **Snake case names and arrays.** Field names use snake case, so `TaskCompletion` becomes `task_completion`, and lists are arrays rather than comma-separated strings.
* **One object for custom measures.** Instead of `<Name><Aggregation>` measures, the record has a single `custom_measures` object. See [Custom measures](#custom-measures).

### Record fields

The second column shows the ConversationSummary cube field that each record field comes from.

| Field                                              | ConversationSummary field        | Type             | Description                                                                                                                                                                                    |
| -------------------------------------------------- | -------------------------------- | ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `conversation_id`                                  | `ConversationId`                 | string           | The unique identifier for the conversation. Use it to join with your other data.                                                                                                               |
| `conversation_name`                                | `ConversationName`               | string           | The name of the conversation. Can contain personal data.                                                                                                                                       |
| `conversation_status`                              | `ConversationStatus`             | string           | The final status of the conversation.                                                                                                                                                          |
| `channels`                                         | `Channels`                       | array of strings | The communication channels used in the conversation, such as `VOICE` and `SMS`.                                                                                                                |
| `date_created`                                     | `CreatedDate`                    | string           | When the conversation was created, in ISO 8601 format and UTC.                                                                                                                                 |
| `date_closed`                                      | `ClosedDate`                     | string           | When the conversation was closed, in ISO 8601 format and UTC.                                                                                                                                  |
| `intelligence_configuration_ids`                   | `IntelligenceConfigurationIds`   | array of strings | The intelligence configurations associated with the conversation.                                                                                                                              |
| `participant_count`                                | `Participants` measures          | integer          | The number of participants in the conversation. The cube aggregates this value with `ParticipantsSum`, `ParticipantsAvg`, `ParticipantsMin`, and `ParticipantsMax`.                            |
| `has_human_agent`                                  | `HasHumanAgent`                  | boolean          | Whether at least one human agent took part in the conversation.                                                                                                                                |
| `has_ai_agent`                                     | `HasAIAgent`                     | boolean          | Whether at least one AI agent took part in the conversation.                                                                                                                                   |
| `customer_profile_id`                              | `CustomerProfileId`              | string           | The profile identifier for the customer participant. Left out of the record when the conversation has no customer profile.                                                                     |
| `custom_measures`                                  | `<Name><Aggregation>` measures   | object           | Your custom measures from Conversation Intelligence custom operators, keyed by the name you registered. See [Custom measures](#custom-measures).                                               |
| **Sentiment operator**                             |                                  |                  |                                                                                                                                                                                                |
| `sentiment`                                        | `Sentiment`                      | string           | The latest label from the Sentiment operator: `positive`, `negative`, `neutral`, or `mixed`. `null` when the operator didn't run on the conversation.                                          |
| **Task Completion operator (public beta)**         |                                  |                  |                                                                                                                                                                                                |
| `task_completion`                                  | `TaskCompletion`                 | string           | The latest label from the Task Completion operator: `RESOLVED`, `UNRESOLVED`, `ESCALATED`, or `AGENT_DECLINED`. `null` when the operator didn't run on the conversation.                       |
| **Hallucination Detection operator (public beta)** |                                  |                  |                                                                                                                                                                                                |
| `hallucination_count`                              | `HallucinationCount`             | integer          | The number of hallucinations found, counting each distinct combination of conflict type and source once. A context gap isn't counted. `null` when the operator didn't run on the conversation. |
| `has_hallucination`                                | `HasHallucination`               | boolean          | Whether the operator found at least one hallucination. A context gap isn't counted as a hallucination. `null` when the operator didn't run on the conversation.                                |
| `has_external_context_conflict`                    | `HasExternalContextConflict`     | boolean          | Whether the agent contradicted your Enterprise Knowledge, Conversation Memory, or both. `null` when the operator didn't run on the conversation.                                               |
| `has_conversation_context_conflict`                | `HasConversationContextConflict` | boolean          | Whether the agent contradicted something said earlier in the conversation. `null` when the operator didn't run on the conversation.                                                            |
| `has_context_gap`                                  | `HasContextGap`                  | boolean          | Whether the agent made a claim that can't be verified against your knowledge, memory, or the conversation. `null` when the operator didn't run on the conversation.                            |

To learn how each value is calculated, see [ConversationSummary dimensions](/docs/conversations/intelligence/conversation-insights/core-concepts#conversationsummary-dimensions). Label values are case-sensitive: sentiment labels are lowercase, and task completion labels are uppercase. New fields can be added to the record over time, so build your integration to ignore fields it doesn't recognize.

### Custom measures

The `custom_measures` field holds the values of every [custom measure](/docs/conversations/intelligence/conversation-insights/define-custom-fields) you've registered from a Conversation Intelligence custom operator. It's an object with one key per measure:

* **Key**: The `name` you registered the measure with, such as `LeadScore`. It isn't the operator's output field, such as `leadScore`.
* **Value**: The number the operator produced for this conversation. If the operator ran more than once on the conversation, the record has the latest result.

```json title="custom_measures with two registered measures"
"custom_measures": {
  "LeadScore": 82,
  "QaScore": 4.5
}
```

A measure is left out of the object when its operator didn't run on the conversation, so don't treat a missing key as zero. The object is empty when you haven't registered any measures. Registration applies going forward only, so a measure appears only in records for operator runs after you registered it.

### Example record

```json title="Example ConversationSummary record"
{
  "conversation_id": "conv_conversation_01ks4d7f1jffrrhfdmxrgk3epa",
  "conversation_name": "Order status inquiry",
  "conversation_status": "CLOSED",
  "channels": ["VOICE", "SMS"],
  "date_created": "2026-10-21T16:00:00.000Z",
  "date_closed": "2026-10-21T16:12:30.000Z",
  "intelligence_configuration_ids": [
    "intelligence_configuration_01knmybwv2eecb1n6gyche3dee"
  ],
  "participant_count": 2,
  "has_human_agent": false,
  "has_ai_agent": true,
  "customer_profile_id": "mem_profile_xbvx6n988v7nnqc11e1bnneh0c",
  "custom_measures": {
    "LeadScore": 82
  },
  "sentiment": "positive",
  "task_completion": "RESOLVED",
  "hallucination_count": 1,
  "has_hallucination": true,
  "has_external_context_conflict": true,
  "has_conversation_context_conflict": false,
  "has_context_gap": false
}
```

Data Destinations delivers each record as the `data` object of a [CloudEvent](https://github.com/cloudevents/spec/blob/v1.0/spec.md):

```json title="ConversationSummary record in its event envelope"
{
  "specversion": "1.0",
  "type": "com.twilio.insights.conversation.summarized",
  "id": "databridge_event_fa7b1a8a593643d59995fc987a7aac82",
  "time": "2026-10-21T16:13:45.000Z",
  "datacontenttype": "application/json",
  "dataschema": "https://events-schemas.twilio.com/Insights.ConversationSummary/1",
  "data": {
    "conversation_id": "conv_conversation_01ks4d7f1jffrrhfdmxrgk3epa",
    "conversation_status": "CLOSED",
    "task_completion": "RESOLVED"
  }
}
```

The `data` object in this example is shortened. How the envelope arrives depends on the destination: webhook destinations receive an array of CloudEvents, and warehouse destinations store the event in a `payload` column. See the page for your destination for its format.

## Calculate metrics that match Conversation Insights

After records arrive in your destination, you calculate metrics yourself. To get the same numbers as the [Conversation Insights Query API](/docs/conversations/intelligence/conversation-insights/aggregate-data), use the same rule for each metric. Most importantly, leave out conversations where the operator didn't run. Those fields are `null`, and counting them lowers your rates.

| Metric                                                          | Query API                                                                                                    | Rule                                                                                          |
| --------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------- |
| [AI agent resolution rate](#ai-agent-resolution-rate)           | `ConversationSummary.Count` grouped by `TaskCompletion`, filtered on `HasAIAgent` `EQ` `true`                | `RESOLVED` conversations divided by conversations with any `task_completion` label.           |
| [Resolution rate by agent type](#resolution-rate-by-agent-type) | `ConversationSummary.Count` grouped by `HasAIAgent`, `HasHumanAgent`, and `TaskCompletion`                   | The resolution rate, calculated separately for each combination of agent flags.               |
| [AI agent hallucination rate](#ai-agent-hallucination-rate)     | `ConversationSummary.Count` grouped by `HasHallucination`, filtered on `HasAIAgent` `EQ` `true`              | `has_hallucination` `true` divided by conversations where `has_hallucination` isn't `null`.   |
| [Hallucination rate by type](#hallucination-rate-by-type)       | `ConversationSummary.Count` grouped by the three type dimensions, filtered on `HasHallucination` `NE` `null` | Each type flag that's `true` divided by conversations where `has_hallucination` isn't `null`. |
| [Sentiment share](#sentiment-share)                             | `ConversationSummary.Count` grouped by `Sentiment`                                                           | Conversations with each label divided by conversations where `sentiment` isn't `null`.        |
| [Custom measure average](#custom-measure-average)               | `ConversationSummary.<Name>Avg`                                                                              | The average of the measure across conversations that have a value.                            |

The following examples use Snowflake and group results by week. A [Snowflake destination](/docs/data-destinations/destination/snowflake) writes events to a table named `TWILIO_EVENTS_<SUBSCRIPTION_ID>`, with the record in the `payload` column. For other destinations, apply the same rules in that tool's query language. When you write your own queries, keep these points in mind:

* **Cast fields before you count them.** A JSON `null` in a Snowflake `VARIANT` column isn't a SQL `NULL`, so `COUNT(payload:task_completion)` includes conversations where the operator didn't run. Cast the field first, such as `payload:task_completion::string`.
* **Use `date_created` for time ranges.** It's the same timestamp as `ConversationSummary.CreatedDate`, which the Query API examples filter on.

### AI agent resolution rate

The share of AI agent conversations where the agent resolved the customer's task.

```sql title="AI agent resolution rate"
SELECT
  DATE_TRUNC('week', payload:date_created::timestamp) AS week,
  COUNT_IF(payload:task_completion::string = 'RESOLVED')
    / NULLIF(COUNT(payload:task_completion::string), 0) AS resolution_rate
FROM TWILIO_EVENTS_<SUBSCRIPTION_ID>
WHERE event_type = 'com.twilio.insights.conversation.summarized'
  AND payload:has_ai_agent::boolean
GROUP BY week
ORDER BY week;
```

### Resolution rate by agent type

The resolution rate for conversations handled only by an AI agent, only by a human agent, or by both. A conversation that an AI agent hands off to a human agent has both flags set to `true`.

```sql title="Resolution rate by agent type"
SELECT
  payload:has_ai_agent::boolean AS has_ai_agent,
  payload:has_human_agent::boolean AS has_human_agent,
  COUNT_IF(payload:task_completion::string = 'RESOLVED')
    / NULLIF(COUNT(payload:task_completion::string), 0) AS resolution_rate
FROM TWILIO_EVENTS_<SUBSCRIPTION_ID>
WHERE event_type = 'com.twilio.insights.conversation.summarized'
GROUP BY has_ai_agent, has_human_agent;
```

### AI agent hallucination rate

The share of AI agent conversations with at least one hallucination. A context gap isn't counted as a hallucination.

```sql title="AI agent hallucination rate"
SELECT
  DATE_TRUNC('week', payload:date_created::timestamp) AS week,
  COUNT_IF(payload:has_hallucination::boolean)
    / NULLIF(COUNT(payload:has_hallucination::boolean), 0) AS hallucination_rate
FROM TWILIO_EVENTS_<SUBSCRIPTION_ID>
WHERE event_type = 'com.twilio.insights.conversation.summarized'
  AND payload:has_ai_agent::boolean
GROUP BY week
ORDER BY week;
```

### Hallucination rate by type

The share of analyzed AI agent conversations with each finding type. A conversation can have more than one type, so it can count toward more than one rate.

```sql title="Hallucination rate by type"
SELECT
  DATE_TRUNC('week', payload:date_created::timestamp) AS week,
  COUNT_IF(payload:has_external_context_conflict::boolean)
    / COUNT(*) AS external_context_conflict_rate,
  COUNT_IF(payload:has_conversation_context_conflict::boolean)
    / COUNT(*) AS conversation_context_conflict_rate,
  COUNT_IF(payload:has_context_gap::boolean)
    / COUNT(*) AS context_gap_rate
FROM TWILIO_EVENTS_<SUBSCRIPTION_ID>
WHERE event_type = 'com.twilio.insights.conversation.summarized'
  AND payload:has_ai_agent::boolean
  AND payload:has_hallucination::boolean IS NOT NULL
GROUP BY week
ORDER BY week;
```

### Sentiment share

The share of conversations with each sentiment label.

```sql title="Sentiment share"
SELECT
  DATE_TRUNC('week', payload:date_created::timestamp) AS week,
  payload:sentiment::string AS sentiment,
  COUNT(*) / SUM(COUNT(*)) OVER (PARTITION BY week) AS share
FROM TWILIO_EVENTS_<SUBSCRIPTION_ID>
WHERE event_type = 'com.twilio.insights.conversation.summarized'
  AND payload:sentiment::string IS NOT NULL
GROUP BY week, sentiment
ORDER BY week, sentiment;
```

### Custom measure average

The average value of a custom measure. Replace `LeadScore` with the name you registered the measure with. Snowflake path names are case-sensitive, so match the name exactly.

```sql title="Custom measure average"
SELECT
  DATE_TRUNC('week', payload:date_created::timestamp) AS week,
  AVG(payload:custom_measures:"LeadScore"::float) AS lead_score_avg
FROM TWILIO_EVENTS_<SUBSCRIPTION_ID>
WHERE event_type = 'com.twilio.insights.conversation.summarized'
GROUP BY week
ORDER BY week;
```

## Pricing

Data Destinations is free to use during the private beta. Pricing will be announced when Data Destinations reaches general availability.

## Next steps

* [Core concepts](/docs/conversations/intelligence/conversation-insights/core-concepts): Learn what each ConversationSummary field means and how it's calculated.
* [Supervise AI agents](/docs/conversations/intelligence/supervise-ai-agents): Set up the Task Completion and Hallucination Detection operators.
* [Define and use custom fields](/docs/conversations/intelligence/conversation-insights/define-custom-fields): Add your own measures to the summary.
* [Destinations overview](/docs/data-destinations/destinations-overview): Learn more about Data Destinations.
