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

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.

Help fill this in → View as JSON

com.twilio.voice.insights.call-summary.predicted-complete

documented from Twilio docs (example)

Voice Insights predicts a call summary is complete

Identified by type in each CloudEvent on Event Streams; none on classic callbacks Resource voice-insights

twilio-com-twilio-voice-insights-call-summary-predicted-complete.json
{
  "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

View as JSON

com.twilio.voice.insights.call-summary.complete

documented No payload yet

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.

Help fill this in → View as JSON

com.twilio.voice.insights.conference-summary.partial

documented from Twilio docs (example)

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

twilio-com-twilio-voice-insights-conference-summary-partial.json
{
  "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

View as JSON

com.twilio.voice.insights.conference-summary.complete

documented No payload yet

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.

Help fill this in → View as JSON

com.twilio.voice.insights.conference-participant-summary.complete

documented from Twilio docs (example)

Final summary of a conference participant is ready

Identified by type in each CloudEvent on Event Streams; none on classic callbacks Resource voice-insights

twilio-com-twilio-voice-insights-conference-participant-summary-complete.json
{
  "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

View as JSON

com.twilio.voice.insights.call-event.gateway

documented from Twilio docs (example)

Voice Insights captures a gateway call event

Identified by type in each CloudEvent on Event Streams; none on classic callbacks Resource voice-insights

twilio-com-twilio-voice-insights-call-event-gateway.json
{
  "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

View as JSON

com.twilio.voice.insights.call-event.sdk

documented from Twilio docs (example)

Voice Insights captures a Voice SDK call event

Identified by type in each CloudEvent on Event Streams; none on classic callbacks Resource voice-insights

twilio-com-twilio-voice-insights-call-event-sdk.json
{
  "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

View as JSON

com.twilio.voice.insights.call-metrics.gateway

documented from Twilio docs (example)

Voice Insights captures gateway call metrics

Identified by type in each CloudEvent on Event Streams; none on classic callbacks Resource voice-insights

twilio-com-twilio-voice-insights-call-metrics-gateway.json
{
  "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

View as JSON

com.twilio.voice.insights.call-metrics.sdk

documented from Twilio docs (example)

Voice Insights captures Voice SDK call metrics

Identified by type in each CloudEvent on Event Streams; none on classic callbacks Resource voice-insights

twilio-com-twilio-voice-insights-call-metrics-sdk.json
{
  "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

View as 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.

Not affiliated with Twilio. Facts are compiled from public sources and linked inline.