企业已有自己的 AI 客服，还需要替换原系统吗？

不需要。企业保留自己的 AI、知识库、产品库、CRM 或 ERP，由 YoBot 把已授权的微信会话投递到企业 API，再执行企业 AI 返回的回复。

企业平台需要连接 YoBot 的 WebSocket 或暴露 RPA 吗？

不需要。调用方向固定为 YoBot RPA 客户端主动请求企业 API；耗时任务使用 HTTP 202 和 jobId，由客户端主动轮询。

复杂查询可以先回复正在查询，再发送最终结果吗？

可以。同步回复模式支持 SSE 二阶段回复：第一阶段发送简短等待提示，第二阶段返回最终结果，适合报价、库存和订单等需要查询业务系统的任务。

API 接入是否等于可以无人值守处理所有客户消息？

不是。价格确认、投诉、退款、合同承诺、身份不明确和数据不足等情况仍应不自动回复或交由人工处理。

YOBOT ENTERPRISE AGENT API

企业已有 AI，如何接到个人微信？

企业不必把现有 AI 客服、产品库、CRM 或 ERP 迁移到另一套平台。YoBot 作为微信私域 AI 桌面助理，把已授权的会话主动投递到企业 API，再把企业 AI 返回的结果发送到微信。

调用方向固定为“YoBot RPA 客户端 → 企业平台 API”。企业平台无需连接客户端 WebSocket，也无需把 RPA 暴露到公网。

接入架构

个人微信会话 YoBot 在已授权范围内读取客户问题和必要上下文。

→

企业 AI 与业务系统 根据客户身份查询产品、库存、报价或订单，生成受业务规则约束的结果。

→

YoBot 受控回复 执行文本或文件发送，记录任务状态；复杂和敏感问题可停止自动回复。

已有电子元器件行业客户使用该方式查询企业内部产品库。复杂查询先发送“正在查询”的短回复，结果生成后再返回正式答案。

先判断应该走企微 API 还是个人微信 RPA

业务条件	建议路径	需要接受的约束
客户关系可以迁移到企业微信，且希望使用官方接口	优先采用企业微信客服或客户联系相关官方能力	按企业微信开放能力、开通条件和数据范围重新设计业务流程
业务必须保留在现有个人微信，企业已有自己的 AI 与产品数据	使用 YoBot 桌面 RPA 连接企业 Agent API	依赖桌面客户端持续运行；应低频、小范围启用，并保留人工接管

YoBot 通过桌面可见界面进行受控读取和操作，不使用协议 Hook、客户端注入或微信数据库破解。该路线不等于微信官方开放接口，也不能承诺零封号风险；高频群发、自动加人和规避平台风控不属于适用范围。

三种接入模式

`sync_reply`

在一次连接中返回结果；可通过 SSE 分两阶段回复，适合报价、库存等查询。

`async_reply`

企业平台先返回 HTTP 202 和 jobId，YoBot 主动轮询，适合耗时任务。

`consume_only`

企业平台只接收消息做归档、分析或告警，YoBot 不向微信发送自动回复。

企业平台需要实现的接口

方法	路径	作用
GET	`/v1/capabilities`	声明协议版本、业务场景、智能体和可选能力。
POST	`/v1/chat`	接收会话消息，返回同步结果、异步任务或接收确认。
GET	`/v1/jobs/{jobId}`	异步模式查询任务状态和最终结果。
POST	`/v1/deliveries/{deliveryId}/ack`	可选。接收微信侧最终发送成功或失败的回执。

最小能力响应

同步回复或只消费模式，可以先实现最小能力探测：

GET /v1/capabilities
Authorization: Bearer <customer-token>

{
  "protocolVersion": "1",
  "scenes": ["auto_reply"]
}

远程服务应使用 HTTPS 和独立 Bearer Token；Token 不应放在 URL、响应正文或业务日志中。

复杂查询的二阶段回复

当企业 AI 需要查询产品库或 ERP 时，可先给客户明确的等待反馈，再返回最终结果。二阶段能力只用于 sync_reply 的自动回复场景。

event: message
data: {"phase":1,"action":"reply","segments":["问题已收到，正在查询，请稍候。"],"deliveryId":"delivery-001-phase-1"}

event: message
data: {"phase":2,"action":"reply","segments":["该型号当前有库存，正式报价请查看附件。"],"deliveryId":"delivery-001-phase-2"}

第一阶段仅发送简短纯文本；第二阶段是本轮最终结果。两阶段使用独立稳定的 deliveryId，便于企业侧核对实际投递状态。

接入流程

确定处理边界

明确哪些问题可自动回复，哪些只记录，哪些必须停止自动回复并交给人工。

实现标准端点

从 capabilities 和 chat 开始；耗时任务再增加 jobs，生产环境建议增加 ACK。

配置与联调

在 YoBot 中填写 Base URL、Bearer Token、profileId、场景和回复模式。

小范围验收

验证重复消息去重、超时重试、人工边界、发送回执和客户端重启恢复。

可靠性与数据规则

企业平台按 idempotencyKey 去重，避免网络重试造成重复查询或重复回复。
会话建议使用 profileId + accountId + sessionId 隔离，不能只依赖可能重名的微信昵称。
异步任务坐标和发送进度由客户端持久化；客户端重启后可继续轮询未完成任务。
返回图片或文件时使用客户端可访问的 HTTPS URL，不返回企业服务器本地路径或 Base64。
消息历史可能不完整，企业平台应维护自己的可靠会话状态和权威业务数据。

自动回复边界

API 对接解决的是“企业 AI 如何进入个人微信执行链路”，并不替代业务审核。价格确认、合同承诺、投诉退款、敏感信息、身份不明确或数据不足时，企业 API 应返回 no_reply 或 defer，让 YoBot 不发送自动回复。

当前协议中的 defer 表示“暂不自动回复”，不会自动创建独立的人工工单；企业仍需在自己的客服或告警系统中完成接管流程。

常见问题

必须把企业知识库同步到 YoBot 吗？

不必。知识库和业务数据可以继续保留在企业平台，YoBot 只投递会话并执行企业 API 返回的结果。

可以只监控和分析，不在微信里回复吗？

可以。选择 consume_only 后，消息会可靠投递给企业平台用于总结、线索识别或风险告警，但不会触发微信自动回复。

YoBot 是什么产品？

YoBot 是 YokoAI 推出的微信私域 AI 桌面助理，集成 Agent 与本地 RPA 能力。产品介绍见 YoBot 官网。