このページは Cloud Translation API によって翻訳されました。

Webhook の設定

Webhook は、パートナーが作成した HTTPS コールバックで、エージェントがメッセージやイベントに応答する方法を指定します。Dialogflow などの事前構築済みの自動ソリューションを使用している場合を除き、エージェントの動作を定義するカスタム Webhook を設定する必要があります。

パートナーレベルとエージェントレベルの Webhook

Webhook は、パートナーレベルまたはエージェントレベルで設定できます。パートナーレベルの Webhook は管理するすべてのエージェントに適用され、エージェントレベルの Webhook はそれぞれ 1 つのエージェントに適用されます。

異なる動作で複数のエージェントを操作する場合は、エージェントレベルの設定を使用して、エージェントごとに異なる Webhook を設定できます。一方、エージェントが同様の動作をする場合や、エージェントが 1 つのみの場合は、パートナーレベルの 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 からのものであることを確認するために必要です。
指定された clientToken パラメータで POST リクエストを受け入れ、シークレットパラメータの書式なしテキスト値を含む 200 OK レスポンスをレスポンス本文として送信するように Webhook を構成します。たとえば、Webhook が次の本文を含む POST リクエストを受け取ったとします。
```
{
"clientToken":"SJENCPGJESMGUFPY",
  "secret":"0123456789"
}
```
その場合、Webhook は clientToken 値を確認し、clientToken が正しい場合は、レスポンス本文として 0123456789 を使用して 200 OK レスポンスを返します。
コンソールで [確認] をクリックします。ビジネスメッセージによって Webhook の確認が完了すると、ダイアログが終了します。

パートナーレベルの Webhook でエージェントに送信されたメッセージを受信できます。特定のエージェントのメッセージが別の Webhook に到着するようにするには、エージェントレベルの Webhook を設定します。