SuperAPI AI 工具集

twilio-verify

办公与效率

查看项目

更新于 10-15 19:55

技能介绍

用途:在 OpenClaw 中集成并运营 Twilio Verify (V2),构建可靠的验证流程(发送→校验→执行),覆盖短信/语音/邮件一次性验证码、TOTP、自定义渠道、电话验证、Fraud Guard 风险评分与拦截,以及区域/运营商支持情况下的静默网络验证(SNA)。

主要能力:以 Verify Service(VA...)为策略边界,配置渠道、码长、模板、TTL、限流、Fraud Guard 与 webhook;创建 Verification 发送验证码,创建 Verification Check 校验用户输入;支持 sms、call、email、totp、whatsapp、custom 等渠道;结合 Messaging/Voice、SendGrid 与状态回调;处理运营商过滤、无效 E.164、鉴权错误、限流等失败模式;支持成本控制、区域路由、幂等与防滥用。

使用方式:需要 Twilio 账户(Account SID 与 Auth Token,或 API Key + Secret)及 Console 中创建的 Verify Service SID;短信/语音需 Messaging Service 或号码,美国 A2P 需完成 10DLC 注册,邮件渠道需 SendGrid 与已验证发件域,SNA 可用性取决于区域/运营商与 Twilio 开通。安装依赖:Node.js 20.11.1 或 18.19.1、Python 3.12.2(可选)、twilio npm 4.22.0、twilio Python 9.0.5、curl 8.5.0、jq 1.7。建议用 API Key 鉴权并将密钥存入密钥管理,禁止提交仓库。

REST 调用:POST https://verify.twilio.com/v2/Services/{ServiceSid}/Verifications(字段 To、Channel、Locale 等);POST https://verify.twilio.com/v2/Services/{ServiceSid}/VerificationCheck(字段 To、Code);可列出、按 SID 获取或取消验证。Node 初始化:twilio(apiKeySid, apiKeySecret, { accountSid, region, edge, logLevel })。

适用场景:消费级登录默认短信,语音作为回退,邮件用于账号找回,TOTP 用于高保障账户,自定义渠道用于已有推送基础设施。

限制:SNA 非普遍可用,需回退 OTP;号码须为 E.164(如 +14155552671),应先归一化校验;应用侧应叠加限流、冷却、CAPTCHA 与风控;webhook 需幂等、验签、可重试;TOTP 端点可用性依赖账户权限;具体价格、速率上限与区域开通情况暂未提供。