Agent Skills
返回列表
💻

Twilio可编程短信网关

开发编程 更新于 2026.08.30

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

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_3c6cb52e/twilio-programmable-sms-gateway

技能介绍

要解决的问题

应用常需要在关键流程中触达用户：注册校验、登录二次确认、异常提醒和状态通知。短信和彩信仍然是覆盖面广、到达直接的通道，但自己对接 Twilio REST API 并不只是发一条请求：需要处理入站消息、绑定 webhook、跟踪投递状态，还要实现验证码生成与校验。如果把这些逻辑散落在业务代码里，很容易出现消息发送与状态回写脱节、OTP 流程重复造轮子等问题。这个技能把常见的 Twilio 短信能力整理成可复用的编程接口，让工程团队专注于业务规则。

核心能力与工作方式

技能围绕 Twilio REST API 提供 SMS/MMS 收发能力。发送流程通常由客户端凭据和发送方号码驱动，通过 messages 资源创建消息；入站消息则由 webhook handler 接收，解析 From、To、Body、MediaUrl 等字段后进入业务处理。消息调度允许先登记发送意图，再按业务时机触发；delivery status callbacks 会把回执状态写回，便于更新消息队列或用户通知状态。对于 OTP 场景，技能支持 Twilio Verify：先发起验证码校验请求，再通过 verification 与 verification-check 两类资源确认结果，避免自行实现验证码生成、存储和失效逻辑。

适用边界与注意点

使用前需要准备好 Twilio 账号、API 凭据、发送号码和接收 webhook 的可公网访问地址；webhook 不可达会导致入站消息丢失，回执回调配置错误会影响状态一致性。消息发送和 Verify 调用会产生 Twilio 侧费用，并且受地区和运营商策略影响。底层 twilio-node 采用修改版 Semantic Versioning，升级 API 时建议先确认兼容性。该技能解决的是消息通道与 OTP 通用逻辑，不替代业务侧的风控、限频、重试和审计设计。

使用场景

  • 用户注册时需要发送短信验证码完成身份校验，确保账户安全。
  • 订单状态变更时向用户推送短信通知，告知物流实时进展。
  • 用户登录环节通过短信验证码进行二次验证，防止非授权访问。
  • 客服系统需要接收用户发送的短信反馈，自动分类并生成工单。

适合人员

  • 后端开发者需要在应用中集成短信发送与验证功能，快速实现通信能力。
  • 运维工程师需要配置短信Webhook回调，确保消息状态实时同步。
  • 客服系统开发者需要处理用户回复的短信，构建自动响应流程。
  • 测试工程师需要验证短信消息的发送、接收与回执状态的准确性。