跳到主要内容
操作

将通话数据发送到你的系统

每次通话结束后，把摘要、转录和收集到的数据发送到你的 CRM、Webhook 或数据库。

API 调用 会在通话结束后把通话发送到你自己的系统——摘要、转录、情绪以及代理收集到的一切。你可以用它在 CRM 中创建线索、启动自动化流程，或保存自己的记录。如果你的系统暂时不可用，请求会自动重试，不会丢失任何数据。

设置​

  1. 添加操作

    打开代理 → 操作 → 添加工具 → Post call → API 调用。

  2. 指向你的端点
    字段填写内容
    名称例如 CRM 线索同步
    条件何时发送，例如 来电者想要购买时。留空：每次通话后都发送
    API 端点 URL你的端点，例如 https://hooks.example.com/hanc
    HTTP 方法大多数系统用 POST；GET、PUT、PATCH、DELETE 也可以
    标头、查询参数可选，例如 API 密钥
  3. 调整请求内容（可选）
    • 请求体 (JSON)——你自己的字段。输入 {{ 可插入通话变量，例如 {"lead": "{{firstname}} {{lastname}}", "phone": "{{call_from}}"}。
    • 仅发送我的字段——不发送标准通话数据，适用于只接受自身数据结构的系统。
  4. 决定失败时如何处理
    • 失败时重试——当你的端点没有返回 2xx 时，每次重试前的等待时间。默认：1 分钟、5 分钟、30 分钟、2 小时、6 小时、24 小时、48 小时。
    • 失败通知——在最后一次尝试后（默认）、每次尝试失败后，或从不发送邮件。发送至：留空表示发给账户所有者。

编辑器中的 我的端点会收到什么？ 会显示确切的请求内容。

你的端点会收到什么​

对于 POST、PUT 和 PATCH，会收到一个 JSON 请求体——你的字段与通话字段合并在一起：

{
  "id": "6ac7ea6eca60c6024b465c70",
  "agent_id": "6ac2a93e36bad261cf088684",
  "call_from": "+431234567890",
  "call_to": "+439876543210",
  "direction": "inbound",
  "call_type": "phone",
  "call_status": "success",
  "start_timestamp": 1730000000000,
  "end_timestamp": 1730000187000,
  "duration": 187000,
  "transcription": [
    { "speaker": "agent", "content": "Hello…", "timestamp": 1730000001000 },
    { "speaker": "user", "content": "Hi…", "timestamp": 1730000003000 }
  ],
  "call_summary": "Customer asked about pricing…",
  "task_achieved": true,
  "sentiment": { "sentiment": "positive", "explanation": "…" },
  "custom_analysis_data": { "name": "John", "email": "john@example.com" },
  "collected_data": {},
  "transfer_history": [],
  "recording_url": "https://…",
  "disconnection_reason": "user_hangup",
  "is_anonymous": false,
  "is_simulation": false,
  "created_at": 1730000000000,
  "updated_at": 1730000187000
}

对于 GET 和 DELETE，同样的字段会放在查询字符串中，但不包含嵌套字段（转录、情绪、收集到的数据）。

每个请求都带有 X-Hanc-Delivery-Id——同一次投递的所有尝试都相同，便于你跳过重复请求——以及带有尝试次数的 X-Hanc-Attempt。每次尝试 30 秒后超时。所有尝试都会列在 CRM → 沟通 中，失败的投递可以在那里重新发送。详情：Webhooks 与投递。

使用场景​

  • 在你的 CRM 中创建线索或工单。
  • 用通话数据启动无代码自动化流程。
  • 保存你自己的通话档案。
本页内容