# 故障排查与恢复

从运行模式、队列、模型、Provider 和精确回执找到客户不推进的根因

Product: ai-salesperson
Journey stage: troubleshoot
Audience: 外贸业务员、系统管理员
Last verified: 2026-08-27

遇到问题时不要反复点击或重新导入。先确定故障发生在“入库、调查、决定、草稿、执行、回流”哪一段，再只重试没有发生客户动作的部分。

![自动任务页是排查起点：先看只准备/可执行模式，再看最近运行、下次唤醒、队列、模型、Provider 和明确失败原因。](https://fengtalk.ai/images/help/ai-salesperson/automatic-work-desktop-2026-08-27.png)

图：自动任务页是排查起点：先看只准备/可执行模式，再看最近运行、下次唤醒、队列、模型、Provider 和明确失败原因。（当前产品 · 本地 no-send sandbox · 2026-08-27）

## 按症状检查

| 症状 | 先检查 | 安全恢复 |
| --- | --- | --- |
| 导入后找不到公司 | 来源事件、去重合并、导入回执 | 搜索合并后的记录；不要重建整批 |
| 调查一直排队 | 允许背景调查、worker lease、Provider health | 修复后领取原任务；不要连续点开始 |
| 调查完成但资料少 | 时间线中的未找到与证据 | 补充域名或特别问题后创建新调查版本 |
| AI 没有决定 | paused/prepare_only、Next wake、模型健康、Prompt 预算 | 修复阻塞后唤醒同一 Company Flow |
| 有决定没有草稿 | 能力选择、联系人/渠道、知识与策略、模型错误 | 修复缺口后重新生成 Draft |
| 有草稿没有发送 | 执行授权、DNC、Provider、sender、fingerprint | 这是正常安全边界；复核后创建新授权 |
| 显示发送但无回执 | Provider typed receipt 与 once-only ledger | 停止重试，先查 Provider；避免重复发送 |
| 收到回复但系统没变化 | webhook、归属、Observation task、Flow wake | 修正内部作用域后重放处理，不重发客户动作 |

“允许背景调查”关闭时，已经创建的调查可以停留在“等待开始”。这不是让业务员重复点击的信号；先打开调查开关或确认这是有意暂停，再让原任务继续。销售大脑的“只准备草稿”和背景调查开关彼此独立。

## Provider 常见问题

- **WhatsApp 403 或断线：** 停止 WhatsApp 客户动作，重新连接 Evolution 实例并核对实际号码；断线期间不要把 unknown 改成 valid，也不要把未送达推断成已发送。
- **Email 欠费或限制：** Provider 健康应显示失败；保留 Draft，修复账号后重新预览。
- **SMS/Voice 失败：** 检查 E.164、国家支持、sender/caller、账号余额和回执详情。
- **模型 402、429 或无输出：** 检查余额、限流和 fallback。已有 Decision、Draft、Next wake 和失败原因都应保留；恢复时继续原 Company Flow，不要另建一条循环。

## 什么时候绝对不要自动重试

Provider 已经接受请求但结果不明确、联系表单已经点击但缺少成功证据、电话已发起但回执延迟时，不要自动再执行一次。先检查 once-only ledger 和 Provider 侧记录，确认客户动作没有发生后再恢复。

## 联系支持时提供什么

发送页面名称、客户内部 ID、时间、失败阶段、脱敏错误、任务或回执 ID，以及问题是否涉及真实客户动作。不要发送密码、API Key、Cookie、完整客户消息或支付凭据。联系 `hi@fengtalk.ai`。

下一步：[产品限制与支持边界](https://fengtalk.ai/help/ai-salesperson/limitations-and-support)。