Agent Skills
返回列表
💻

Twilio 短信与语音桥接

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3c6cb52e/twilio-sms-voice-bridge

技能介绍

要解决的问题

把短信收发、语音呼叫和回调处理接进现有后端时,通常会被三件事卡住:twilio-node 的 API 层级(Client、Message、Call、TwiML)要先理顺;消息状态与用户回复要落到同一个会话里;语音场景还要生成合法的 TwiML 文档并把 Webhook 接对。手动拼这些,容易在签名验证、回调字段和会话线程上反复踩坑。

技能如何工作

  • 通过 twilio-node SDK 的 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 安装并跑通测试用例。