--- "@context": https://schema.org "@type": TechArticle "@id": https://www.twilio.com/docs/voice/voice-insights/event-streams/call-insights-events#article headline: Call Insights Event Stream description: Learn to use Twilio Call Insights Event Stream for notifications, self-service automation, contact centers, AI agents, call tracking, and PSTN connectivity. url: https://www.twilio.com/docs/voice/voice-insights/event-streams/call-insights-events inLanguage: en dateModified: 2026-08-19T18:30:57.000Z author: "@type": Organization name: Twilio Developer Education Team publisher: "@type": Organization name: Twilio --- # Call Insights Event Stream Learn how to use Call Insights Event Streams to receive real-time webhooks for call summaries, metrics, and quality events. This feature provides deep visibility into the lifecycle and performance of your Twilio Voice calls through asynchronous event notifications. You can use this guide for notifications, self-service automation, inbound or outbound contact centers, AI agents, call tracking, PSTN connectivity, and AI/ML transcription. See [Related reference documentation](#related-reference-documentation) to learn more about the reference page elements used in this guide. [All Voice Insights guides](/docs/voice/guides/by-feature-product#voice-insights) ## Call Insights Events [Voice Insights](/docs/voice/voice-insights) provides seven **Call Insights Events** which can be [subscribed to via Event Streams](/docs/events). Together with the [Conference Insights Event Stream](/docs/voice/voice-insights/event-streams/conference-insights-event), these form part of the unified [Voice Insights Event Streams](/docs/voice/voice-insights/event-streams). | Event | Description | | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `com.twilio.voice.insights.call-event.gateway` | Gateway events are generated by [call progress events](/docs/voice/api/call-resource#statuscallbackevent). Events are typically emitted by Voice Insights within 90 seconds. Gateway events are part of the [Call Insights Events](/docs/voice/voice-insights/api/call/call-events-resource). | | `com.twilio.voice.insights.call-event.sdk` | SDK events are generated by [Voice SDK events](/docs/voice/voice-insights/api/call/details-sdk-call-quality-events). Events are typically emitted by Voice Insights within 90 seconds. SDK events are part of the [Call Insights Events](/docs/voice/voice-insights/api/call/call-events-resource). | | `com.twilio.voice.insights.call-metrics.gateway` | Gateway metrics are generated every ten seconds by sensors in Twilio's media gateways. Metrics are typically emitted by Voice Insights within 90 seconds. Gateway metrics are part of the [Call Metrics](/docs/voice/voice-insights/api/call/call-metrics-resource). | | `com.twilio.voice.insights.call-metrics.sdk` | SDK metrics are emitted every ten seconds by sensors in Twilio's Voice SDKs. Metrics are typically emitted by Voice Insights within 90 seconds. SDK metrics are part of the [Call Metrics](/docs/voice/voice-insights/api/call/call-metrics-resource). | | `com.twilio.voice.insights.call-summary.complete` | The [Call Summary](/docs/voice/voice-insights/api/call/call-summary-resource) provides an overview of metadata and quality metrics for a single call. A completed call summary may take up to thirty minutes to generate following the end of the call. | | `com.twilio.voice.insights.call-summary.partial` | A partial summary contains a partial set of the data that comprises the [Call Summary](/docs/voice/voice-insights/api/call/call-summary-resource). Multiple partial summary events will occur as the Call Summary is assembled. The first partial summary will be available within ten minutes of a call ending. | | `com.twilio.voice.insights.call-summary.predicted-complete` | The completed [Call Summary](/docs/voice/voice-insights/api/call/call-summary-resource) event is based on a thirty minute timer. Twilio uses ML to predict when a Call Summary is actually completed and emits the predicted-complete event based on the analysis of that model. The predicted complete event is typically available within ten minutes of a call ending. | ## Use cases for Call Insights Event Stream with Twilio Programmable Voice This guide covers a feature that can support the following use cases: ### Send voice notifications with Twilio Programmable Voice Use event streams to monitor the delivery and quality of automated alerts. You can track if emergency notifications or appointment reminders are reaching your customers with high audio quality. To learn more advanced features that you can use with voice notifications, see [Voice notifications](/docs/voice/guides/notifications). ### Create self-service automation with Twilio Programmable Voice Monitor user interactions within IVRs by tracking gateway events. This helps you identify points where users might struggle with automated menus. To learn more advanced features that you can use with self-service automation, see [Voice self-service automation](/docs/voice/guides/self-service-automation). ### Create an inbound contact center with Twilio Programmable Voice Provide supervisors with real-time data on call quality and connection status. This ensures that agents and customers have clear communication during support interactions. To learn more advanced features that you can use with inbound contact centers, see [Voice inbound call center](/docs/voice/guides/inbound-call-center). ### Create an outbound contact center with Twilio Programmable Voice Track metrics for high-volume outbound dialing to ensure your sales or support teams are maintaining optimal connectivity. To learn more advanced features that you can use with outbound contact centers, see [Voice outbound call center](/docs/voice/guides/outbound-call-center). ### Build AI agents with Twilio Programmable Voice Integrate call events with your AI workflows to trigger post-call analysis once a summary event is emitted. To learn more advanced features that you can use with AI agents, see [AI agents](/docs/voice/guides/ai-agents). ### Create transcriptions for AI or ML with Twilio Programmable Voice Use call completion and summary events to programmatically trigger the retrieval of transcriptions for machine learning model training. To learn more advanced features that you can use with AI or ML transcription, see [Voice AI/ML transcription](/docs/voice/guides/ai-ml-transcription). ## Next steps Explore the following guides to build on what you've learned in this guide: * [Create conference calls](/docs/voice/tutorials/how-to-create-conference-calls): Host multi-party calls and use Conference Insights to monitor them. * [Gather user input via keypad (DTMF Tones)](/docs/voice/tutorials/how-to-gather-user-input-via-keypad): Build interactive menus that generate gateway events. * [How to capture your first payment using ``](/docs/voice/tutorials/how-capture-your-first-payment-using-pay): Integrate secure payment processing into your voice workflows. ## Related reference documentation Find reference documentation for the topics on this page. * [Call Insights Event resource](/docs/voice/voice-insights/api/call/call-events-resource) * [Call Metric resource](/docs/voice/voice-insights/api/call/call-metrics-resource) * [Call Summary resource](/docs/voice/voice-insights/api/call/call-summary-resource) * [Details: Call Summary](/docs/voice/voice-insights/api/call/details-call-summary) * [Details: Voice Insights SDK Events](/docs/voice/voice-insights/api/call/details-sdk-call-quality-events) * [Conference Insights Event Stream](/docs/voice/voice-insights/event-streams/conference-insights-event)