无法通过Twilio WhatsApp API向沙箱外号码发送消息的问题

问题 #

我正在将Twilio WhatsApp API集成到Flask应用中以发送自动化消息。我可以向已通过join <given code>命令订阅沙箱的个人WhatsApp号码发送消息，但无法向其他号码发送。奇怪的是，控制台和Twilio调试器均未显示任何错误。

以下是Flask应用中/bot端点的代码片段，该端点用于处理入站消息并发送回复：

@app.route('/bot', methods=['POST'])
def bot():
    # ... [code to handle incoming messages] ...

    # Prepare the Twilio response
    twilio_response = MessagingResponse()
    twilio_response.message(latest_response)

    # ... [more code] ...

    # Attempt to send a message
    try:
        message = twilio_client.messages.create(
            body="Your appointment is coming up on July 21 at 3PM",
            from_="whatsapp:14155238886",  # This is the Twilio phone number
            to='whatsapp:+44074XXX'   # Trying to send to this number outside sandbox
        )
        print(f"Message sent to whatsapp:+44074XXX. Message SID: {message.sid}")
    except Exception as e:
        print(f"Error occurred: {e}")

    return str(twilio_response)

此/bot端点在收到WhatsApp的Webhook后触发，本应根据助手处理的消息发送回复，这在我的沙箱注册个人号码上运行正常：

twilio_response = MessagingResponse()
twilio_response.message(latest_response)

但使用twilio_client.messages.create向沙箱外号码发送消息时，虽无错误提示且控制台显示已创建消息（含Message SID），但消息未送达。请问我是否遗漏了额外步骤，或需要进行其他配置才能向Twilio沙箱外的号码发送消息？

解决方案 #

1. 升级到正式WhatsApp商业账户
   Twilio沙箱仅支持向主动发送join <code>订阅的号码发消息，这是测试阶段的限制。要向任意号码发送消息，必须：

   • 在Twilio控制台申请并激活正式的WhatsApp商业号码，或关联已有的WhatsApp Business账号
   • 完成对应地区的WhatsApp业务验证流程

2. 修正收件人号码格式
   你代码中的英国号码格式有误：国际格式下英国号码应去掉开头的0，正确格式应为whatsapp:+4474XXX，多余的0会导致消息路由失败。

3. 使用预审批模板发送主动消息
   根据WhatsApp规则，向未主动联系过你的号码发起消息时，必须使用WhatsApp预批准的消息模板，不能直接发送自定义文本。只有用户先给你发消息后，你才有24小时窗口发送非模板消息：

   • 在Twilio控制台创建并提交对应场景的消息模板（如预约提醒），等待WhatsApp审核通过
   • 发送时用template参数替代body，传入模板名称及所需变量

4. 查询消息状态排查问题
   即便有Message SID，也可以通过Twilio的消息状态Webhook或调用messages.get()接口查询具体状态（如undelivered、failed），定位具体失败原因。

内容的提问来源于stack exchange，提问作者Wardruna