> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Webhook

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

## Webhookツールの仕組み

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

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

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

## Webhookツールを作成する

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

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

### パラメーター

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

* **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ツールはすべてのプランで利用できます。