i18n国际化
H5访客端国际化配置
微语H5访客端支持多语言国际化,可以根据不同地区用户的需求提供本地化的界面和文本内容。
支持的语言
语言代码 | 语言名称 | 说明 |
---|---|---|
zh-cn | 简体中文 | 中国大陆地区使用 |
zh-tw | 繁体中文 | 中国台湾地区使用 |
en | 英文 | 国际通用英文 |
设置方法
1. URL参数设置
在访客端聊天页面URL中添加 lang
参数来指定语言:
# 设置为简体中文
https://127.0.0.1:9003/chat?lang=zh-cn
# 设置为繁体中文
https://127.0.0.1:9003/chat?lang=zh-tw
# 设置为英文
https://127.0.0.1:9003/chat?lang=en
2. 参数说明
参数名 | 类型 | 说明 | 默认值 |
---|---|---|---|
lang | string | 语言设置("zh-cn"/"zh-tw"/"en") | "zh-cn" |
- zh-cn: 简体中文界面,适用于中国大陆用户
- zh-tw: 繁体中文界面,适用于中国台湾、香港、澳门用户
- en: 英文界面,适用于国际用户
3. 完整示例
# 为英文用户设置聊天界面
https://127.0.0.1:9003/chat?org=your_org_id&t=1&sid=workgroup_id&lang=en&nickname=John&visitorUid=user001
# 为繁体中文用户设置聊天界面
https://127.0.0.1:9003/chat?org=your_org_id&t=1&sid=workgroup_id&lang=zh-tw&nickname=用戶&visitorUid=user002
国际化内容
设置语言后,以下界面元素会自动切换到对应语言:
-
界面文字
- 导航栏标题
- 按钮文字(发送、上传等)
- 提示信息
- 错误信息
-
功能标签
- 消息状态(发送中、已送达等)
- 时间格式
- 文件上传提示
- 表情选择器
-
交互提示
- 输入框占位符文字
- 留言表单标签
- 评价功能文字
- 机器人应答文字
注意事项
- 默认语言: 如果未指定
lang
参数,系统将使用简体中文作为默认语言 - 浏览器兼容: 建议在所有主流浏览器中测试国际化效果
- 自定义内容: 客服发送的消息内容不会自动翻译,需要客服人员根据访客语言手动输入对应语言的回复
- 机器人对话: 如需机器人支持多语言,需要在后台配置对应语言的知识库内容