SuperAPI AI 工具集

twilio-conversations

办公与效率

查看项目

更新于 10-16 05:00

技能介绍

用途:在 OpenClaw 中实现并运营 Twilio Conversations,跨 SMS、WhatsApp 和应用内聊天构建统一的“会话线程”抽象,统一管理参与者与消息,并接入 Webhook 处理投递、已读、失败等状态。

主要能力:创建/管理会话(含 uniqueName、attributes、state、timers);添加聊天(identity)、短信(messagingBinding.address + proxyAddress)与 WhatsApp(whatsapp:+E164)参与者;发送带 author、body、attributes 的消息并跟踪投递;通过 Webhook 摄取事件,支持签名校验、幂等去重与重试;结合 Messaging Services 做地理匹配、粘性发送与成本控制;处理 STOP/START/HELP 退订合规;可与 Voice、Verify、Studio、SendGrid 组合。

使用方式:需启用 Conversations 的 Twilio 账号、可用的短信号码或 WhatsApp 发送方、公网 HTTPS Webhook 端点(本地可用 ngrok/cloudflared)。推荐使用 API Key(TWILIO_ACCOUNT_SID、TWILIO_API_KEY_SID、TWILIO_API_KEY_SECRET)。安装示例:pip install twilio;npm install twilio@4.23.0 express@4.18.3 body-parser@1.20.2。REST 基址为 https://conversations.twilio.com/v1,可用 curl 或 Node/Python SDK 调用。Webhook 需校验 X-Twilio-Signature,5 秒内响应并异步入队,按 EventSid 去重。

适用场景:跨渠道客服会话、统一消息线程、Webhook 驱动的状态同步与合规退订管理。

限制:需自行处理限流、分页、幂等与合规;美国 A2P 需 10DLC 注册,WhatsApp 需遵循模板规则;具体价格、平台支持与部分 API 字段以官方文档为准,资料未提供的内容暂未说明。