Webhook はパートナーが作成した HTTPS コールバックで、エージェントが イベントに応答する必要があります。事前構築済みの自動化されたパイプラインを Dialogflow などのソリューション エージェントの動作を定義するには、カスタム Webhook を設定する必要があります。
パートナー レベルとエージェント レベルの Webhook
Webhook はパートナー レベルまたはエージェント レベルで設定できます。 パートナー レベルの Webhook は管理するすべてのエージェントに適用されるのに対し、エージェント レベルの Webhook は Webhook はそれぞれ 1 つのエージェントに適用されます。
動作が異なる複数のエージェントを運用している場合は、 エージェントレベルの設定を使用して、エージェントごとに異なる Webhook を構成できます。反対側 エージェントの動作が似ている場合や エージェントが 1 つしかない場合は パートナーレベルの Webhook を使用できます。
パートナーレベルの Webhook とエージェント レベルの Webhook の両方が構成されている場合は、 エージェント レベルの Webhook はその特定のエージェントで優先され、 パートナー レベルの Webhook は、エージェント レベルの Webhook を持たないエージェントに適用されます。 できます。
パートナー レベルの Webhook を設定する
パートナー レベルの Webhook を設定する手順は次のとおりです。
- Business Communications Developer Console を開きます。 ビジネス メッセージの Google アカウントでログインします。
- [アカウント設定] を開きます。
- 正しいパートナー アカウントが選択されていることを確認します。
- [Business Messages webhook URL] で [Configure] をクリックします。
- [Webhook endpoint URL] に、アプリケーションの URL に「/callback/」を加えた名前を入力します。 たとえば、「https://PROJECT_ID.appspot.com/callback/」のようになります。
clientTokenの値をメモします。これは、受信したメールが Google から送信されたものであることを確認するために必要です。指定した POST リクエストを受け入れるように Webhook を構成します。
clientTokenパラメータを使用して、書式なしテキストを含む200 OKレスポンスを送信します。 シークレット パラメータの値をレスポンス本文として指定します。たとえば、 Webhook が、以下の本文コンテンツを含む POST リクエストを受け取ります。{ "clientToken":"SJENCPGJESMGUFPY", "secret":"0123456789" }その場合、Webhook は
clientToken値を確認する必要があり、clientTokenは正しいので、0123456789が指定された200 OKレスポンスを返します。 レスポンスの本文ですコンソールで [確認] をクリックします。ビジネス メッセージが Webhook の確認を完了すると、 ダイアログが閉じます。
エージェント レベルの Webhook を設定する
パートナー レベルの Webhook でエージェントに送信されたメッセージを受信します。もし 特定のエージェントのメッセージを別の Webhook に届けたい場合は、 エージェントレベルの Webhook を設定できます
- Business Communications Developer Console を開きます。 ビジネス メッセージの Google アカウントでログインします。
- エージェントをクリックします。
- [Integrations] をクリックします。
- [Webhook] で [構成] をクリックします。
- [Webhook endpoint URL] に、Webhook の URL（ "https://"
clientTokenの値をメモします。これは、受信したメールが Google から送信されたリクエストです。指定した POST リクエストを受け入れるように Webhook を構成します。
clientTokenパラメータをリクエストし、200 OK レスポンスを送信します。 シークレット パラメータです。たとえば、Webhook が POST リクエストを受信するとします。 次の本文コンテンツを追加します。{ "clientToken":"SJENCPGJESMGUFPY", "secret":"0123456789" }その場合、Webhook は
clientToken値を確認する必要があり、clientTokenは正しいです。シークレット URL を含む200 OKレスポンスを返します パラメータを0123456789に設定します。コンソールで [確認] をクリックします。ビジネス メッセージが Webhook の確認を完了すると、 ダイアログが閉じます。