集成

Webhook

为接待员提供调用 HTTP 端点的自定义工具。

Webhook 工具 集成会将 HTTP 端点作为工具提供，接待员或业务助手可在对话中调用。AI 会根据对话内容决定何时调用端点。

Webhook 工具的工作方式

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

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

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

创建 Webhook 工具

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

字段说明
名称AI 看到的工具名称，例如 check_order_status
说明使用此工具的时机和原因
方法GET、POST、PUT、PATCH 或 DELETE
URLHTTP 端点
响应超时（秒）等待服务器响应的时长：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 工具。