跳至主要内容

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. 機器人對話: 如需機器人支援多語言,需要在後台配置對應語言的知識庫內容

这页文档对您有帮助吗?