SMS、通話、WhatsApp、メールを正確なイベント名でカバーします。
WEBHOOK V2 · すべてのモバイルイベントをあなたのソフトウェアへ配信
接続されたモバイルからのすべてのイベントを即時アクションに変えます。
SMSMobileAPI Webhook V2 は、SMS が提出、送信、失敗、受信されたとき、モバイル通話が不在着信、着信、発信になったとき、また対応する WhatsApp やメールのアクティビティが発生したときに、構造化された HTTPS イベントをアプリケーションへ送信します。ダッシュボード上で視覚的にすべてを設定でき、ポーリングループは不要です。
API のドキュメントを読む各デスティネーションが受け取るイベントを選択します。1つのワークスペースからテスト、停止、監視、署名シークレットのローテーションを行えます。
SMS通話ワタワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワワメール
署名付きの JSON
SMSMobileAPIWebhookV2永続的なイベントキュー
ライブ
HTTPS POST
マーケティングサポート自動化分析
異なるイベントグループを異なる HTTPS デスティネーションへ送信します。
各リクエストを HMAC-SHA256 の署名とタイムスタンプで検証します。
一時的なデスティネーションの障害は、他のアカウントをブロックすることなく再試行されます。
WEBHOOK V2 の仕組み
実際のモバイルイベントからアプリケーションへ、3つの明確なステップで。
接続されたモバイルと SMSMobileAPI サービスが運用イベントを生成します。Webhook V2 は各該当イベントを永続的な配信キューに入れ、選択した HTTPS URL に署名付きの JSON ペイロードを送信します。
- 1
イベントが発生
メッセージが提出される、モバイルが SMS を送受信する、通話が状態を変更する、または対応する WhatsApp とメールのアクティビティが記録されます。
- 2
Webhook V2 がルーティングします
SMSMobileAPI は一意で安定したイベントIDを生成し、そのイベントタイプを購読しているデスティネーション向けにのみ配信をキューします。
- 3
ソフトウェアが反応
公開された HTTPS エンドポイントが署名を検証し、イベントIDを保存して、CRM、サポート、アラート、または自動化ワークフローを開始します。
15の正確なイベントタイプ
ワークフローに必要なモバイルイベントだけを購読してください。
1つのデスティネーションがすべて受け取ることも、プロダクション、分析、運用アラートを分離することもできます。すべてのイベントには正確な名前が付いており、アプリケーションは予測可能に処理できます。
SMS
5sms.api.submittedAPI を経由して提出された SMS
API リクエストが SMS 送信ジョブを作成しました。リクエストがプラットフォームに到達したことを確認するのに役立ちます。
sms.sentSMS が送信済み
接続されたモバイルが SMS の送信操作を確認しました。
sms.failedSMS が失敗
接続されたモバイル端末から SMS の送信エラーが返されました。
sms.receivedSMS を受信
接続されたモバイル端末が着信の SMS を同期しました。
sms.mobile.sentモバイルから送信された SMS
接続されたモバイルから手動で SMS が送信されました。
通話
3call.missed不在着信
接続されたモバイルから不在着信が同期されました。
call.incoming着信
接続されたモバイルから着信が同期されました。
call.outgoing発信
接続されたモバイルから発信通話が同期されました。
whatsapp.submittedWhatsApp が送信申請されました
WhatsApp の送信ジョブが作成されました。
whatsapp.sentWhatsApp が送信されました。
接続された WhatsApp 環境がメッセージの送信を確認しました。
whatsapp.failedWhatsApp の送信に失敗しました。
WhatsApp の送信操作が失敗しました。
whatsapp.receivedWhatsApp を受信
アカウントが同期を要求した後、WhatsApp メッセージが取得されました。
whatsapp.voice.transcribed音声メッセージの文字起こし
取得された対象の WhatsApp 音声メッセージが利用可能なテキストに変換されました。
メール
2email.sentメールが送信されました。
SMSMobileAPI によってメール送信リクエストが作成されました。
email.receivedメールを受信
接続されたメールボックスがメールを受信しました。
視覚的にすべてを設定
設定ファイルを編集せずに利用できる、本格的なWebhook管理。
SMSMobileAPI ダッシュボードで Webhook V2 を開き、配信先名と公開 HTTPS URL を追加し、イベントを選択して保存します。ダッシュボードは日常運用とトラブルシューティングに必要なコントロールを提供します。
複数の配信先
CRM、監視、分析、顧客向けアプリケーション向けに専用の配信先を作成できます。
イベントフィルター
各 URL が受信する SMS、通話、WhatsApp、メールのイベントを正確に選択できます。
配信テスト
本番で配信先を利用する前に、制御されたテストイベントを送信してください。
一時停止と再開
設定を削除せずに、配信先を即座に停止できます。
シークレットのローテーション
セキュリティポリシーに応じて、新しい署名用シークレットを生成できます。
配信状況
キュー、配信済み、再試行中、失敗した配信の詳細を、試行回数と HTTP ステータス情報とともに確認できます。
Webhook V23 件アクティブ
CRM（本番環境）
https://crm.example.com/hooks/mobileアクティブsms.receivedcall.missedwhatsapp.received
運用アラート
https://ops.example.com/eventsアクティブsms.failedwhatsapp.failed
信頼性を重視した設計
信頼性の高い、独立した配信のために設計されています。
Webhookの配信は非同期です。モバイルワークフローはサードパーティの URL の応答を待たず、ある宛先の障害が他の顧客や宛先の配信を妨げることはありません。
永続キュー
配信前に対象イベントを保存するため、受信側の一時的なダウンタイムでもイベントが失われません。
少なくとも1回の配信保証
配信は再試行される可能性があります。イベントIDを保存し、自アプリケーション内で一度だけ処理してください。
段階的な再試行
一時的な障害は遅延を増加させながら再試行され、プラットフォームの再試行上限に達するまで続けられます。
障害の隔離
遅い、または利用不可のエンドポイントが、無関係な宛先への配信を停止させることはありません。
自動保護
継続的に失敗している宛先は、キューとインフラを保護するために一時停止できます。
運用の可視性
ダッシュボードとウェブマスター監視で、キューの状態、結果、最近の配信エラーを確認できます。
署名済み・検証可能
イベントを信用する前にリクエストを検証してください。
各配信にはタイムスタンプ、配信識別子、イベントタイプ、安定した冪等性キー、及びHMAC-SHA256署名が含まれます。署名用のシークレットはサーバー上で管理し、署名はリクエストの生ボディから算出して、不正または古いリクエストは拒否してください。
X-SMSMobileAPI-Eventsms.received のようなイベントタイプ。X-SMSMobileAPI-Deliveryこの宛先に対する一意の配信識別子。X-SMSMobileAPI-Timestamp署名検証で使用されるUnixタイムスタンプ。X-SMSMobileAPI-Signature安全に比較するためのHMAC-SHA256署名。Idempotency-Key重複処理を防ぐために使用される安定したイベントUUID。一貫したイベントエンベロープ
すべてのチャネルに対して一貫したJSONエンベロープを提供します。
エンベロープはSMS、通話、WhatsApp、メールを通して予測可能な構造を維持します。dataオブジェクトにはイベントタイプに関連するフィールドが含まれ、トップレベルの識別子により各配信のルーティングと重複排除が可能です。
id— 安定したイベント識別子type— 正確なイベントタイプoccurred_at— 活動が発生した時刻data— チャネル固有の情報
{
"id": "whv2_01J...",
"type": "sms.received",
"api_version": "2026-09-22",
"created_at": "2026-09-22T12:00:00Z",
"occurred_at": "2026-09-22T11:59:58Z",
"data": {
"guid": "...",
"from": "+32...",
"message": "Can you call me back?"
}
}イベントからビジネス成果へ
モバイル通信で次のビジネスアクションを起動させる。
CRMでの会話
受信したSMSまたはWhatsAppメッセージを正しいコンタクトに追加し、担当者に通知します。
不在着信対応
不在着信後に折り返しタスクを作成したり、フォローアップのSMSを送信したり、当番チームに通知したりします。
カスタマーサポート
顧客がモバイルから返信した際に、サポートチケットを新規作成または更新できます。
Eコマース運用
モバイルメッセージが送信・配信確認・失敗した際に、注文連絡のワークフローを更新できます。
監視とアラート
配信失敗や異常な通話活動を監視ツールやインシデント管理ツールへ送信します。
AIとデータワークフロー
認可されたイベントを、API を繰り返しポーリングすることなく、分類・レポーティング・支援ワークフローに取り込めます。
変更のポーリングを停止
ポーリングは繰り返し問い合わせます。Webhook は何かが変わったときにソフトウェアに通知します。
ポーリングは何も起きていないときでもリクエストを消費し、チェック間の遅延を増やします。Webhook V2 は関連イベントをあなたのエンドポイントへプッシュし、オートメーションをより速く、よりシンプルに、そしてスケールしやすくします。
新しいイベントはありますか？繰り返しのリクエスト · 追加の遅延
イベント
発生したら通知します。関連するイベント · 即時のワークフローWebhook V2 に関するよくある質問
エンドポイントを接続する前のご質問
ポーリングループを構築する必要がありますか？＋
いいえ。Webhook V2 はサブスクライブされたイベントをあなたの公開された HTTPS エンドポイントへ送信します。履歴や詳細を照会する必要がある場合は、引き続き API をご利用いただけます。
複数の Webhook URL を設定できますか？＋
はい。複数の送信先を作成し、ダッシュボードに表示されるアカウント制限内で、それぞれに対して異なるイベントセットを選択できます。
SMS が実際に送信されたかどうかはどう確認しますか？＋
ジョブが作成されたことを知るには sms.api.submitted を使用し、接続されたモバイルから報告された確認には sms.sent を使用してください。これらは別々の運用ステージとして扱います。
Webhook が複数回配信されることはありますか？＋
はい。Webhook V2 は少なくとも一度配信（at-least-once）を使用しています。安定したイベント ID または Idempotency-Key を保存し、既に処理した配信は無視してください。
エンドポイントは何を返す必要がありますか？＋
イベントを安全に受け取った後、HTTP 2xx レスポンスを返してください。処理はアプリケーション内で非同期に継続できます。
受信した WhatsApp イベントは継続的に収集されますか？＋
いいえ。WhatsApp の受信メッセージ取得は、独自の同意ベースの同期プロセスに従います。whatsapp.received イベントは、適格なメッセージが取得された後に利用可能になります。
あなたのモバイルイベント。あなたのソフトウェア。あなたのアクション。
今すぐ実機のモバイルアクティビティをあなたのソフトウェアに接続してください。
アカウントを作成するかサインインし、Webhook V2 を開いて公開された HTTPS 宛先を追加し、ワークフローに必要なイベントを選択してください。テストイベントを送信し、その署名を検証して統合を有効化します。
