需改用twilio verify服务替代messaging api实现短信验证码发送与校验:先调用twilio_verify_start发送验证码并获取verification_sid,再用twilio_verify_check校验用户输入,通过条件判断分支处理成功或失败结果。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

在Dify中集成Twilio API实现短信验证码的发送与校验,需绕过Dify原生不支持HTTP请求的限制,通过自定义工具(Custom Tool)调用外部服务,并在工作流中串联发送、存储、比对三步逻辑。
准备Twilio账号与API凭证
登录Twilio控制台,进入Account Dashboard,复制【Account SID】和【Auth Token】;在左侧导航栏点击“Phone Numbers”→“Manage”→“Active Numbers”,确认已购买并启用一个可发短信的电话号码(如+1415xxx0000),该号码将作为发信号码填入后续请求。
注意:免费试用账户只能向已验证的手机号发送短信,务必提前在“Verified Caller IDs”中添加并验证目标测试手机号,否则发送会静默失败且无报错提示。
在Dify中创建自定义工具(Custom Tool)
进入Dify后台 → “知识库与工具” → “自定义工具” → “创建工具”,填写以下字段:
名称:twilio_send_otp
描述:调用Twilio REST API向指定手机号发送6位数字验证码
Schema(JSON格式):{ "type": "object", "properties": { "to_phone": { "type": "string", "description": "接收短信的手机号,E.164格式,例如+8613800138000" }, "code": { "type": "string", "description": "6位纯数字验证码,若为空则由Twilio生成随机码" } }, "required": ["to_phone"] }
API URL填写:https://api.twilio.com/2010-04-01/Accounts/{account_sid}/Messages.json({account_sid}需替换为你的真实Account SID)
请求方法:POST
认证方式:Basic Auth → 用户名填Account SID,密码填Auth Token
请求体(Body)选择“form-data”,添加三项键值:
• To → {{to_phone}}
• From → 你Twilio上购买的发信号码(E.164格式,如+1415xxx0000)
• Body → 验证码{{code}},请勿添加其他文字或链接——Twilio对短信内容有严格审核,含URL或“验证码”以外敏感词可能触发拦截。
构建Dify工作流实现发送+校验闭环
第一步:在应用编排画布中添加“开始节点”,连接至“自定义工具”节点,选择刚创建的twilio_send_otp工具;配置输入参数时,to_phone绑定用户输入的手机号(如从表单提取),code字段留空——让Twilio自动生成6位随机码并返回响应体中的sid字段。
第二步:添加“变量赋值”节点,从上一步工具响应中提取code值。Twilio返回的JSON里不直接含code,需改用Twilio的Verify服务替代Messaging API——这是关键修正点:【Messaging API无法返回验证码,必须切换为Verify服务】。因此需删除当前工具,重新创建名为twilio_verify_start的工具,API URL改为https://verify.twilio.com/v2/Services/{service_sid}/Verifications,Body中设置channel=sms,to=+86138...,method=SMS;响应体中会返回status=queued及verification_sid。
第三步:用户提交验证码后,触发第二个工具twilio_verify_check,API URL为https://verify.twilio.com/v2/Services/{service_sid}/VerificationCheck,Body传verification_sid和code;成功响应中status=approved即校验通过。
第四步:将twilio_verify_check的输出接入“条件判断”节点,当status == "approved"时走“是”分支跳转至成功页面,否则走“否”分支返回错误提示。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!











