微信客服通过API接入不用写代码

作者：周屿｜更新于 2026-11-03

公司要把微信客服的咨询接到客服系统里，活派到开发手上。开发多半先去翻企业微信的接口文档，看微信客服通过 API 怎么接，回调怎么配，要写多少代码。

其实接进客服系统这一步，不用写代码。企业微信的超级管理员扫一次码，绑一个微信客服账号，消息就进来了。

开发真可能要动手的只有三处，而且都是可选的：小程序里自己放一个客服按钮，客服链接后面带上会员资料，把订单页嵌进客服回消息的页面。

自己调微信客服接口要做哪些

企业微信给微信客服开放了接口。客户发消息时，企业微信把一个事件推到你配好的网址。你收到以后，再调读取消息的接口（sync_msg）把内容拉回来，它能读最近 3 天的。

回消息调发送消息的接口（send_msg）。客户主动发消息之后 48 小时内能发，最多 5 条，客户再发一条才能接着回。

这只是把消息收进来、发出去。客服在哪儿看、在哪儿回、几个客服怎么分，这些页面还得自己做。

所以自己调接口，接口本身只管收和发，剩下这些都得自己写。公司要的如果只是「微信里的咨询有人接、能回」，没必要走这条路。

接进客服系统，扫码就通

以合从为例，管理员这样操作。

1. 打开「设置」>「渠道管理」，点「接入新渠道」。
2. 类型选「微信客服」，点「下一步」。
3. 点「前往企业微信授权」，在打开的授权页由企业微信的超级管理员扫码。

分级管理员扫了也会显示授权成功，可是收不到消息，这是最容易出岔的地方。授权链接 20 分钟就失效，失效了回来重新点一次。

授权完回到工作台，就是客服回消息的那个页面，选一个微信客服账号绑上，两种都行。

• 新建一个。名称最多 16 个字符，客户在微信里看到的就是这个名字。
• 绑企业微信里已经在用的。原来发出去的链接不用换。但绑了以后，企业微信里原来给它配的接待人员和规则就停了，挑没什么咨询的时候绑。

绑好后，页面停在「客服链接」这一页，默认链接已经生成。拿微信扫它的二维码发一句话，工作台里多一条对话，就通了。整个过程没有一行代码。

公众号、小程序、支付凭证这些入口怎么挂，见微信客服接入第三方客服系统的完整步骤。

以前用接口接过的，先看这条

微信规定，一个微信客服账号同一时间只能交给一家服务商管。账号交给谁，咨询就只进谁的系统。

所以先看原来那家接不接管会话。

• 只拿客服链接、做业务页面、不碰消息的，可以和合从共用一个账号，什么都不用改。
• 原来那家也在收发消息的，按账号分开。老账号继续给它，在合从新建一个账号，老账号和发出去的链接都不受影响。

还有一种情况，页面上一直提示「该企业的微信客服还在独立使用，暂时无法接入」。这是因为企业在微信客服自己的后台里用，合从走的是企业微信，要先切换到在企业微信里使用。

切换前要知道，原来自己通过接口接的系统，切换以后就收不到咨询了，正在聊的也会断。挑咨询少的时候切，切完马上绑。

开发要动手的三处

接通以后，下面三处按需要做，不做也能正常接待。

小程序里自己放按钮

只想让小程序原来的客服入口转到微信客服，在企业微信后台授权就行，不用代码。

要把按钮放在商品页、订单页，就在点击事件里调微信的接口：

wx.openCustomerServiceChat({
  extInfo: { url: '<客服链接>' },
  corpId: '<企业 ID>',
  success() {},
  fail(err) { console.error(err) }
})

客服链接和企业 ID 在工作台微信客服渠道的「小程序」页复制。企业 ID 还要先填进小程序后台的「功能」>「客服」>「微信客服」，没填过的打不开。这个接口要求小程序和企业微信是同一主体，企业微信完成企业验证，基础库 2.19.0 起支持，只能在用户点击时调。

让客服知道来的是谁

客户从微信客服进来，客服只看到一个微信昵称。在客服链接末尾追加 &scene_param=，把会员号、会员等级带进来，写进客户名片。

字段要先在工作台「设置」>「客户字段」里建好，没建的会被丢掉。name、phone、email、avatar 四个不用建。格式是 字段标识=值，用 & 连，整串编码一次：

wx.openCustomerServiceChat({
  extInfo: {
    url: `${客服链接}&scene_param=${encodeURIComponent('member_id=A1234&vip_level=gold')}`
  },
  corpId: '<企业 ID>',
  success() {}
})

公众号菜单、支付凭证这类入口，是在填进对方后台的链接末尾追加同样一段。各入口的链接在哪拿，见微信客服的二维码和链接在哪拿。

几处容易出岔。

• 内容编码前不能超过 128 字节，这是微信定的。超了整段丢，客户照常进来，也没有提示。一个汉字算 3 个字节，值用英文代号省地方。
• 链接本身一个字都不能改，只能在末尾追加。
• 客户微信里还没有这个客服会话时才会带。聊过的老客户再进来，参数不会更新。

带没带进来，在工作台这通对话右栏的「对话动态」里看最后一条。

这串参数明文挂在链接上，客户看得见也改得动，所以只用来展示，不当身份识别。身份证号、密码这类别传。

聊天时查订单

在「设置」左侧「客户」下面的「扩展页面」，把你自己的订单页网址填进去，客服回消息的页面右边就能打开它。

页面要 https，服务器要允许工作台嵌入：

Content-Security-Policy: frame-ancestors https://workpro.aihecong.com

页面会收到当前对话的信息，channelPlatform 是 wechat_kf，就知道是微信客服来的。查到的内容可以填进客服输入框，也可以直接发出去。

微信客服对话一条文字最多 2048 字节，超了工作台直接拒绝。发的时候带上 conversationId，不然客服切了对话，A 客户的订单会发给 B。协议细节见开发一个扩展页面。

这几件做不到

排方案前先对一下。

• 你的服务器调合从的接口：不提供。
• 合从把消息推到你的服务器：只有 APP 渠道的离线消息通知，其他不推。
• 用代码替客户发消息：做不到。
• 指定分给某一位客服：做不到，只能到技能组。

网站、对话链接、APP 这几种入口能做的多一些，见在线客服系统对接自己的系统能做到哪一步。

下一步，先约超级管理员扫码，新建一个账号绑上，自己扫码发一句试试。跑通了，再看这三处里哪处真用得上。

常见问题

对接企业微信时，微信客服要切换使用方式吗？

微信客服是企业微信提供的对外客服身份，客户不用加好友就能聊。合从通过企业微信接入，所以要在企业微信里使用微信客服；还在微信客服独立后台用的，先切换，做法见上面「以前用接口接过的」那一节。

视频号小店的咨询也能这样接吗？

能。在视频号小店后台「店铺管理」>「客服管理」里接入微信客服，由小店超级管理员扫码。之后客户在商品详情页、订单详情页联系客服，对话也进工作台，同样不用写代码。

AI 机器人能接微信客服的咨询吗？

能。在微信客服渠道左侧选「AI 机器人」，绑一个机器人先接待，答不上来再转人工。一个渠道只能绑一个机器人。