n8n | ElevenLabs Documentation

将 n8n 工作流连接到 webhook 工具。当对话符合工具描述时，接待员会收集详细信息、调用工作流，并向来电者读出响应。通过 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，然后通过应触发工作流的对话测试接待员。每次运行都会显示在 n8n 的 Executions 列表中。

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

通过 MCP 公开多个工作流

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

故障排除

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