开发者文档中心

OpenAPI进入控制台

第三方渠道与业务模块 · 2026-10-31

主流接入覆盖与补齐计划

把主流渠道从“有文档”推进到“可收发、可接管、可核对业务结果”,并明确本轮暂缓的非主流模块。

当前覆盖矩阵

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

先补齐四层基础能力

  1. 身份层:每个渠道保存自己的 externalUserId、OpenID、手机号或账号标识,并映射到租户内的客户 ID;不能按姓名合并客户。
  2. 消息层:原始入站事件先落盘,完成签名、时间窗口、租户和来源校验,再用 externalEventId 去重;回复要分别记录平台接受、明确拒绝和未知结果。
  3. 接管层:记录路由原因、客服组、负责人、接管时间和客户通知;人工接管后停止 AI 自动发送,撤权后停止渠道写入。
  4. 业务层:用幂等键连接客户、订单、工单和业务回执;执行失败、待审批和未知结果都保持待跟进,不能把模型成功或消息发送成功当成业务完成。

每个主流渠道的最小验收单

阶段必须看到的证据不通过时的处理
授权账号、应用、回调地址和权限可回读;撤权后令牌失效保持准备中,不进入已接通
入站真实用户消息带稳定外部 ID,原始事件可查询检查签名、域名、版本和租户隔离
回复平台返回可关联的 message ID 或明确接受状态未知结果进入待核对,禁止盲目重复发送
人工转人工后有负责人、时间和客户可见通知,AI 停止回退到接待台人工处理并保留原会话
业务客户 / 订单 / 工单操作有持久回执和最终确认失败或待审批进入待跟进,不计入自动完成率

本轮主流范围

优先推进 Web / H5、微信小程序、微信客服 / 公众号、企业微信、钉钉、飞书、抖音企业号、WhatsApp、Facebook / Instagram 和 LINE。它们分别覆盖国内网页与微信生态、企业协作、短视频私信和海外主流消息场景。

淘宝闪购、POPO、旧式应用评价回复等没有稳定实时客服闭环的模块,本轮只保留资料与迁移边界,不计入主流接入完成率;只有出现正式协议、明确客户需求和可验收账号时再单独立项。

对照文档与进入方式

对方文档强调多渠道入口、访客身份、企业 API、回调鉴权、客户 / 订单资料和机器人会话等边界。本页把这些能力映射到云蝠现有的渠道、服务端操作和接待台,不会复制对方品牌或把对方接口当成云蝠接口。

按顺序交付

实现依据 · 仓库内路径
  • lib/developer-docs/mainstream-integration-coverage.ts
  • lib/developer-docs/integration-playbooks.ts
  • lib/developer-docs/developer-guide.ts

文档描述当前源码能力;不等于你的宿主或生产环境已通过验收。