ナビゲーションにスキップ
インテグレーション

Webhook

HTTPエンドポイントを呼び出すカスタムツールを受付係に提供します。

Webhook Tool連携は、HTTPエンドポイントを、受付係またはビジネスアシスタントが会話中に呼び出せるツールとして公開します。AIは会話に基づいて、エンドポイントを呼び出すタイミングを判断します。

Webhookツールの仕組み

Webhookツールを作成する際は、次を定義します。

  1. 呼び出すHTTPエンドポイント。
  2. AIが使用するタイミングを判断できるようにする、その機能の説明。
  3. AIが会話から収集する必要があるパラメーター。

通話中、会話がツールの目的に一致すると、受付係がパラメーターを収集し、エンドポイントを呼び出して、レスポンスを使って会話を続けます。

Webhookツールを作成する

Integrationsに移動し、Add integrationを選択してWebhook Toolを選びます。以下のフィールドを設定してEnableを選択します。Webhookツールは複数追加できます。

フィールド説明
NameAIに表示されるツール名。例：check_order_status
Descriptionこのツールを使用するタイミングと理由
MethodGET、POST、PUT、PATCH、またはDELETE
URLHTTPエンドポイント
Response timeout (seconds)サーバーの応答を待機する時間：5～120秒、デフォルトは20秒
Assign to agentsReceptionist、Assistant agent、または両方
Disable interruptionsツールの実行中に発信者が割り込めないようにする
Request HeadersAPIキーなど、すべてのリクエストで送信する任意のヘッダー
Body Parametersリクエスト本文で送信するパラメーター
Query ParametersURLクエリ文字列として送信するパラメーター

パラメーター

各パラメーターには次の項目があります。

  • Key：フィールド名。
  • Type：string、number、またはboolean。
  • Description：AIが会話から抽出する値。
  • Required：呼び出し前にAIが収集する必要があるかどうか。

ユースケース

シナリオ説明メソッド
CRM照会システム内の顧客情報を検索GET
在庫確認商品の在庫状況をリアルタイムで確認GET
リード獲得発信者の詳細をマーケティングシステムに送信POST
チケット作成通話中にサポートチケットを作成POST
見積もり発信者の要件に応じたカスタム見積もりを計算POST

例

配管サービス会社がWebhookツールを作成します。

  • Name: check_service_area
  • Description: “発信者の郵便番号の地域に対応しているか、および次に利用可能な時間枠を確認します。”
  • URL: https://api.mybusiness.com/check-area
  • Method: POST
  • Request Headers: 事業者のAPIキーに設定されたAuthorization
  • Body Parameters: zip_code（文字列、必須）、service_type（文字列、必須）

発信者が地域内でのサービスについて尋ねると、受付係は郵便番号を収集してWebhookを呼び出し、結果を伝えます。

Webhookツールはすべてのプランで利用できます。