主流接入覆盖与补齐计划
把主流渠道从“有文档”推进到“可收发、可接管、可核对业务结果”,并明确本轮暂缓的非主流模块。
当前覆盖矩阵
| 优先级 | 对象 | 当前状态 | 当前证据 | 缺口与下一步 |
|---|---|---|---|---|
| P0 | Web / H5 | 已具备基础能力 | 已有网页入口、嵌入代码、同源消息客户端和用户点击后展开的接入指南。 | 没有把接入配置、消息回执和业务结果统一成一张连接状态单。 补齐入口健康状态、最近一次真实收发、人工接管和业务回执四项可核对证据。 |
| P0 | 微信小程序 | 已有 SDK / 文档,待宿主验收 | 已有原生聊天源码组件、客户端 API、下载包和真机验收清单。 | 扫码 / OpenID 身份绑定尚未形成标准流程;卡片消息、订阅消息和语音能力尚未闭环;合法域名与回调验签仍需按企业逐一验收 先交付文本、附件、人工接管和 OpenID 绑定四项 P0 能力,再单独评估语音和卡片。 |
| P0 | 微信客服 / 公众号 | 已有连接器,待真实账号验收 | 已有微信客服、公众号和小程序的配置入口与文本回调范围说明。 | 媒体消息和客服账号生命周期不完整;OAuth / 回调验签、撤权和人工接管证据没有统一留存 统一公众号、微信客服和小程序的身份、回调、收发、撤权和人工接管契约。 |
| P1 | 企业微信 | 已有连接器,待真实账号验收 | 已有企业微信机器人文本链路;客户联系和员工应用被明确区分。 | 外部客户联系、员工应用和内部机器人尚未共用一套身份与路由模型;应用可见范围与转人工归属缺少验收回执 先落地企业微信外部客户联系的文本收发和人工转接,再扩展员工应用。 |
| P1 | 抖音企业号 | 已登记,尚无收发连接器 | 已有准入和授权准备说明,没有把旧资料当作当前可用协议。 | 当前没有可证明的私信入站、发送、撤权和人工接管适配器。 取得当前企业号私信准入和正式消息协议后,先做文本单聊适配器;未获批前保持准备中。 |
| P1 | 钉钉 / 飞书 | 已有连接器,待真实账号验收 | 已有应用机器人事件与文本回复实现及各自配置指南。 | 事件订阅、应用发布、会话权限和消息回执尚未沉淀为统一验收单。 抽象机器人事件适配器,统一签名校验、消息去重、回复状态和人工转接。 |
| P1 | Telegram | 已有连接器,待真实账号验收 | 源码已有 Bot API 的凭据检查、Webhook secret、update_id 去重和文本回复适配器。 | 开发者文档目录尚未列出该适配器的凭据、Webhook 和限流边界。 把 Telegram 的 BotFather、Webhook、secret token、私聊和人工接管验收整理进统一文档。 |
| P1 | Slack | 已有连接器,待真实账号验收 | 源码已有 auth.test、Events API 签名校验、事件去重和 chat.postMessage 适配器。 | 开发者文档目录尚未列出 Events API、Message Content 权限和频道边界。 补充 Slack 应用安装、签名验证、事件回调、频道 / 私聊策略和人工接管验收。 |
| P1 | QQ 机器人 | 已有连接器,待真实账号验收 | 源码已有 QQ OAuth token、回调验签、消息发送和错误结果映射。 | QQ 机器人尚未进入开发者文档目录,群聊和私聊范围需要独立说明。 补充 QQ 开放平台应用、回调、access token、私聊 / 群聊范围和人工转接验收。 |
| P1 | WhatsApp Business | 已有连接器,待真实账号验收 | 已有 Cloud API 文本收发和 Business 号码凭据准备说明。 | 模板消息、会话窗口、媒体和业务结果回执未形成完整闭环。 先完成 Cloud API 文本单聊和人工接管,再按模板审批结果开放模板与媒体。 |
| P2 | Facebook / Instagram | 已登记,尚无收发连接器 | 已有准备表单和两类授权边界说明,尚未实现主页或专业账号消息适配器。 | Page / Professional Account 授权、私信、评论和人工窗口未接通。 在获得正式应用审核后优先支持 Page / Professional Account 文本私信,评论与媒体另行排期。 |
| P2 | LINE Official Account | 已有连接器,待真实账号验收 | 已有签名校验、Push 文本回复、重试身份核对和七天窗口策略。 | 媒体、群聊和完整 Reply Token 体验不在当前范围,需明确产品边界。 先完成单聊文本的生产账号验收,把媒体和群聊作为独立能力评估。 |
| P0 | 统一身份与回调网关 | 已有连接器,待真实账号验收 | 已有访客身份、事件签名、通知去重、分页和账号隔离相关接口。 | 各渠道仍可能分别维护 uid / OpenID / phone / externalMessageId,缺少跨渠道规范化映射。 建立 channelIdentity、conversationBinding、inboundEvent 和 deliveryReceipt 四类持久记录,统一未知结果和重试。 |
| P0 | CRM / 订单 / 工单业务桥 | 已有连接器,待真实账号验收 | 已有客户、工单、知识、智能体和业务回调操作;均要求服务端权限与真实回执。 | 渠道消息与客户、订单、工单之间的关联键、幂等键和完成条件还没有统一。 选择一个真实报修或预约场景,贯通收集、核实、受控执行、持久回执、转人工和结果确认。 |
| P0 | 路由、分配与人工接管 | 已具备基础能力 | 已有转人工、客服组、负责人和服务记录能力。 | 意图、客户等级、坐席能力、负载和熟客规则尚未统一成可解释的分配策略。 把路由决策、人工负责人、接管时间和客户通知写入同一会话记录,并支持回放。 |
| P1 | 接入健康与业务结果观测 | 已具备基础能力 | 已有服务记录、回调日志、计费和结果页面,但接入状态仍需要按证据分层。 | 配置成功、消息被平台接受、业务执行成功、客户确认解决尚未完全分开统计。 以每日聚合保留接入成功率、未知回执、转人工率、业务完成率和客户确认率,原始事件按保留策略归档。 |
| 暂缓 | 非主流与已退出市场渠道 | 暂不纳入 | 目录中仍保留历史资料入口,但没有把资料筹备标成可用连接器。 | 淘宝闪购、POPO、旧式评价回复等非实时客服渠道不进入本轮主流连接器排期。 仅保留文档和迁移说明,不计入主流接入完成率;只有出现明确客户需求、官方协议和验收账号时再单独立项。 |
先补齐四层基础能力
- 身份层:每个渠道保存自己的 externalUserId、OpenID、手机号或账号标识,并映射到租户内的客户 ID;不能按姓名合并客户。
- 消息层:原始入站事件先落盘,完成签名、时间窗口、租户和来源校验,再用 externalEventId 去重;回复要分别记录平台接受、明确拒绝和未知结果。
- 接管层:记录路由原因、客服组、负责人、接管时间和客户通知;人工接管后停止 AI 自动发送,撤权后停止渠道写入。
- 业务层:用幂等键连接客户、订单、工单和业务回执;执行失败、待审批和未知结果都保持待跟进,不能把模型成功或消息发送成功当成业务完成。
每个主流渠道的最小验收单
| 阶段 | 必须看到的证据 | 不通过时的处理 |
|---|---|---|
| 授权 | 账号、应用、回调地址和权限可回读;撤权后令牌失效 | 保持准备中,不进入已接通 |
| 入站 | 真实用户消息带稳定外部 ID,原始事件可查询 | 检查签名、域名、版本和租户隔离 |
| 回复 | 平台返回可关联的 message ID 或明确接受状态 | 未知结果进入待核对,禁止盲目重复发送 |
| 人工 | 转人工后有负责人、时间和客户可见通知,AI 停止 | 回退到接待台人工处理并保留原会话 |
| 业务 | 客户 / 订单 / 工单操作有持久回执和最终确认 | 失败或待审批进入待跟进,不计入自动完成率 |
本轮主流范围
优先推进 Web / H5、微信小程序、微信客服 / 公众号、企业微信、钉钉、飞书、抖音企业号、WhatsApp、Facebook / Instagram 和 LINE。它们分别覆盖国内网页与微信生态、企业协作、短视频私信和海外主流消息场景。
淘宝闪购、POPO、旧式应用评价回复等没有稳定实时客服闭环的模块,本轮只保留资料与迁移边界,不计入主流接入完成率;只有出现正式协议、明确客户需求和可验收账号时再单独立项。
对照文档与进入方式
对方文档强调多渠道入口、访客身份、企业 API、回调鉴权、客户 / 订单资料和机器人会话等边界。本页把这些能力映射到云蝠现有的渠道、服务端操作和接待台,不会复制对方品牌或把对方接口当成云蝠接口。
按顺序交付
实现依据 · 仓库内路径
lib/developer-docs/mainstream-integration-coverage.tslib/developer-docs/integration-playbooks.tslib/developer-docs/developer-guide.ts
文档描述当前源码能力;不等于你的宿主或生产环境已通过验收。