跳到主要内容

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. 参数说明

参数名类型说明默认值
langstring语言设置("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

国际化内容

设置语言后,以下界面元素会自动切换到对应语言:

  1. 界面文字

    • 导航栏标题
    • 按钮文字(发送、上传等)
    • 提示信息
    • 错误信息
  2. 功能标签

    • 消息状态(发送中、已送达等)
    • 时间格式
    • 文件上传提示
    • 表情选择器
  3. 交互提示

    • 输入框占位符文字
    • 留言表单标签
    • 评价功能文字
    • 机器人应答文字

注意事项

  1. 默认语言: 如果未指定 lang 参数,系统将使用简体中文作为默认语言
  2. 浏览器兼容: 建议在所有主流浏览器中测试国际化效果
  3. 自定义内容: 客服发送的消息内容不会自动翻译,需要客服人员根据访客语言手动输入对应语言的回复
  4. 机器人对话: 如需机器人支持多语言,需要在后台配置对应语言的知识库内容

这页文档对您有帮助吗?