如何模拟TaskRouter的task.system-deleted事件及配置事件TTL？

1. 模拟"task.system-deleted"事件的方法 #

Twilio官方没有提供直接模拟这个系统删除事件的工具，该事件是TaskRouter在任务超过保留期限被系统自动删除时才会触发的原生事件。如果要测试你的webhook对该事件的处理逻辑，可以手动构造符合格式的HTTP请求发送到你的webhook端点：

• 构造POST请求，将Content-Type设为application/x-www-form-urlencoded或application/json
• Payload需包含核心字段：
  • EventType: task.system-deleted
  • TaskSid: 目标任务的SID
  • WorkspaceSid: 对应工作区的SID
  • 其他任务相关属性（如TaskAge、Attributes等）可根据测试需求补充

你可以用Postman、curl这类工具发送模拟请求，只要payload结构和Twilio实际发送的事件一致即可。

2. 事件TTL的配置位置 #

TaskRouter中任务被系统删除的触发条件（间接关联事件的产生时机），是通过工作区的任务保留时长来配置的：

• 登录Twilio控制台，进入目标TaskRouter工作区
• 在工作区的"Settings"页面，找到"Task Retention"选项，设置任务保留的天数（范围1到365天）
• 当任务超过设置的保留时长且未被手动处理时，系统会自动删除该任务并触发task.system-deleted事件

至于事件本身的存储TTL，Twilio默认会保留TaskRouter事件13个月，这个时长目前无法通过控制台或API自定义修改，官方文档未提及可配置项是因为该参数属于平台级默认设置，暂不支持用户调整。

内容的提问来源于stack exchange，提问作者André Luiz