# Webhook、支持与故障排查

把客户事件发送到第三方系统，并按用户能理解的顺序排查采集、邮箱、草稿和发送问题

Product: fengreach
Journey stage: troubleshoot
Audience: 系统管理员、外贸负责人、外贸业务员
Last verified: 2026-08-27

FengReach 可以把客户创建、邮箱发现等事件发送到你自己的 HTTPS 接口。Denchclaw、Zapier、Make、CRM 或内部系统都只是可选出口；FengReach 不依赖某一个接收方。

![Sync 页面用于添加 HTTPS 接收地址、选择事件、测试连接，并查看成功或失败的投递记录。](https://fengtalk.ai/images/help/fengreach/webhook-sync.png)

图：Sync 页面用于添加 HTTPS 接收地址、选择事件、测试连接，并查看成功或失败的投递记录。（FengReach e659b35 · 本地 E2E sandbox · 2026-08-27）

## 设置 Webhook

1. 打开 **设置 → Developer → Webhooks**。
2. 填写一个公网可访问的 HTTPS 地址；本地地址和普通 HTTP 会被拒绝。
3. 选择需要的事件，例如客户创建或找到可用邮箱。
4. 保存后点击测试，在接收系统确认收到 `webhook.test`。
5. 接收端使用 FengReach 提供的签名密钥验证 `X-FengReach-Signature`，不要只按 URL 判断来源。
6. 在投递记录查看状态；失败或排队中的记录可以重试。

## 常见问题按这个顺序查

### 扩展显示“Failed to fetch”

确认 API 地址是 `https://reach.fengtalk.ai`，API Key 已保存且没有撤销；刷新 LinkedIn 页面再试。仍失败时复制脱敏支持报告，不要复制原始 Key。

### 采集成功，但没有邮箱

采集和邮箱发现是两步。到“潜在客户”查看状态：排队中先等待；隐藏或未找到不会进入草稿。补充正确公司和 LinkedIn 资料后再决定是否重试。

### 不能生成草稿

检查客户是否有完整可用邮箱、是否已禁止联系、积分是否足够，以及 AI 企业档案中的产品摘要是否完整。

### 草稿已经批准，但没有发送

批准不是发送。确认已经选择已验证 SMTP、点击安排序列、排程时间已经到达，并在 Sequences 查看是否被发送上限、发件账号状态或系统保护开关拦截。

### SMTP 验证失败

核对主机、端口、TLS/STARTTLS、登录名和应用密码。Gmail 等服务通常要求应用专用密码；登录邮箱和发件邮箱不同时，还要确认代发权限。

### Webhook 没收到

先发送测试事件，再看投递记录。确认接收地址使用 HTTPS、没有被防火墙拦截，并使用原始请求体校验签名。不要把 signing secret 写进前端或公开仓库。

需要人工支持时联系 `support@fengtalk.ai`，附上发生时间、页面、可公开的任务状态和脱敏支持报告。不要发送 API Key、SMTP 密码、完整 Webhook 地址、客户邮件正文或付款资料。