如何在MessageBird上以编程方式设置入站短信的webhook URL？

你可以直接调用MessageBird的电话号码配置接口完成设置，无需操作Flow Builder，该方案仅针对普通入站短信配置，不适用于会话（Conversations）功能的回调设置，具体操作步骤如下：

前置准备 #

你需要先从MessageBird控制台获取你的账号Live类型API访问密钥，测试密钥无法完成生产环境配置。

步骤1：获取目标电话号码的唯一ID #

首先调用账号电话号码查询接口，获取你要配置的、支持接收短信的已购号码对应的ID：

curl -H "Authorization: AccessKey 替换为你的Live API密钥" https://rest.messagebird.com/phone-numbers

在返回的JSON结果中找到目标号码对应的id字段值，留存备用。

步骤2：更新号码的入站短信回调配置 #

调用号码更新接口，填入你要设置的webhook地址即可：

curl -X PATCH \
  -H "Authorization: AccessKey 替换为你的Live API密钥" \
  -H "Content-Type: application/json" \
  https://rest.messagebird.com/phone-numbers/替换为步骤1拿到的号码ID \
  -d '{
    "features": {
      "sms": {
        "webhookUrl": "替换为你的公网可访问的HTTPS回调地址"
      }
    }
  }'

验证与注意事项 #

• 配置完成后可直接向目标号码发送测试短信，确认你的回调服务能接收到包含短信内容、发件人号码、接收时间等字段的POST请求
• 你的回调地址必须是公网可访问的HTTPS地址，本地localhost地址、未加密的HTTP地址均无法正常接收回调

如果你此前为该号码配置过Flow Builder入站短信流程，本次webhook配置会自动覆盖原有Flow Builder触发规则，入站短信将直接转发到你设置的回调地址，不再进入Flow Builder流程。

内容的提问来源于stack exchange，提问作者Yao Renaud Woana