> 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 工具** 集成会将 HTTP 端点作为工具提供，接待员或业务助手可在对话中调用。AI 会根据对话内容决定何时调用端点。

## Webhook 工具的工作方式

创建 Webhook 工具时，需要定义：

1. 要调用的 HTTP 端点。
2. 其功能说明，让 AI 知道何时使用。
3. AI 应从对话中收集的参数。

通话期间，当对话符合工具用途时，接待员会收集参数、调用端点，并使用响应继续对话。

## 创建 Webhook 工具

前往 **集成**，选择 **添加集成**，然后选择 **Webhook 工具**。配置以下字段并选择 **启用**。你可以添加多个 Webhook 工具。

| 字段          | 说明                                 |
| ----------- | ---------------------------------- |
| **名称**      | AI 看到的工具名称，例如 `check_order_status` |
| **说明**      | 使用此工具的时机和原因                        |
| **方法**      | GET、POST、PUT、PATCH 或 DELETE        |
| **URL**     | HTTP 端点                            |
| **响应超时（秒）** | 等待服务器响应的时长：5–120 秒，默认 20 秒         |
| **分配给智能体**  | **接待员**、**助手智能体** 或两者              |
| **禁用打断**    | 工具运行时阻止来电者打断                       |
| **请求标头**    | 每个请求都会发送的可选标头，例如 API 密钥            |
| **正文参数**    | 在请求正文中发送的参数                        |
| **查询参数**    | 作为 URL 查询字符串发送的参数                  |

### 参数

每个参数包含：

* **键**：字段名称。
* **类型**：`string`、`number` 或 `boolean`。
* **说明**：AI 应从对话中提取的值。
* **必填**：AI 是否必须在调用前收集此参数。

## 使用场景

| 场景     | 说明             | 方法   |
| ------ | -------------- | ---- |
| CRM 查询 | 在系统中查找客户信息     | GET  |
| 库存检查   | 实时检查产品库存       | GET  |
| 潜在客户收集 | 将来电者详情发送到营销系统  | POST |
| 创建工单   | 通话期间创建支持工单     | POST |
| 价格报价   | 根据来电者需求计算自定义报价 | POST |

## 示例

一家管道维修企业创建了一个 Webhook 工具：

* **名称：** `check_service_area`
* **说明：** "检查我们是否服务于来电者所在邮编区域，以及下一个可预约时段。"
* **URL：** `https://api.mybusiness.com/check-area`
* **方法：** POST
* **请求标头：** 将 `Authorization` 设置为企业的 API 密钥
* **正文参数：** `zip_code`（字符串，必填）、`service_type`（字符串，必填）

当来电者询问其所在区域的服务时，接待员会收集其邮编、调用 Webhook，并告知结果。

所有套餐均可使用 Webhook 工具。