切换聊天窗的界面语言

对话链接打开后，按钮、提示、占位文字用哪种语言。默认跟着客户的设备走，也可以由你指定。

默认跟随客户的设备

不做任何设置时，聊天窗读客户设备或浏览器的语言。客户的语言不在你配置的语言清单里，就回退到渠道的默认语言，也就是 设置 > 渠道管理 > 多语言 清单里排在第一位的那个。

只面向国内客户投放的话，这样就够了。

指定语言用链接上的 lang 参数

对话链接不像网页接入那样有一段可以写死语言的接入代码，指定语言统一靠链接上的 lang 参数，官方域名和自有域名都一样。

最省事的做法是在工作台里选：链接与二维码 页有一个 链接语言 下拉，选好之后复制出来的链接和二维码就已经带上这个参数了。二维码的下载文件名也会带语言码，方便区分不同语言的物料。

要在 APP 里动态生成链接、或者批量做多语言物料时，自己拼也一样：

https://<链接域名>/?c=<渠道编号>&lang=en

取 BCP 47 语言标记，例如 zh-CN、zh-Hant、en、ja、pt-BR。填你在工作台配过的那几种语言即可。

带语言的链接可以放心分发

lang 参数打开后不会从地址栏消失。链接被收藏、转发、刷新之后，仍然是你指定的那个语言。

填了识别不了的值（例如 ?lang=日语、?lang=1）会回退到客户的设备语言，页面照常打开，不会报错也不会白屏。手拼二维码填错不至于出事故。

自有域名部署一样能用

自己的域名部署时，渠道编号写在页面文件里、链接上不带 c 参数，但 lang 照样生效：

https://你的域名/chat.html?lang=en

不需要按语言下载多份 chat.html。 同一个页面文件，链接上带不同的 lang 就是不同语言的入口。

运行时切换：只有自有域名用得上

自有域名部署时，页面是你自己的，可以在里面调 setLocale()：

window.hecongLink(function (hc) {
  hc.setLocale('en')
})

用官方域名生成的链接，页面由合从托管，你没有地方写这段代码，用 lang 参数指定即可。

语言的优先级

从高到低：

1. setLocale() 运行时设置（仅自有域名部署）
2. 链接上的 lang 参数
3. 客户设备或浏览器的语言

这会影响什么

lang 控制的是聊天窗自身的界面文字（输入框占位符、发送按钮、连接状态提示等）。

以下内容不由它决定：

内容	由谁决定
欢迎语、公告条、快捷按钮文案	工作台 设置 > 渠道管理 > 多语言 里各语言的配置
客服真人发的消息	客服本人所写，可在工作台开启翻译
AI 机器人的回复语言	机器人配置里的回复语言策略

也就是说，要让客户获得完整的英文体验，除了链接上的 lang，还需要在工作台为英文配置一套渠道文案。

下一步

• 深色模式 —— 让整页跟随客户的深浅色偏好
• 接口速查 —— 全部命令与参数