Qiabot外掛介面使用文件
一. 多語言使用說明
支援語言列表
目前系統支援以下語言（語言代碼: 說明）：
- zh-CN：簡體中文
- zh-TW：繁體中文
- en-US：英語（美國）
- ar-SA：阿拉伯語
- bn-BD：孟加拉語
- de-DE：德語
- es-ES：西班牙語
- fr-FR：法語
- he-IL：希伯來語
- hi-IN：印地語
- id-ID：印尼語
- ja-JP：日語
- ko-KR：韓語
- mr-IN：馬拉地語
- pt-BR：葡萄牙語（巴西）
- ru-RU：俄語
- sw-KE：斯瓦希里語
- tr-TR：土耳其語
- ur-PK：烏爾都語
- vi-VN：越南語
系統會自動讀取瀏覽器的語言設定。
如果瀏覽器語言不在以上列表中，則預設使用簡體中文（zh-CN）。
此外，也可以透過在 URL 中新增 lang 這個 querystring 參數手動指定語言，例如： ?lang=en-US。
二. 傳遞顧客自訂屬性
自訂屬性需要在下面這裡預先定義好(只有 name 屬性不需要自訂)，否則會被忽略。
「聊天連結」示例
透過給連結新增 custom_attr(或metadata，相容舊版) 參數來傳遞顧客的自訂屬性資訊到工作台。
示例：
注意: custom_attr 中，key 和 value 都要加上雙引號
https://dzz.qbchat.cc/?name=老王&custom_attr={"dep":
["sales"],"age":19,"vip":"gold"}
注意：如果你要在 custom_attr 中新增帶有 & 或者 = 的資料，那麼你需要先對它們進行轉義
& %26
= %3D
正確
https://dzz.qbchat.cc/?custom_attr={"dep":
["sales"],"age":19,"vip":"gold","address":"http://xyz.qiabot.com?
a%3D1%26b%3D2"}
錯誤
https://dzz.qbchat.cc/?custom_attr={"dep":
["sales"],"age":19,"vip":"gold","address":"http://xyz.qiabot.com?a=1&b=1"}
三.「網頁外掛」示例
在下面的外掛代碼的基礎上略做修改即可
```jsx
<script>
(function (d, t) {
......(中略)
g.onload = function () {
window.ChatWidget.init({
baseUrl: BASE_URL,
position: 'right',
// 可以如下新增使用者屬性資訊，其中 name 是系統自帶的，不需要預先自訂
// name: "老王",
// custom_attr(或 metadata，相容舊版): {"age": "22", "vip": "gold"}
});
}
})(document, "script");
</script>
```
四. 同步顧客身份
以下特殊屬性會同步顧客身份，即值相同的顧客會被合併
identifier
這裡的identifier 來自於你的產品自己的使用者系統
請千萬不要隨意傳這個欄位，否則會出現多個顧客因為參數相同被識別成同一個顧客並相互串訊息的情況！
「聊天連結」示例
傳遞參數時，只要參數的值是相同的，即視為同一個顧客，系統會自行執行合併。
https://dzz.qbchat.cc/?identifier=123abc&phone=18088888888
「網頁外掛」示例
在下面的外掛代碼的基礎上略做修改即可
```jsx
<script>
(function (d, t) {
......(中略)
g.onload = function () {
window.ChatWidget.init({
baseUrl: BASE_URL,
position: 'right',
// 可以如下同步顧客身份
// identifier: "使用者ID",
});
}
})(document, "script");
</script>
```