潜在客户网络钩子问题
本指南帮助您排查接收的潜在客户网络钩子，让来自外部来源（广告表单、落地页、CRM）的新潜在客户可靠地抵达 ABC Sales AI。
网络钩子返回错误
问题： 发送网络钩子的系统报告失败或非成功状态代码。
可能原因：
- 网络钩子 URL 不正确或已变更
- 验证 token 或密钥缺少或错误
- 请求负载不是有效的 JSON
- 发送服务无法触及我们的端点
解决方案：
- 从您的 ABC Sales AI 设置中复制确切的网络钩子 URL，并确认没有多余的空格
- 在每个请求中包含所需的验证标头或 token
- 在发送前验证负载是格式正确的 JSON
- 检查状态页面以了解任何端点中断
未创建潜在客户
问题： 网络钩子返回成功，但没有潜在客户出现。
可能原因：
- 负载中缺少必填字段（例如姓名或电话号码）
- 负载中的字段名称与预期的映射不符
- 潜在客户已与现有联系人去重复
- 筛选或路由规则排除了该潜在客户
解决方案：
- 确认负载包含所有必填字段且字段名称正确
- 查看您的字段映射，使传入的键映射到正确的潜在客户属性
- 检查潜在客户是否匹配现有联系人而被合并而非创建
- 查看任何可能丢弃潜在客户的传入筛选或路由规则
已创建潜在客户但数据不完整或错误
问题： 潜在客户出现，但某些字段为空或包含错误的值。
可能原因：
- 字段映射不符或部分映射
- 数据格式异常（例如没有国家代码的电话号码）
- 负载中未映射的嵌套字段
解决方案：
- 端对端审核字段映射，并添加任何缺少的字段
- 在来源处规范化值（使用国际电话格式，例如 +15551234567）
- 展平或明确映射嵌套负载字段
验证网络钩子
> 提示： 在上线前，使用已知的示例负载发送测试请求。这可确认 URL、验证和映射都能协同运作。
- 发送一个测试潜在客户，并确认它以正确的数据出现
- 查看发送平台上的传递日志，以查看我们返回的回复
- 验证后，启用实时集成
仍有问题？
如果潜在客户仍无法抵达：
- 捕获确切的请求负载和回复状态代码
- 记下发送网络钩子的来源平台
- 联系我们的支持团队，并提供这些详细信息以及失败请求的大约时间