抖音小程序客服接入，开发要做哪些

作者：周屿｜更新于 2026-10-25

运营那边说，抖音小程序上要有个客服入口，用户点进去就能跟真人聊。活最后落到写小程序的开发手上。去搜抖音小程序客服开发，出来的多半是抖音自带的客服按钮，或者教用户怎么找官方客服，把自家客服系统放进小程序里的，讲得不多。

开发要做的其实不多：一项后台配置，两段代码。在抖音开放平台的「webview 域名」里加上你们自己的域名，新建一个页面，用 web-view 打开客服的对话页面，再把用户 ID 拼进地址，客服就知道是谁在问。

对话页面本身要放到你们自己的域名上，这一步归运维。下面按顺序走一遍。

先把活分清楚

这件事一共四样，不全是开发的。

要做的事	谁来做
把对话页面文件传到自己的域名上	运维
抖音开放平台里加 webview 域名、传校验文件	管开放平台账号的人配，文件还是运维传
小程序里加页面、拼地址	开发
客服程序本身的更新	客服系统自己管，小程序不用跟着发版

动手之前看两样东西。小程序得是企业主体，个人主体的用不了 web-view。还得有一个备案过的 HTTPS 域名，运维能往它的根目录传文件。缺一样，后面都做不下去，先去补。

为什么一定要自己的域名？客服系统一般会给一个现成的聊天网址，可那是客服系统的域名。抖音要你往域名根目录放一个校验文件，证明域名是你的。别人的域名你放不进去，也就加不进白名单。

用合从的话，这个对话页面是工作台里下载的一个 chat.html。工作台，指的是客服平时收发消息的页面。下载路径是这样：

1. 「设置」→「渠道管理」，点开对话链接渠道。对话链接可以理解成一个网址，客户点开它就进了聊天。
2. 渠道里面，左侧选「链接与二维码」。
3. 往下翻到「使用自己的域名」这块，按「下载页面文件」。

这个文件不用改，直接发给运维。传好以后，用手机浏览器打开 https://你的域名/chat.html，能聊天了再往下做。

这个网址除了放进小程序，也能贴进短信、印成二维码，对话页面除了嵌小程序还能放在哪，另一篇讲过。

在抖音开放平台加 webview 域名

登录抖音开放平台，进你的小程序，在开发配置里找「webview 域名」，把你的域名加进去。平台会给一个校验文件，放到域名根目录，能访问到了，再点校验。

校验文件和 chat.html 是同一种活，都是往网站上传一个文件，可以一次交给运维一起传。

只支持 HTTPS 的域名。菜单名字和位置抖音会调整，以你当时看到的界面为准。

抖音这边配好就生效，不用重新发版。支付宝不一样，支付宝小程序的接法，改完还要提审。每一步更细的说明，文档站上抖音小程序这一页有。

写一个只放 web-view 的页面

web-view 会铺满整个页面，把页面上别的东西都盖住，一个页面也只能放一个。所以别往首页的某一块里塞，单独建一个页面专门放它。

比如建一个 pages/support/index，ttml 里只写一行：

<web-view src="https://你的域名/chat.html"></web-view>

入口放在哪都行，首页、个人中心、商品详情页都可以。点了就跳过来：

tt.navigateTo({ url: '/pages/support/index' })

把用户是谁带过去

什么都不带，客服看到的就是一个匿名访客，分不出是哪位会员，要查订单得先开口要手机号。

登录的是谁，小程序自己清楚。客服页面 onLoad 的时候读出用户信息，ID 放进 u，昵称放进 n，拼到网址末尾：

Page({
  data: { url: '' },
  onLoad() {
    const user = tt.getStorageSync('user') || {}
    let url = 'https://你的域名/chat.html'
    if (user.id) {
      url += '?u=' + encodeURIComponent(user.id)
      if (user.name) url += '&n=' + encodeURIComponent(user.name)
    }
    this.setData({ url })
  },
})

这里先看一眼有没有 ID，有才往地址上拼。没登录的人读不到 ID，要是照样拼，地址上会变成 u=undefined，所有没登录的人都带着同一个 u，被当成同一个人。

ttml 里那一行的 src 跟着改成 {{url}}。客服打开对话，右边的客户档案里就是这个人的名字。

这几处容易出岔：

• u 一定要带。名字这些资料都挂在 u 上，只带名字不带 u，名字会被丢掉。
• 姓名、手机号这类参数，页面一打开就从地址栏清掉了，转发链接不会把手机号带出去。
• 昵称里有中文，记得 encodeURIComponent，示例里已经包了一层。

一人一个 u，不能共用。 有人调试时随手填个固定值就上线了，结果全部用户算成一个人，新进来的能翻到别人的聊天。取不到 ID 就干脆别拼 u，系统当匿名访客处理，彼此不会混在一起。

想让客服还看到会员等级这类自己的业务信息，用 d. 开头的参数，比如 d.member_level=gold。字段要先在工作台「设置」里「客户」下面的「客户字段」建好，没建过的会被丢掉，也不报错。

真机上过一遍

最容易骗人的是开发者工具。勾了「不校验合法域名」，页面怎么都能打开，到了真机才提示域名不在白名单。这个勾只管本地调试。

所以要拿真机试。抖音扫码打开，点客服入口，发一句话，看工作台那边收没收到。收到了，这条线就通了。

真机上有问题的，对照着查：

现象	查什么
提示域名不在白名单	回开放平台看域名还在不在 webview 域名列表里；用浏览器打开校验文件的地址，看它还在不在。校验文件被删，或者被网站的重写规则挡住，都会失效
后台加不了域名	多半是个人主体，或者域名没备案
页面能出来，聊天区一直加载	拿手机浏览器单独开一次 chat.html。要是浏览器里同样加载不出，毛病在对话页面那头；浏览器正常的，查 web-view 打开后有没有被重定向到另一个域名，重定向后的域名同样得登记

需要登记的只有 web-view 直接打开的域名。客服程序在页面里另外去连的服务器地址，开发不必管。

时间其实花在等文件上

代码就一个页面，加起来十几行，抖音那边配完当场生效。真正要等的是运维传那两个文件。

所以拿到活，先把 chat.html 下载下来发给运维，跟他说抖音还会给一个校验文件，到时一起传。运维在传的时候，你这边写代码。

还有一件事要跟运营说清楚：用户退出小程序以后，客服再回复，用户收不到提醒。消息不会丢，下次进来还能接着看。

公司要是同时做着微信、支付宝的小程序，可以看看几个小程序一起接时，客服系统怎么挑。

常见问题

抖音小程序客服多少钱一年？

价格按坐席算，标准版 399 元一个坐席一年，企业版 799 元。合从不提供免费版，新注册可以先用 7 天企业版，不收费。

个人主体的抖音小程序能接在线客服吗？

用这种嵌网页的接法不行。个人主体的抖音小程序用不了 web-view，要先把小程序主体变更为企业。

抖音小程序客服消息在哪里看？

在合从的工作台里。用户发的消息会出现在对话列表，和其他渠道进来的咨询排在一起，客服在同一个地方回。