YundaDesk有些卖家的客服入口根本不是网页——是自家小程序里的一个“联系客服”按钮,是自研 App 里的一条消息通道,是某个内部系统里嵌的一块聊天区域。这些场景,官方渠道插件基本用不上,能用的只有一种东西:自定义 API。
这篇讲清楚一件事:怎么用自定义 API 渠道,把 AI 客服接进你自己的应用,而不是被迫塞进一个别人做好的挂件里。
对自定义渠道来说，关键不只是消息能不能进系统，而是 API 有没有把客户身份、订单上下文和转人工线索一起带进来。否则只是换了一个收消息入口，AI 和坐席仍然要从零开始判断。
自定义 API 客服：裸消息 vs 带上下文会话
什么时候该用自定义 API,而不是现成挂件
现成的聊天挂件适合大多数独立站,几行脚本就能跑起来。但下面几种情况,挂件就不够用了:
- 客服入口在小程序或原生 App 里,不是标准网页,挂件的 JS 脚本装不进去;
- 客服功能需要嵌进已有的内部系统(比如订单管理后台、ERP 客户模块),界面样式必须完全自定义;
- 需要在客户发消息之前,先把订单号、会员等级这些业务数据一起传过去,而不是等客户自己打字说清楚;
- 已经有一套自己的消息通道(比如小程序客服消息、App 内推送),想直接接进去,不想让客户再跳转到另一个窗口。
这些场景的共同点是:客服体验要长在你自己的产品里,而不是外挂一个别人的组件。自定义 API 渠道解决的正是这个问题——它不提供现成界面,只提供一套接口,让你自己的前端调用,把 AI 客服的能力嵌进任何地方。
自定义 API 渠道到底是什么
简单说,这是一个 headless(无界面)的客服接口。你的前端(小程序、App、内部系统)负责界面怎么长,自定义 API 负责背后的逻辑:接收客户发来的消息、把消息交给 AI 客服处理、返回 AI 的回复,或者在需要时把会话转给人工。
对开发团队来说,这条渠道跟接一个普通的消息 API 差不多:发消息、收消息、维护会话状态。区别在于,这个接口背后连着完整的 AI 客服能力——知识库检索、答不上自动转人工、跨境 CRM 记录客户信息,这些都不用自己再造一遍。
接入要传什么数据,才能让 AI 答得准
自定义 API 接入最容易被忽略的一步,不是技术对接,而是数据规划。AI 客服答得准不准,很大程度上取决于你在调用接口时传了多少上下文。
建议至少传这几类字段:
| 字段类型 | 示例 | 作用 |
|---|---|---|
| 客户标识 | 用户 ID、会员号 | 跨渠道识别同一客户,合并档案 |
| 语言/地区 | 语言代码、国家 | AI 自动跟随客户语言应答 |
| 业务上下文 | 当前订单号、商品 ID | AI 直接调取相关信息,不用客户重复说 |
| 会话来源 | 小程序页面、App 版本 | 排查问题、区分渠道效果 |
如果客户是在订单详情页点的“联系客服”,把订单号一起传过去,AI 客服就能直接说“您这单是 3 月 25 日发出的”,而不是先反问“请问您的订单号是多少”。这一步做好了,自定义 API 渠道的体验能比通用挂件更顺——因为它天生就嵌在业务场景里,拿数据比挂件更方便。
AI 先答,答不上就转人工
不管客户是从小程序、App 还是内部系统发起对话,自定义 API 渠道走的都是同一套接答逻辑:AI 客服先从知识库找依据自动回复,遇到答不上、客户主动要求人工、或者涉及退款赔付这类高风险场景,立刻转交人工——AI 不会硬撑到底,也不会替你拍板执行退款。
这一点在自定义渠道里格外重要,因为很多团队接入自研系统的初衷就是处理复杂业务(比如会员权益纠纷、批量订单问题),这类场景本身高风险问题占比更高,转人工的时机和体验要提前设计好,别让客户在自己的 App 里被 AI 卡住出不去。
转人工之后,数据不断线
自定义 API 接进来的会话,不是一个孤立的消息流。它和网站挂件、WhatsApp、邮件等其他渠道一样,汇入同一个共享工作台。这意味着:
- 坐席接手时能看到 AI 之前的完整对话记录,不用客户从头再说一遍;
- AI 和人工在同一个会话窗口里一键切换,客户感觉是“换了个人接”,而不是被扔进另一个系统;
- 同一个客户如果之前在网站或 WhatsApp 上联系过,身份会自动合并,标签和历史一起带过来。
对自研系统来说,这一点尤其有价值——很多团队原本各渠道数据是割裂的,自研 App 一套记录、网站一套记录,客户换个入口就得重新自我介绍。接进同一个工作台之后,这个问题不用靠人工拼接。
跨境场景:语言、时区自动落到客户档案
出海团队的自研应用,客户往往分布在不同国家。自定义 API 渠道接入时把语言、地区信息带过去后,YundaDesk 的跨境 CRM 会把国家、语言、时区作为出厂字段自动记录,AI 客服应答时自动跟随客户使用的语言,不需要额外配置多语言逻辑。
这意味着同一套自定义 API 接口,不用为每个语言市场单独接一遍——客户用哪种语言发消息,AI 就用哪种语言回,时区信息也会自动落到客户档案里,供后续主动触达时参考静默时段护栏。
接进去之后,坐席经验怎么变成 AI 的能力
自研系统里处理的问题,往往比标准渠道更复杂——可能涉及具体的业务规则、内部审批流程。这类经验如果只留在坐席脑子里,新人接手就得从头摸索。
YundaDesk 的做法是:AI 没答上、坐席补答、或者坐席主动纠正 AI 的回复,系统会生成一条待确认学习建议,老板或主管在评审台看过、采纳后才生效,沉淀为技能、知识或客户记忆。每条建议都可追溯来源、可测试效果、可一键回滚——越用越聪明不是自动发生的,而是团队认可了才算数。
这套闭环放到自定义 API 渠道上格外实用,因为这里承接的往往是最贴近你自己业务的对话,沉淀下来的能力也最难被通用工具替代。
自定义 API 渠道要解决的问题很具体:客服入口不在标准网页上,又不想因此把这部分对话变成孤岛。接口本身不难对接,真正决定效果的是数据规划和后续的转人工、跨渠道识别、学习闭环有没有接进同一套系统。把这几件事做对,AI 客服就能装进你自己的任何应用里,而不是被局限在一个挂件的框里。