Twilio 短信与语音桥接
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3c6cb52e/twilio-sms-voice-bridge
技能介绍
要解决的问题
把短信收发、语音呼叫和回调处理接进现有后端时,通常会被三件事卡住:twilio-node 的 API 层级(Client、Message、Call、TwiML)要先理顺;消息状态与用户回复要落到同一个会话里;语音场景还要生成合法的 TwiML 文档并把 Webhook 接对。手动拼这些,容易在签名验证、回调字段和会话线程上反复踩坑。
技能如何工作
- 通过
twilio-nodeSDK 的 client 直接调用 REST 能力,短信发送集中在client.messages.create()上,参数与返回结构保持一致。 - 语音部分用 TwiML 的
VoiceResponse构造 IVR 流程,把接听后的分支(菜单、转接、挂断)写成可复用的文档片段。 - 投递回调统一在 Webhook 层处理,既能跟踪 message status,也能把连续回复串成同一条 conversation thread。
- 仓库自带测试入口,可用
npm test或npm run test:javascript -- -m .\*client.\*按客户端匹配跑相关用例;初始验证时给自己发一条 SMS,确认链路可用。
适用边界与注意点
twilio-node使用经过修改的 Semantic Versioning,版本号不能按标准 semver 直接推断兼容性,升级前要读变更说明。- 文档抽取自上游 README 与示例仓库,SDK 版本与 Twilio 控制台能力之间可能存在滞后,实际字段以当前 REST API 为准。
- 短信、语音和 Webhook 都依赖外部账号、签名验证和网络可达,技能只覆盖调用与处理逻辑,不包含账号配置与安全策略。
- 适合需要把通信能力嵌进自有服务的工程团队;纯前端展示或一次性群发场景不是它的目标。
使用场景
- 客服系统需要自动发送验证码短信并处理用户回复。
- 电话热线需生成 TwiML 菜单实现按按键转接的 IVR。
- 消息队列要消费 Twilio 回调以更新短信投递状态。
- 多轮短信对话需把用户回复串成同一会话线程。
适合人员
- 后端工程师,要在服务端集成 Twilio 短信与语音能力。
- 全栈开发者,需用 TwiML 搭建可接电话的 IVR 流程。
- 平台工程师,负责处理消息投递回调与状态持久化。
- 运维工程师,需要验证 SDK 安装并跑通测试用例。