先确认实例满足接入条件
- Chatwoot Cloud：账号需要具备本集成使用的 API 和 Webhook 权限，开始前请确认当前 Cloud 套餐。
- 自托管 Chatwoot：支持带有 Agent Bot 签名能力的 4.13+ 版本；实例需要能被 GPT KeFu 服务通过 HTTPS 访问。
- 连接凭据：准备管理员的个人 API Access Token，以及 Agent Bot 的 Webhook Secret，两者不能混用。
- 收件箱：你需要有权限配置目标 Inbox，并为它绑定 Agent Bot。
验证连接后再启用回复
Agent Bot 会将会话事件发送到 GPT KeFu 接入页提供的专属回调地址。GPT KeFu 验证签名后处理事件，再通过 Chatwoot API 发送回复。
保存凭据不会直接启用 AI。先检查 API 连接，再发送一条真实访客消息，验证签名回调。验证通过后启用 AI，并发送另一条新消息测试回复，避免把连接检查通过误认为 AI 已开始工作。
让回复参考自己的产品资料
套餐包含 RAG 时，可将 FAQ、产品文档和客服政策加入项目知识库。建议先覆盖一个明确主题，逐条对照原文检查回答。
不同套餐有不同的文档数量限制。导入成功只是第一步，还需要测试常见问法、追问，以及资料中没有答案的问题。
人工可以参与同一会话
套餐支持自动暂停时，人工回复后可让 AI 暂停指定时长。后续访客消息按当前设置继续处理，这不等于永久转入人工队列。
Crisp 的自动欢迎语和 Telegram Topic 转发不属于 Chatwoot 项目功能。Agent Bot 已提供会话状态事件，账号级 Webhook 是可选配置。
接入前的常见问题
- 自托管是指 GPT KeFu 安装在我的服务器吗？
- 不是。这里的自托管指你的 Chatwoot 实例，通过 API 和带签名的 Agent Bot 回调接入 GPT KeFu 服务。
- 连接检查通过就能确认机器人可用吗？
- 还不能。需要接收到真实签名回调，启用集成后，再发送一条新的访客消息验证 AI 回复。
- 这是 Chatwoot Captain 吗？
- 不是。GPT KeFu 是使用 Chatwoot Agent Bot 机制的独立集成，需要分别确认 GPT KeFu 项目能力与 Chatwoot 套餐。