SuperAPI AI 工具集

twilio-conversations-classic-api

编程与开发

查看项目

更新于 10-15 23:41

技能介绍

用途:该技能围绕 Twilio Conversations (classic) API(v1)构建多渠道消息体验,可将 SMS、WhatsApp 与网页/移动聊天参与者放入同一持久会话线程,与单条消息 API 不同,它会保留历史并支持多客服接入。

主要能力:创建 Conversation Service(用于 SMS/WhatsApp 参与者);创建会话、添加参与者(SMS/WhatsApp 通过 messaging_binding_address 与 messaging_binding_proxy_address,聊天通过 identity);发送文本与媒体消息,媒体需公网可访问 URL,支持 JPG、PNG、GIF、PDF、vCard,每条最多 10 个 URL;列出会话并按 state 过滤;读取消息历史(如 limit=50);按 SID 或号码移除参与者;关闭(state="closed")或删除会话;在会话与参与者上存储自定义属性元数据;通过全局 Webhook 处理入站消息与投递状态(onMessageAdded、onMessageUpdated、onDeliveryUpdated,状态值 sent、delivered、failed、undelivered)。

使用方式:需 Twilio 账户并启用 Conversations (classic),配置 TWILIO_ACCOUNT_SID、TWILIO_AUTH_TOKEN 环境变量,安装 SDK(pip install twilio / npm install twilio)。SMS/WhatsApp 参与者需将 Twilio 号码分配到 Conversations Service,并在控制台添加号码。Webhook 需在 Console > Conversations > Manage > Global Webhooks 配置;生产环境应校验 X-Twilio-Signature 请求头。示例代码覆盖 Python 与 Node.js。

限制:每会话最多 1,000 名参与者;消息数量不限但较旧消息可能被归档;保留期可配置,默认无限期。无 Twilio 号码无法添加 SMS 参与者;WhatsApp 受 24 小时服务窗口限制;聊天参与者需 Access Token 进行客户端 SDK 鉴权;WhatsApp Groups API 已于 2020 年 4 月弃用;v1 (classic) 处于维护模式,新项目可考虑 Conversations v2 API。费用、价格与具体平台细节资料未提供。