メッセージの処理後に呼び出しを行う

ポストメッセージWebhookは、アシスタントがレスポンスをレンダリングするたびに、外部のサービスやアプリケーションを呼び出します。外部サービスは、アシスタントの出力をチャンネルに送信する前に処理することができます。

各メッセージの応答が顧客に表示される前にWebhookをトリガーしたい場合は、アシスタントにポストメッセージWebhookを追加できます。

ポストメッセージWebhookを使用して、外部コンテンツリポジトリからカスタムレスポンスを抽出することができます。例えば、応答でテキストの代わりにカスタム ID を使用してアクションを定義できます。ポストメッセージWebhookは、これらのIDを外部データベースに渡し、保存されたテキストレスポンスを取得することができます。

このウェブフックは、プレメッセージのウェブフックと連携して使用できます。例えば、事前メッセージウェブフックを使って、顧客の入力から個人を特定できる情報を取り除いた場合、事後メッセージウェブフックを使って、その情報を元に戻すことができます。もし事前メッセージウェブフックを使って顧客の入力をアシスタントの言語に翻訳した場合、事後メッセージウェブフックを使ってレスポンスを返す前に顧客の言語に翻訳することができます。詳しくは、メッセージを処理する前に呼び出しを行うを参照してください。

注：プライベート・エンドポイントが使用されている環境では、ウェブフックはインターネット上にトラフィックを送信することに留意してください。

Web フックの定義

各メッセージ応答がチャネルに送信されて顧客に表示される前に、そのメッセージ応答の処理に使用する Webhook URL を 1 つ定義できます。

開始前に

外部サービスへのプログラマチック呼び出しは、以下の要件を満たす必要があります。

アシスタントがデプロイされ、お客様と対話している実稼働環境では、Web フックをセットアップしてテストしないでください。
呼び出しは POST HTTP 要求であること。
呼び出しは 30 秒以内に完了する必要があります。
要求と応答の形式は JSON であること ( 例えば、Content-Type: application/json などです。

注：会話中に必要な時に1回限りのアクションを実行する必要がある場合は、ダイアログWebhookを使用してください。たとえば、アシスタントが口座番号、ユーザーID、口座の秘密など、必要な情報をすべて収集した時点で条件は満たされる。詳細については、ダイアログからのプログラム呼び出しを参照してください。

展開方法を選択する

ポストメッセージ Webhook を設定するための正しい手順を表示するには、使用するデプロイメント方法を選択します。

使用している配置タイプを確認するには、[ 管理] メニューをクリックします。 Switch to classic experienceと表示されている場合は、 新しいエクスペリエンスを使っていることになります。 Switch to new experienceと表示されている場合は、 クラシック・エクスペリエンスを使用しています。

注: 展開タイプは watsonx Orchestrate には適用されません。

次のリンクを使用して、配置タイプに基づく手順について確認してください：