SuperAPI AI 工具集

twilio-taskrouter-routing

办公与效率

查看项目

更新于 10-15 23:57

技能介绍

用途:TaskRouter 是 Twilio 的基于技能的路由引擎,用于替代自建排队逻辑。流程为:任务进入 → Workflow 路由规则 → Task Queue 技能匹配 → Worker 坐席 → Reservation(接受/拒绝)。适合技能路由、队列管理与坐席分配场景。

主要能力:Workspace 作为顶层容器;Activity 定义坐席状态(Available/Offline/On Task);Worker 用 attributes 描述技能、语言、部门;Task Queue 用 target_workers 表达式筛选坐席;Workflow 用 filters 与 default_filter 定义路由与超时溢出;Task 携带 attributes 与 priority,优先级高者先分配;支持 AI 坐席升级时把摘要与客户画像写入任务属性。

使用方式:安装 SDK(pip install twilio 或 npm install twilio),配置 TWILIO_ACCOUNT_SID 与 TWILIO_AUTH_TOKEN。依次创建 Workspace、Activities、Workers、Task Queues、Workflow,再创建 Task。分配回调 assignment_callback_url 需在 5 秒内返回 dequeue 或 conference 指令。属性 JSON 必须用 json.dumps() 或 JSON.stringify() 构造,避免注入。

限制与陷阱:属性名含连字符会静默破坏表达式(用下划线);HAS 仅用于数组,字符串属性用 ==;表达式只做语法校验,语义错误不会报错;Activity 的 available 标志更新可能无效,需删除重建;multiTaskEnabled 一旦开启不可关闭;Reservation 超时会把坐席移到超时 Activity 并可能级联导致队列崩溃;Workflow 目标超时耗尽会取消任务,应始终设置 default_filter;创建任务必须指定 workflowSid;任务状态与属性不能同请求更新;分页用 PageToken;表达式不支持正则;每 Workspace 上限 50,000 Workers、250 Task Queues。