# 短信服务提供商 Webhook

在您[连接短信服务提供商](/zh/developer/first-steps/connect-messaging-services/sms-configuration/)后，一些提供商需要在其端注册一个 Webhook URL，以便 Pushwoosh 能够接收送达回执、收到的回复或特定于渠道的事件（例如 Viber 订阅状态）。其他提供商则会在每条消息中自动提交此 URL，因此无需额外设置。

所有 Webhook 都在 `https://tw-callback.svc-nue.pushwoosh.com/api/v1/...` 接收。如果 URL 包含 `{APP_CODE}`，请将其替换为您的 [Pushwoosh application code](/zh/developer/api-reference/api-identifiers/#application-code)（**Settings → Applications**）。

## 自动设置

对于这些提供商，Pushwoosh 会在每条消息中自动提交回调 URL。提供商方面无需任何操作。

*   **Twilio：** 送达状态会随每条消息自动提交。要同时接收回复（双向短信），请在 Twilio Console 中将您的 Twilio 电话号码的 **"A message comes in"** Webhook 设置为：

    ```
    https://tw-callback.svc-nue.pushwoosh.com/api/v1/smsCallback/{APP_CODE}
    ```

*   **SMSGlobal：** 送达和接收 URL 都会随每条消息自动提交。
*   **SMSAla：** 送达 URL 会随每条消息自动提交。SMSAla 不支持接收短信。

## 需要手动设置

对于这些提供商，请在提供商自己的控制面板中注册一次 Webhook URL。

| 提供商 <div style="width:120px"></div> | 事件 <div style="width:140px"></div> | 方法 <div style="width:90px"></div> | URL <div style="width:280px"></div> |
|---|---|---|---|
| MStat | Delivery | POST | `.../mstatCallback` |
| MStat | Incoming | POST | `.../mstatIncoming/{APP_CODE}` |
| MStat | Viber subscription | POST | `.../mstatViberSubscription/{APP_CODE}` |
| Amazon SNS | Delivery | POST | `.../awsSmsCallback` |
| CapitoleMobile | Delivery | GET | `.../capitoleMobileCallback` |
| CapitoleMobile | Incoming | GET | `.../capitoleMobileIncoming/{APP_CODE}` |
| AbleMobile | Delivery | GET / POST | `.../amSmsCallback` |
| SMSTraffic | Delivery | POST | `.../smsTrafficCallback` |
| TextMe.co.il | Delivery | GET | `.../textMeCoilCallback` |
| TextMe.co.il | Incoming | GET | `.../textMeCoilCallback/{APP_CODE}` |

上述每个 URL 都是相对于 `https://tw-callback.svc-nue.pushwoosh.com/api/v1` 的。

<Aside type="note" title="Amazon SNS">
送达回执通过 SNS 主题订阅送达，而不是通过每条消息的参数。

1. 在 **AWS Console** 中，为您的短信送达状态主题添加一个 HTTPS 订阅。使用上表中的 `awsSmsCallback` URL。
2. 当 AWS 发送 `SubscriptionConfirmation` 请求时，在 AWS Console 的待处理订阅下找到 `SubscribeURL`。
3. 打开该 URL 以确认订阅。

在您确认订阅之前，Pushwoosh 不会收到送达回执。
</Aside>

## 不支持 Webhook

**Mobipace** 和 **SMSCenter** 不会向 Pushwoosh 发送送达或接收 Webhook。这些提供商无法也无需进行设置。