Twilio voice-insights webhook events
Twilio sends 10 voice-insights events, including com.twilio.voice.insights.call-summary.partial, com.twilio.voice.insights.call-summary.predicted-complete and com.twilio.voice.insights.call-summary.complete. 7 have sample payloads.
Twilio has two systems that send you webhooks. Messaging, Voice and other products call a URL you set on a number or resource, with form parameters and no event type field. Event Streams sends JSON CloudEvents with a type. The events list names Event Streams types and Conversations (classic) actions, because a status callback has no event name to list. SendGrid's email events are separate: see SendGrid webhooks.
Every event here can also reach agents as an MCP event through Hookdeck: MCP events →
com.twilio.voice.insights.call-summary.partial
documented No payload yet
com.twilio.voice.insights.call-summary.partial Partial Voice Insights summary of a call is ready
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource voice-insights
No payload yet.
com.twilio.voice.insights.call-summary.predicted-complete
documented from Twilio docs (example)
com.twilio.voice.insights.call-summary.predicted-complete Voice Insights predicts a call summary is complete
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource voice-insights
{
"specversion": "1.0",
"type": "com.twilio.voice.insights.call-summary.predicted-complete",
"source": "/v1/Voice/CA00000000000000000000000000000000/Summary",
"id": "EZ00000000000000000000000000000000",
"dataschema": "https://events-schemas.twilio.com/VoiceInsights.CallSummary/1",
"datacontenttype": "application/json",
"time": "2020-07-23T22:56:33.000Z",
"data": "{\"call_sid\":\"CA00000000000000000000000000000000\",\"account_sid\":\"AC00000000000000000000000000000000\",\"parent_call_sid\":\"\",\"parent_account_sid\":\"\",\"start_time\":\"2020-07-23T22:56:28Z\",\"end_time\":\"2020-07-23T22:56:33Z\",\"duration\":0,\"connect_duration\":0,\"call_type\":\"client\",\"call_state\":\"canceled\",\"from\":{\"caller\":\"+55555555\",\"callee\":\"\",\"carrier\":\"MEGA:CORP\",\"connection\":\"landline\",\"number_prefix\":\"5555\",\"location\":{\"lat\":0.0,\"lon\":-0.0},\"city\":\"\",\"country_code\":\"US\",\"country_subdivision\":\"\",\"ip_address\":\"\",\"sdk\":null},\"to\":{\"caller\":\"\",\"callee\":\"client:SOMECLIENT\",\"carrier\":\"\",\"connection\":\"twilio_sdk\",\"number_prefix\":\"\",\"location\":null,\"city\":\"\",\"country_code\":\"\",\"country_subdivision\":\"\",\"ip_address\":\"\",\"sdk\":null},\"processing_state\":\"partial\",\"processing_version\":1,\"sip_edge\":null,\"carrier_edge\":null,\"sdk_edge\":null,\"client_edge\":null,\"tags\":[],\"attributes\":null,\"properties\":{\"q850_cause\":0,\"last_sip_response_num\":0,\"pdd_ms\":0,\"route_id\":\"\",\"media_region\":\"unknown_realm\",\"signaling_region\":\"unknown_realm\",\"twilio_media_ip\":\"\",\"twilio_signaling_ip\":\"\",\"external_media_ip\":\"\",\"external_signaling_ip\":\"\",\"sip_call_id\":\"\",\"user_agent\":\"\",\"selected_region\":\"unknown_realm\",\"region\":\"unknown_realm\",\"trunk_sid\":\"\",\"disconnected_by\":\"unknown_disconnected_by\",\"direction\":\"outbound_api\",\"settings\":null}}"
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | EZ00000000000000000000000000000000 |
type | string | com.twilio.voice.insights.call-summary.predicted-complete |
Full schema: 8 fields.
From Twilio docs
-
Content type
application/json
com.twilio.voice.insights.call-summary.complete
documented No payload yet
com.twilio.voice.insights.call-summary.complete Final Voice Insights summary of a call is ready
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource voice-insights
No payload yet.
com.twilio.voice.insights.conference-summary.partial
documented from Twilio docs (example)
com.twilio.voice.insights.conference-summary.partial Partial Voice Insights summary of a conference is ready
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource voice-insights
{
"specversion": "1.0",
"type": "com.twilio.voice.insights.conference-summary.partial",
"source": "AB00000000000000000000000001",
"id": "NO00000000000000000000000001",
"dataschema": "https://events-schemas.twilio.com/VoiceInsights.ConferenceSummary/2",
"datacontenttype": "2025-10-08T07:17:02.363Z",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | NO00000000000000000000000001 |
type | string | com.twilio.voice.insights.conference-summary.partial |
Full schema: 39 fields.
From Twilio docs
-
Content type
application/json
com.twilio.voice.insights.conference-summary.complete
documented No payload yet
com.twilio.voice.insights.conference-summary.complete Final Voice Insights summary of a conference is ready
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource voice-insights
No payload yet.
com.twilio.voice.insights.conference-participant-summary.complete
documented from Twilio docs (example)
com.twilio.voice.insights.conference-participant-summary.complete Final summary of a conference participant is ready
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource voice-insights
{
"specversion": "1.0",
"type": "com.twilio.voice.insights.conference-participant-summary.complete",
"source": "AB00000000000000000000000001",
"id": "NO00000000000000000000000001",
"dataschema": "https://events-schemas.twilio.com/VoiceInsights.ConferenceParticipantSummary/2",
"datacontenttype": "2025-10-08T07:17:02.363Z",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | NO00000000000000000000000001 |
type | string | com.twilio.voice.insights.conference-participant-summary.complete |
Full schema: 141 fields.
From Twilio docs
-
Content type
application/json
com.twilio.voice.insights.call-event.gateway
documented from Twilio docs (example)
com.twilio.voice.insights.call-event.gateway Voice Insights captures a gateway call event
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource voice-insights
{
"specversion": "1.0",
"type": "com.twilio.voice.insights.call-event.gateway",
"source": "AB00000000000000000000000001",
"id": "NO00000000000000000000000001",
"dataschema": "https://events-schemas.twilio.com/VoiceInsights.CallEvent/3",
"datacontenttype": "2025-10-08T07:17:02.363Z",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | NO00000000000000000000000001 |
type | string | com.twilio.voice.insights.call-event.gateway |
Full schema: 132 fields.
From Twilio docs
-
Content type
application/json
com.twilio.voice.insights.call-event.sdk
documented from Twilio docs (example)
com.twilio.voice.insights.call-event.sdk Voice Insights captures a Voice SDK call event
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource voice-insights
{
"specversion": "1.0",
"type": "com.twilio.voice.insights.call-event.sdk",
"source": "AB00000000000000000000000001",
"id": "NO00000000000000000000000001",
"dataschema": "https://events-schemas.twilio.com/VoiceInsights.CallEvent/3",
"datacontenttype": "2025-10-08T07:17:02.363Z",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | NO00000000000000000000000001 |
type | string | com.twilio.voice.insights.call-event.sdk |
Full schema: 132 fields.
From Twilio docs
-
Content type
application/json
com.twilio.voice.insights.call-metrics.gateway
documented from Twilio docs (example)
com.twilio.voice.insights.call-metrics.gateway Voice Insights captures gateway call metrics
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource voice-insights
{
"specversion": "1.0",
"type": "com.twilio.voice.insights.call-metrics.gateway",
"source": "AB00000000000000000000000001",
"id": "NO00000000000000000000000001",
"dataschema": "https://events-schemas.twilio.com/VoiceInsights.CallMetric/2",
"datacontenttype": "2025-10-08T07:17:02.363Z",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | NO00000000000000000000000001 |
type | string | com.twilio.voice.insights.call-metrics.gateway |
Full schema: 446 fields.
From Twilio docs
-
Content type
application/json
com.twilio.voice.insights.call-metrics.sdk
documented from Twilio docs (example)
com.twilio.voice.insights.call-metrics.sdk Voice Insights captures Voice SDK call metrics
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource voice-insights
{
"specversion": "1.0",
"type": "com.twilio.voice.insights.call-metrics.sdk",
"source": "AB00000000000000000000000001",
"id": "NO00000000000000000000000001",
"dataschema": "https://events-schemas.twilio.com/VoiceInsights.CallMetric/2",
"datacontenttype": "2025-10-08T07:17:02.363Z",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | NO00000000000000000000000001 |
type | string | com.twilio.voice.insights.call-metrics.sdk |
Full schema: 446 fields.
From Twilio docs
-
Content type
application/json
Route Twilio events by type.
Event Gateway receives every Twilio delivery and filters and routes it by event type, so each service gets only the events it handles.