インバウンドメッセージとメッセージステータスのウェブフック

受信メッセージとメッセージステータスの両方のウェブフックを設定する必要があります。

ウェブフックURLの設定

設定しなければならないウェブフックが少なくとも2つある：

  • メッセージ・ステータス
  • インバウンド・メッセージ・ウェブフック

などのメッセージのステータス更新が発生した場合 delivered, rejected または acceptedコールバックは メッセージステータス ウェブフックのURL。

受信メッセージを受け取ると、メッセージペイロードを持つコールバックが インバウンドメッセージ ウェブフックのURL。

重要： 両方の Webhook URL を設定する必要があります。少なくとも、Webhook ハンドラーは、Inbound Message と Message Status の両方のコールバックに対して 200 レスポンスを返す必要があります。これにより コールバックキューイング 問題は回避される。

ウェブフックURLを設定するには

  1. もしあなたがすでに アプリケーションを作成にアクセスしてください。 アプリケーション をクリックし、設定するアプリケーションを選択します。

  2. クリック 編集 をクリックして、アプリケーションのウェブフックURLを変更します。

  3. Messages capabilitiesセクションで、Webhook URLを以下のフィールドに入力します。 ステータスURL そして インバウンドURL.

Webhook URL に入力する値は、Webhook サーバーがどこにあるかによって異なります。例えば

ウェブフック URL
ステータスURL https://www.example.com/webhooks/message-status
インバウンドURL https://www.example.com/webhooks/inbound-message

注： の使用を推奨する。 JWTベースの認証 で受信と配信のウェブフックURLを設定することができます。 アプリケーションレベル.そうでなければ、異なるアプリケーションからのすべてのコールバックは、あなたの アカウントレベルのウェブフックURL.

注： コールバックは POST HTTPリクエスト。

Ngrok経由でローカルでテスト

アプリケーションをローカルでテストしたい場合は、Ngrokを使うことができる。

に関する情報をご覧ください。 地域開発のためのングロク活用

この方法でNgrokを使用する場合は、Webhook URLにNgrok URLを使用します：

  • https://abcdef1.ngrok.io/webhooks/inbound-message
  • https://abcdef1.ngrok.io/webhooks/message-status

ウェブフックキュー

メッセージステータスWebhook URLやインバウンドメッセージURLなど、Vonageから発信されるWebhookは、メッセージごとにVonageによってキューに入れられることにご注意ください。

すべてのアプリケーションが200レスポンスでWebhookを認識するようにしてください。

署名入りウェブフック

ウェブフックの発信元を検証するには、ウェブフックの署名を検証することができます。 これ

プロダクションで使用されるWebhook

Vonage API Account のメッセージ用 Webhook URL がすでに実運用で使用されており、Messages API を使用するための 2 つ目の URL が必要な場合は、電子メールでお問い合わせください。 サポート サブAPIキーを要求する。