
Webhook V2 — インスタントアクションですべてのモバイルイベントをオンにします
SMSMobileAPI Webhookシステムの主な進化である**Webhook V2**を導入しています。
これまで、Webhooks は主に SMS のメッセージの受信に焦点を合わせていました。 Webhook V2 では、SMSMobileAPI は、完全な **event 主導のモバイル通信プラットフォーム** になります。これにより、アプリケーションが SMS、呼び出し、WhatsApp メッセージ、音声の転写、および電子メールのアクティビティに自動的に反応することができます。
APIを繰り返してポーリングする代わりに、変更した内容を確認するために、アプリケーションは、サポートされたアクティビティが発生した直後に自動的に構造化されたHTTPSイベントを受信できるようになりました。
### 15 個の webhook イベントタイプ
Webhook V2は、SMSMobileAPIで利用可能な主要な通信チャネルをカバーする正確なイベント名を紹介します。
**SMS** の
* `sms.api.submitted` — SMS 送信リクエストは、API を通じて送信されました。
* `sms.sent` — 接続されたモバイルは、SMS が送信されたことを確認しました。
* `sms.failed` — SMS 送信動作に失敗しました。
* `sms.received` — SMS の新しい着信は同期されました。
* `sms.mobile.sent — 接続されたモバイルから手動でSMSが送信されました。
**コール**
* `call.missed` — 見逃されたコールが検出されました。
* `call.incoming` — 着信コールが同期されました。
* `コール.アウトゴング` — 発信電話が同期されました。
**WhatsApp** 仕様
* `whatsapp.submitted — WhatsApp 送信ジョブが作成されました。
* `whatsapp.sent` — WhatsApp のメッセージが正常に送信されました。
* `whatsapp.failed` — WhatsApp 送信動作に失敗しました。
* `whatsapp.received` — 新しい WhatsApp メッセージが取得されました。
* `whatsapp.voice.transcribed` — WhatsApp ボイスメッセージがテキストに変換されました。
**電子メール**
* `email.sent` — リクエストを送信するためのメールが作成されました。
* `email.received` — 接続されたメールボックスが新しいメールを受信しました。
### 複数のWebhookの宛先
シングルのWebhookエンドポイントに制限はありません。
Webhook V2は、**複数の独立した目的地を作成することができます** そして、各目的地が受け取るべきイベントを正確に決定します。
例えば、次のコマンドを送信できます。
* SMS と WhatsApp のメッセージを CRM にインカムします。
* カスタマーサポートシステムへの電話が欠かせません。
* SMS と WhatsApp の送信が監視プラットフォームに失敗しました。
* 分析システムへの通信イベント。
* 独自の自動化やAIワークフローにイベントを選択
各目的地は独立して運営しています。
### 選択イベントルーティング
必要なイベントのみを購読できるWebhookの宛先は、すべてのWebhookの宛先です。
これにより、アプリケーションが不要なイベントを受信しないように、統合がクリーナーになり、アプリケーションが不要なイベントを受信するのを防ぎます。
CRMは、以下の手順でのみ購読できます。
`sms.received` のリリース
`コール.従った
`whatsapp.received(whatsapp.received) のリリース
運用監視システムが、次の機能だけを購読できる。
`ツムス.failed`
`whatsapp.failed(ファイルド)
### 信頼できる非同期配達
Webhook V2は**耐久性のある配達キューを使用しています**。
配信や非同期処理の前にイベントが保存されます。つまり、SMSMobileAPI ワークフローは、サードパーティのサーバーが応答するのを待つ必要はありません。
一方の目的地が遅くても利用できなくなった場合、他の目的地や他のアカウントをブロックしません。
### 自動レトリー
一時的なエンドポイントの不具合は、プログレッシブ遅延により自動的に取得されます。
Webhook V2は**at-least-once Delivery**を利用しているため、イベントは一度以上配信される場合があります。
そのため、アプリケーションが重複処理を防止するために、不利なキーとして保存して使用できる安定したイベント識別子が含まれています。
### 署名と検証可能なWebhookリクエスト
Webhook V2の重要な部分は保証です。
各Webhookリクエストには、サーバーがSMSMobileAPIから発信されたリクエストを正当に検証できるようにする情報が含まれます。
リクエストには以下が含まれます:
* イベントタイプ
* 配達 ide
もっと詳しく知る→これまで、Webhooks は主に SMS のメッセージの受信に焦点を合わせていました。 Webhook V2 では、SMSMobileAPI は、完全な **event 主導のモバイル通信プラットフォーム** になります。これにより、アプリケーションが SMS、呼び出し、WhatsApp メッセージ、音声の転写、および電子メールのアクティビティに自動的に反応することができます。
APIを繰り返してポーリングする代わりに、変更した内容を確認するために、アプリケーションは、サポートされたアクティビティが発生した直後に自動的に構造化されたHTTPSイベントを受信できるようになりました。
### 15 個の webhook イベントタイプ
Webhook V2は、SMSMobileAPIで利用可能な主要な通信チャネルをカバーする正確なイベント名を紹介します。
**SMS** の
* `sms.api.submitted` — SMS 送信リクエストは、API を通じて送信されました。
* `sms.sent` — 接続されたモバイルは、SMS が送信されたことを確認しました。
* `sms.failed` — SMS 送信動作に失敗しました。
* `sms.received` — SMS の新しい着信は同期されました。
* `sms.mobile.sent — 接続されたモバイルから手動でSMSが送信されました。
**コール**
* `call.missed` — 見逃されたコールが検出されました。
* `call.incoming` — 着信コールが同期されました。
* `コール.アウトゴング` — 発信電話が同期されました。
**WhatsApp** 仕様
* `whatsapp.submitted — WhatsApp 送信ジョブが作成されました。
* `whatsapp.sent` — WhatsApp のメッセージが正常に送信されました。
* `whatsapp.failed` — WhatsApp 送信動作に失敗しました。
* `whatsapp.received` — 新しい WhatsApp メッセージが取得されました。
* `whatsapp.voice.transcribed` — WhatsApp ボイスメッセージがテキストに変換されました。
**電子メール**
* `email.sent` — リクエストを送信するためのメールが作成されました。
* `email.received` — 接続されたメールボックスが新しいメールを受信しました。
### 複数のWebhookの宛先
シングルのWebhookエンドポイントに制限はありません。
Webhook V2は、**複数の独立した目的地を作成することができます** そして、各目的地が受け取るべきイベントを正確に決定します。
例えば、次のコマンドを送信できます。
* SMS と WhatsApp のメッセージを CRM にインカムします。
* カスタマーサポートシステムへの電話が欠かせません。
* SMS と WhatsApp の送信が監視プラットフォームに失敗しました。
* 分析システムへの通信イベント。
* 独自の自動化やAIワークフローにイベントを選択
各目的地は独立して運営しています。
### 選択イベントルーティング
必要なイベントのみを購読できるWebhookの宛先は、すべてのWebhookの宛先です。
これにより、アプリケーションが不要なイベントを受信しないように、統合がクリーナーになり、アプリケーションが不要なイベントを受信するのを防ぎます。
CRMは、以下の手順でのみ購読できます。
`sms.received` のリリース
`コール.従った
`whatsapp.received(whatsapp.received) のリリース
運用監視システムが、次の機能だけを購読できる。
`ツムス.failed`
`whatsapp.failed(ファイルド)
### 信頼できる非同期配達
Webhook V2は**耐久性のある配達キューを使用しています**。
配信や非同期処理の前にイベントが保存されます。つまり、SMSMobileAPI ワークフローは、サードパーティのサーバーが応答するのを待つ必要はありません。
一方の目的地が遅くても利用できなくなった場合、他の目的地や他のアカウントをブロックしません。
### 自動レトリー
一時的なエンドポイントの不具合は、プログレッシブ遅延により自動的に取得されます。
Webhook V2は**at-least-once Delivery**を利用しているため、イベントは一度以上配信される場合があります。
そのため、アプリケーションが重複処理を防止するために、不利なキーとして保存して使用できる安定したイベント識別子が含まれています。
### 署名と検証可能なWebhookリクエスト
Webhook V2の重要な部分は保証です。
各Webhookリクエストには、サーバーがSMSMobileAPIから発信されたリクエストを正当に検証できるようにする情報が含まれます。
リクエストには以下が含まれます:
* イベントタイプ
* 配達 ide



