> 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.

# n8n

将 n8n 工作流连接到 [webhook 工具](/docs/zh/reception-ai/integrations/webhooks)。当对话符合工具描述时，接待员会收集详细信息、调用工作流，并向来电者读出响应。通过 n8n，接待员可访问 n8n 连接的任何应用。

## 构建工作流

### 添加 Webhook 触发器

在 n8n 中，创建一个工作流并添加 **Webhook** 节点。将 **HTTP Method** 设为 `POST`。

### 保护 webhook

将 **Authentication** 设为 **Header Auth**，并创建凭据：指定请求头名称，例如 `X-Reception-Key`，以及一个较长的随机值。Reception.ai 会在每次调用时发送此请求头。

### 返回响应

将 **Respond** 设为 **Using 'Respond to Webhook' Node**。添加工作流步骤，然后以返回 JSON 的 **Respond to Webhook** 节点结束，例如 `{"available": true, "next_slot": "Tuesday 10am"}`。接待员会读取此响应，以决定如何回复。

### 激活工作流

激活工作流，并从 Webhook 节点复制 **Production URL**。测试 URL 仅在编辑器正在监听时有效。

## 创建 webhook 工具

前往 **Integrations**，选择 **Add integration**，然后选择 **Webhook Tool**。

| 字段                   | 值                                                                  |
| -------------------- | ------------------------------------------------------------------ |
| **Name**             | 工作流的功能，例如 `check_service_area`                                     |
| **Description**      | 使用时机，例如“检查我们是否服务来电者所在邮编。预约上门前使用。”                                  |
| **Method**           | POST                                                               |
| **URL**              | 工作流的生产 URL                                                         |
| **Request Headers**  | n8n 凭据中的请求头名称和值                                                    |
| **Body Parameters**  | 工作流所需的每个值对应一个参数，例如 `zip_code`（字符串，必填）。n8n 会从 `body.zip_code` 读取它们。 |
| **Assign to agents** | **Receptionist**                                                   |

选择 **Enable**，然后通过应触发工作流的对话[测试接待员](/docs/zh/reception-ai/receptionist/testing)。每次运行都会显示在 n8n 的 **Executions** 列表中。

> **Note**
>
> 正文参数是接待员从对话中填充的扁平值。若要发送固定值，请在工作流中设置。

## 通过 MCP 公开多个工作流

若要让接待员一次使用多个 n8n 工作流，请改用 n8n 的 **MCP Server Trigger** 节点。连接要公开的工作流或工具节点，将触发器认证设为 bearer，然后激活它。在 Reception.ai 中，使用触发器的生产 URL 和 bearer 令牌作为 **Secret Token** 添加一个 [MCP 服务器](/docs/zh/reception-ai/integrations/mcp-server)，然后在 **Tools** 标签页分配工具。

## 故障排除

| 问题           | 检查项                                                                                   |
| ------------ | ------------------------------------------------------------------------------------- |
| n8n 中未显示执行记录 | 工作流必须已激活，且工具必须使用生产 URL。                                                               |
| 工作流返回 403    | Reception.ai 中的请求头名称和值必须与 n8n 凭据完全一致。                                                 |
| 接待员提示工具失败    | 工作流必须在工具的 **Response timeout** 内完成。默认是 20 秒，最长可设为 120 秒。                              |
| 接待员从不调用工具    | 在工具描述中明确应使用它的情形。还可以添加一个[流程](/docs/zh/reception-ai/receptionist/rules-and-procedures)。 |