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

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 Headersリクエストごとに送信する任意のヘッダー。Type は Value または Secret です。Secret は暗号化して保存され、再表示されません。ElevenAgentsから取り込んだヘッダーには Environment variable または Variable と表示され、エージェントプラットフォームで設定されている旨が示される場合があります。
Path ParametersURLに/orders/{order_id}のような波括弧付きプレースホルダーが含まれる場合に表示されます。追加または削除するにはURLを編集します。
Body Parametersリクエスト本文で送信するパラメーター。Value には From the conversation または Fixed value を指定できます。
Query ParametersURLのクエリ文字列として送信するパラメーター。Value には From the conversation または Fixed value を指定できます。

パラメーター

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

  • 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: Authorizationに事業者のAPIキーを設定
  • Body Parameters: zip_code（string、必須）、service_type（string、必須）

発信者が自分の地域でサービスを利用できるか尋ねると、受付担当が郵便番号を確認してWebhookを呼び出し、結果を伝えます。

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