汎用 Webhookを使って統合を設定する


前提条件:  
  • 送信者アプリケーションの理解
  • JSONの理解
  • チャット通知(webhook) Genesys Cloudでの構成が完了しました( Webhook統合の追加)

Genesys Cloudチャットルームに自動チャットを送信するには、Generic Webhookを使用します。 Generic Webhookはメッセージをリッスンし、JSONペイロードで指定された更新を投稿します。

  1. Webhook通知URLとしてGenesys CloudからのURLを使用します。

    場所このURLを入力するフィールドのは、依存するアプリケーション 。この手順については、 アプリケーションの指示を参照するか、サポートに連絡してください。

  2. 次の形式を使用してJSONペイロードを構成します。
    {
     "message": "[message here]",
     "metadata": "[metadata here]"
    }

    Webhookマッピングは、メッセージまたはメタデータでフィルタリングできます。

    • メッセージ JSONでは必須であり、リッスンするメッセージのタイプを指定します。
    • メタデータ オプションであり、メッセージにない可能性があるリッスンするタグを指定します。
    注:Genesys Cloudは メッセージ JSONペイロードのマークダウンとしてのプロパティにより、チャットメッセージのフォーマットに幅広い柔軟性を提供します。
  3. Genesys Cloud webhook URLにペイロードをデリバリするための呼び出しを設定します。

    これは POST RESTを使用して呼び出します。

この例では、 アプリケーションを設定して、IT担当者のチャット ルーム通知を送信します。誰かが安全なネットワークにログインするたびに知りたいのです。JSONペイロードは次のようになります。

{
 "message": "**John Doe** just logged into our secure network.",
 "metadata": "security log"
}