Webhook を設定する

<ph type="x-smartling-placeholder">

Webhook はパートナーが作成した HTTPS コールバックで、エージェントが イベントに応答する必要があります。事前構築済みの自動化されたパイプラインを Dialogflow などのソリューション エージェントの動作を定義するには、カスタム Webhook を設定する必要があります。

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

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

動作が異なる複数のエージェントを運用している場合は、 エージェントレベルの設定を使用して、エージェントごとに異なる Webhook を構成できます。反対側 エージェントの動作が似ている場合や エージェントが 1 つしかない場合は パートナーレベルの Webhook を使用できます。

パートナーレベルの Webhook とエージェント レベルの Webhook の両方が構成されている場合は、 エージェント レベルの Webhook はその特定のエージェントで優先され、 パートナー レベルの Webhook は、エージェント レベルの Webhook を持たないエージェントに適用されます。 できます。

パートナー レベルの Webhook を設定する

パートナー レベルの Webhook を設定する手順は次のとおりです。

  1. Business Communications Developer Console を開きます。 ビジネス メッセージの Google アカウントでログインします。
  2. [アカウント設定] を開きます。
  3. 正しいパートナー アカウントが選択されていることを確認します。
  4. [Business Messages webhook URL] で [Configure] をクリックします。
  5. [Webhook endpoint URL] に、アプリケーションの URL に「/callback/」を加えた名前を入力します。 たとえば、「https://PROJECT_ID.appspot.com/callback/」のようになります。
  6. clientToken の値をメモします。これは、受信したメールが Google から送信されたものであることを確認するために必要です。

  7. 指定した POST リクエストを受け入れるように Webhook を構成します。 clientToken パラメータを使用して、書式なしテキストを含む 200 OK レスポンスを送信します。 シークレット パラメータの値をレスポンス本文として指定します。たとえば、 Webhook が、以下の本文コンテンツを含む POST リクエストを受け取ります。

    {
"clientToken":"SJENCPGJESMGUFPY",
  "secret":"0123456789"
}

    その場合、Webhook は clientToken 値を確認する必要があり、 clientToken は正しいので、0123456789 が指定された 200 OK レスポンスを返します。 レスポンスの本文です

  8. コンソールで [確認] をクリックします。ビジネス メッセージが Webhook の確認を完了すると、 ダイアログが閉じます。

エージェント レベルの Webhook を設定する

パートナー レベルの Webhook でエージェントに送信されたメッセージを受信します。もし 特定のエージェントのメッセージを別の Webhook に届けたい場合は、 エージェントレベルの Webhook を設定できます

  1. Business Communications Developer Console を開きます。 ビジネス メッセージの Google アカウントでログインします。
  2. エージェントをクリックします。
  3. [Integrations] をクリックします。
  4. [Webhook] で [構成] をクリックします。
  5. [Webhook endpoint URL] に、Webhook の URL（ "https://"
  6. clientToken の値をメモします。これは、受信したメールが Google から送信されたリクエストです。

  7. 指定した POST リクエストを受け入れるように Webhook を構成します。 clientToken パラメータをリクエストし、200 OK レスポンスを送信します。 シークレット パラメータです。たとえば、Webhook が POST リクエストを受信するとします。 次の本文コンテンツを追加します。

    {
  "clientToken":"SJENCPGJESMGUFPY",
  "secret":"0123456789"
}

    その場合、Webhook は clientToken 値を確認する必要があり、 clientToken は正しいです。シークレット URL を含む 200 OK レスポンスを返します パラメータを 0123456789 に設定します。

  8. コンソールで [確認] をクリックします。ビジネス メッセージが Webhook の確認を完了すると、 ダイアログが閉じます。