Appearance
自有域名部署
下载一个页面文件传到你的网站，客户访问的就是你自己的域名。页面归你，客服程序作为插件嵌在里面。工作台上这一档叫 使用自己的域名，标着 推荐。
文件在工作台点一下就能下载，但把它传到你的域名上并保持可访问，需要你的网站运维来做。合从提供的是这个文件和里面的客服程序，不代做域名解析、证书和上传部署。如果你不负责网站维护，把这一页转给你的网站运维即可。
这是什么
工作台会生成一个几 KB 的 HTML 文件，里面写好了你的渠道编号和加载客服程序的地址。把它传到你的网站上，客户打开这个地址就进入了对话页面。
和默认链接比，有三点实际差异：
- 页面底部不展示主体公示信息和投诉入口
- 合从不限制在微信、QQ 等应用里打开，能不能打开取决于这些平台自己的风控
- 域名的持续可用与合规由你负责
完整对比与责任划分见接入形态选型。
开始之前
- 已经创建了对话链接渠道，参见默认链接接入的创建步骤
- 有一个自己的域名，以及能存放静态文件的地方（网站服务器、对象存储或 CDN）
- 上传和后续维护有人负责 —— 你自己能改网站，或者能长期联系到你的网站运维
不需要事先获取默认链接，也不需要确认默认链接使用规则，两条路径互不依赖。实名认证是账号层面的要求，用自己的域名同样要做，但它不卡你这边的访问 —— 认证还在审的时候，客户在你的页面上照样能发消息。
部署分工
| 这一步 | 谁做 |
|---|---|
| 下载页面文件 | 你，在工作台点一下 |
| 准备域名、证书，把文件传上去并保持可访问 | 你的网站运维 |
| 客服程序本体、功能更新与后端服务 | 合从，自动完成 |
运维不需要合从的账号，拿到文件就能开始。
第一步：下载页面文件
在 设置 > 渠道管理 中，选择你的对话链接渠道。
在左侧配置项中选择 接入 分组下的 链接与二维码。
找到 使用自己的域名 区域，选择 下载页面文件。
你会得到一个名为 chat.html 的文件。它里面已经填好了你的渠道编号，不需要你改任何内容就能用。
第二步：传到你的网站
把 chat.html 传到你网站上任意能被访问到的位置。传完之后的访问地址取决于你放在哪里：
| 放在哪里 | 客户访问的地址 |
|---|---|
| 网站根目录 | https://你的域名/chat.html |
子目录，例如 /kefu/ | https://你的域名/kefu/chat.html |
地址不需要带任何参数。 渠道编号已经写在文件里了，直接把上面的地址发给客户即可。
放在现有网站的一个路径下最省事，不用另外做域名解析。想要更短更好记的地址、准备印在物料上，可以让运维单独解析一个 kefu.你的域名.com 指向存放位置，代价是多一步 DNS 配置。
网站服务器、对象存储、CDN 的上传方式各不相同，这一步交给你的网站运维。转过去时把下面几条一并说清楚：
- 这是一个静态 HTML 文件，放到能公开访问的位置即可，不需要后端环境
- 你希望客户访问的地址是哪一个，文件就放在对应位置
- 站点如果还是 HTTP，客户会看不到语音按钮，文字和图片不受影响
- 文件原样上传，不要压缩或转码
- 站点如果配了内容安全策略，按后面给出的域名清单放行 —— 配没配，运维那边清楚
文件名可以改
chat.html 只是默认名字，前面的名字随便改，.html 后缀留着就行。改名不影响功能，渠道编号在文件内容里，不在文件名上。
这件事的实际用处是：一个域名可以放多个渠道的页面，不用为每个渠道单独准备域名。比如你分了售前、售后、投诉三个渠道，就在工作台各自下载一份文件，改成不同的名字传到同一个网站：
| 渠道 | 文件名 | 发给客户的地址 |
|---|---|---|
| 售前咨询 | presale.html | https://你的域名/presale.html |
| 售后服务 | service.html | https://你的域名/service.html |
| 投诉建议 | feedback.html | https://你的域名/feedback.html |
每份文件里写的是各自渠道的编号，客户从哪个地址进来，对话就落到哪个渠道，工作台里能按渠道区分来源和分配客服。
放进子目录效果一样，https://你的域名/kefu/presale.html 也行，看你的网站结构怎么规划方便。
想要最短的地址，把文件改名成 index.html 放在根目录，访问地址就是纯域名 https://你的域名/。
改名成 index.html 前先确认根目录没有别的页面
根目录的 index.html 通常是你的官网首页。传上去会覆盖原有首页，网站访客将直接看到聊天页面。只有在这个域名或子域名专门用于客服入口时才这么做，例如单独解析一个 kefu.你的域名.com。
第三步：发给客户
用手机打开这个地址确认能正常聊天，然后就可以投放了。短信、邮件签名、公众号菜单、社交媒体主页都可以放，也可以自己生成二维码印在物料上。
发一条消息，它会出现在客服工作台的对话列表里，和其他渠道进来的咨询排在一起。
文件里哪些能改，哪些不能
文件下下来不改就能用。想换标签页名字或背景色，再照下面改，改动同样由你的网站运维执行。文件里有中文注释标出了分区，可以对照着看。
可以改：
| 位置 | 作用 |
|---|---|
<title> | 浏览器标签页上显示的名字，改成你的公司或店铺名 |
lang 属性 | 页面语言标记，供搜索引擎和读屏软件识别 |
background | 页面背景色 |
<meta name="robots"> | 默认不让搜索引擎收录，想被搜到就删掉 |
| 文件末尾的脚本区域 | 传客户资料、对接你自己的接口，见传客户资料给客服 |
lang 属性跟聊天窗的界面语言是两回事，后者见切换界面语言。
这两行不要改
window.__hcLink 里的 channelId 是你的渠道编号，改了就连不上。下面那行 <script src="..."> 是客服程序本体，改了页面会加载不出来。
不需要登记域名，但内容安全策略要放行
对话链接不做域名校验，你把 chat.html 放在哪个域名下都能用，不用回工作台登记。
有一种情况例外：站点配了全站内容安全策略（CSP），页面会打开，但客服程序连不上。这时要放行下面几项，这段配置直接转给你的网站运维：
script-src https://*.aihecong.com
connect-src https://*.aihecong.com wss://*.aihecong.com
img-src https://*.aihecong.com data: blob:
style-src 'unsafe-inline'
media-src https://*.aihecong.com blob:connect-src 的 https 和 wss 两条都要写，只写 https 会表现为页面能打开、发不出消息。
升级不需要重新下载
文件里只有一个固定的加载地址，真正的客服程序在客户打开页面时才加载。功能更新和问题修复会自动生效，你不需要重新下载或替换文件。
一次部署长期有效。只有在换渠道或换域名时才需要重新处理。
后续维护由你负责
部署到自己的域名，意味着入口这一段由你自己维护：
- 域名要按期续费，过期后客户就打不开了
- 站点用了 HTTPS 的话，证书别忘了续期
- 存放文件的服务要维持，网站服务器、对象存储或 CDN 任何一项停用或欠费，页面同样访问不了
- 域名的合规要求由你履行，备案、内容合规等按当地法规办理
- 微信这些平台的风控由你处理。合从不做拦截，但域名被对方标记风险或屏蔽时，需要你自己去申诉
如果你本来就有网站，这些是日常运维的一部分。如果是专门为客服入口注册的域名，需要安排人长期负责。
页面打不开时先查自己这一侧
整页打不开、白屏、浏览器报域名错误，属于域名或站点问题，先联系你的域名服务商或网站运维。反过来，聊天窗已经出来了却一直转圈或显示报错文字，那是合从这一侧，带上报错文字联系技术支持。判断依据就是聊天窗有没有出现，详见故障排查。
常见问题
传上去之后打开是空白页
症状：地址能访问，但页面一片空白，没有聊天窗。
成因：常见的两种是文件内容在上传过程中被改动（例如被工具压缩或转码），以及页面所在位置无法访问外部资源。
解决：重新下载一份原始文件直接上传，不要用任何工具处理。上传后用浏览器打开页面，按 F12 查看控制台是否有资源加载失败的提示，把提示内容提供给你的网站运维。
能不能把这个页面嵌进我现有的网页里
症状：希望客服入口出现在已有页面上，而不是一个单独的页面。
成因：chat.html 是一个独立的整页，用途是「打开就进入对话」。
解决：需要在现有网页上显示咨询入口，用网页接入渠道，它提供的是贴进页面的聊天窗代码，两种渠道可以同时使用。
换了域名之后老链接还能用吗
症状：网站换域名或换存放位置后，之前发出去的地址是否失效。
成因：客户访问的是你的域名，地址由你控制，合从这边不做记录。
解决：老地址能不能继续访问取决于你的域名和站点设置。需要保留就在旧地址上配置跳转，指向新地址。渠道和历史对话不受影响，换的只是入口地址。
下一步
- 小程序接入 —— 嵌进小程序，客户不用跳出去
- 传客户资料给客服 —— 让客服看到客户的真实身份而不是匿名访客
- 商品、订单与文章选择器 —— 客户点几下把要问的那一件发给客服
- 故障排查 —— 打不开时怎么定位是哪一侧的问题
- 接入形态选型 —— 回顾两种形态的责任划分