Twilio - Events logo

Twilio - Events

Twilio - Events

Twilio Events 把 Twilio 平台事件(消息送达、通话状态变化、配额告警)以统一 webhook 流式推送,避免单 endpoint 散落配置。

访问站点 ↗健康巡检 9 小时前
适合什么时候用

替代散落在各资源上的 statusCallback URL

先注意什么

不能替代 inbound 消息 webhook(仍要在 phone number 配置 SmsUrl)

第一步先查

POST /Sinks 创建 webhook 接收端,POST /Subscriptions 订阅事件类型并绑定 sink。Twilio 会异步把匹配事件 POST 到你的 URL。

认证
CORS
不支持
HTTPS
注册
?
延迟
177 ms
协议
REST, Webhook
计费

可用率 · 30 天窗口

巡检: 1可用率: 100%平均延迟: 177ms
01

关于这个 API

Events API 是 Twilio 2021 年引入的事件总线,目的是替代散落在各产品里的 statusCallback 配置(每个 phone number、每个 Conversation、每个 Studio Flow 都要单独配 webhook URL,运维很痛苦)。用 Events,你只要在账户级别创建 Sink(指向你的 webhook URL),订阅感兴趣的事件类型(message.delivered、call.completed、limits.usage_threshold 等),Twilio 就会统一把事件流推过来。还支持把 Sink 类型设为 Segment 或 AWS Kinesis 做直接灌入。对监控、合规审计、和 CRM 集成都是必备。

02

你可以做什么

  • 1统一接收所有 Twilio 事件做监控/告警
  • 2把事件流灌入 Kafka 做下游分析
  • 3消息送达状态同步到 CRM
  • 4配额接近时收到提前告警
03

优劣对比

优点

  • 替代散落在各资源上的 statusCallback URL
  • 订阅维度细——可以只订阅 message.delivered 不订阅 message.sent
  • 支持事件重放(最多 4 小时)

注意事项

  • 不能替代 inbound 消息 webhook(仍要在 phone number 配置 SmsUrl)
  • Sink 一旦失败超过重试次数事件会丢失
04

示例请求

通用模板 — 实际 endpoint 请查阅文档替换 <endpoint>。
curl https://support.twilio.com/<endpoint>
05

快速开始

POST /Sinks 创建 webhook 接收端,POST /Subscriptions 订阅事件类型并绑定 sink。Twilio 会异步把匹配事件 POST 到你的 URL。

06

常见问题

Events 能完全替代 statusCallback 吗?+

inbound 还需要 statusCallback。outbound 状态(sent/delivered/failed)可以完全交给 Events。

事件丢失了能补发吗?+

4 小时内可以用 Replay API 重新拉取。超出窗口需要从 Twilio Insights 或 Bulk Exports 重建。

推送频率有上限吗?+

Twilio 对每个 sink 限速 100 events/s。超出会降级到 4 小时 replay 队列。

07

技术细节

CORS: NoHTTPS: Yes注册: ?开源: No
认证方式
unknown
计费
unknown
协议
REST, Webhook
SDK
python, javascript, java, ruby, php, csharp, go
响应时间
177 ms
上次巡检
2026/5/12 07:38:32
08

标签

09

更多来自 Twilio 的 API