メッセージを処理する前に呼び出しを行う

プレメッセージWebhookは、顧客が入力を送信するたびに、外部サービスまたはアプリケーションに呼び出しを行います。外部サービスは、あなたのアシスタントがメッセージを処理する前に、メッセージを処理することができます。

各着信メッセージがアシスタントによって処理される前にWebhookをトリガーしたい場合は、プレメッセージWebhookをアシスタントに追加します。

カスタム・チャネルを使用している場合、pre-message webhookは /message APIバージョン2（ステートレスおよびステートフル）のみで動作します。詳しくは、API リファレンスを参照してください。すべての組み込みチャネル統合で、この API が使用されます。

プレメッセージWebhookは以下のような用途に使用できます：

顧客の入力をアシスタントが使う言語に翻訳する。
顧客が送信する可能性のある個人情報 (E メール・アドレスや社会保障番号など) を確認し、削除します。

このウェブフックは、ポストメッセージのウェブフックと連携して使用することができます。例えば、ポストメッセージのウェブフックは、レスポンスを顧客の言語に翻訳したり、プライバシーの理由で削除された情報を追加したりすることができる。詳しくは、メッセージの処理後に呼び出しを行うを参照してください。

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

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

Web フックの定義

すべての着信メッセージの前処理に使用する Webhook URL を 1 つ定義できます。

開始前に

外部サービスへのプログラム呼び出しは、以下の要件を満たしていなければならない：

アシスタントがデプロイされ、お客様と対話している実稼働環境では、Web フックをセットアップしてテストしないでください。
呼び出しは POST HTTP 要求であること。
要求本体は JSON オブジェクト (Content-Type: application/json) でなければなりません。
呼び出しは 30 秒以内に戻らなければなりません。

外部サービスがGETリクエストのみをサポートしている場合、または実行時に URL パラメータを動的に指定する必要がある場合は、実行時の値を含むJSONペイロードでPOSTリクエストを受け付ける中間サービスを作成することを検討する。その後、中間サービスは、これらの値を URL パラメーターとして渡してターゲット・サービスに要求を行い、応答をダイアログに返すことができます。

配備方法の選択

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

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

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