Event Streams is an API that allows you to tap into a unified stream of every interaction sent or received on Twilio. With Event Streams, you can:
Stream your data to your existing systems by configuring a modern, persistent streaming technology like
Amazon Kinesis
. You can also send events to
Segment
or webhooks.
Consume and leverage data from multiple Twilio products with consistent metadata, well-defined and versioned schemas, and control over which events you want delivered (starting with Messaging, Voice, and TaskRouter events, with all events coming soon).
Trust that your events will be queued if your system goes down and delivered as soon as it's back up, with event queuing for up to 4 hours.
Learn more about the API resources
Event Streams evolves event delivery at Twilio beyond a single-producer-to-single-consumer model, giving developers flexibility to stream events to multiple sinks.
To build with Event Streams, you'll use the following API resources:
Event Types
— The various kinds of events that are accessible through the Event Streams APIs.
Sinks
— The destinations to which the events you've subscribed to will be delivered.
Subscriptions
— Subscribe to specific Twilio events and versions.
Schemas
— Every Event Type has a Schema which defines how information is organized within events.
The Amazon Kinesis Quickstart, Webhook Quickstart and Segment Quickstart pages can help you get started with the Event Streams API. Helper libraries are also available for popular programming languages to help you quickly integrate Event Streams.
Considerations
Please be aware of the following aspects / limitations of Event Streams:
Events will be queued for a maximum of 4 hours.
Up to 100 Sinks and 100 Subscriptions per account. If you have subaccounts, each subaccount will have a limit of 100 Sinks and Subscriptions.
Event Streams is additive and will not replace existing webhooks. Twilio will continue to support and develop existing webhooks for TwiML use cases and for customers who prefer per-channel integrations.
Logging and retention
The maximum retention period for application logs through Event Streams will be seven days.
The maximum retention period for error logs will be 23 days at the account level.