切换聊天窗的界面语言

让聊天窗口的按钮、提示、占位文字跟着你网站的语言走。访客在你站点上切到英文，聊天窗也跟着变英文。

什么时候用

• 你的网站是多语言站点，有语言切换器
• 你希望聊天窗默认语言由你决定，而不是跟随浏览器设置

如果你的网站只有中文，聊天窗默认会读访客的浏览器语言，通常不需要额外处理。

设定初始语言

在接入代码上加 data-language：

<script async
  src="https://assets.aihecong.com/sdk/hecong.js"
  data-channel-id="0190a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"
  data-language="en">
</script>

取 BCP 47 语言标记，例如 zh-CN、zh-Hant、en、ja、ko。填入无法识别的值时会回退到浏览器语言，不会导致聊天窗出错。

运行时切换

网站切换语言时调用 setLocale()：

window.hecong(function (hc) {
  document.getElementById('lang-switch').addEventListener('change', function (e) {
    hc.setLocale(e.target.value)
  })
})

聊天窗未打开时调用同样有效，打开时会以新语言呈现。

语言的优先级

从高到低：

1. setLocale() 运行时设置
2. 接入代码里的 data-language
3. 访客浏览器的语言设置

这会影响什么

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

以下内容不由它决定：

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

也就是说，要让访客获得完整的英文体验，除了这里的 setLocale，还需要在工作台为英文配置一套渠道文案。

下一步

• 接入代码与配置项 —— data-language 与其他属性的完整说明