把小工具加到網站上

從小工具卡片複製程式碼，貼到每個需要顯示聊天按鈕的頁面，位置在 body 結束標籤之前。

<script src="https://api.ticketsx.xyz/widget.js" data-key="wk_your_key_here" defer></script>

安裝就這樣。沒有要下載的東西，也不引入任何相依套件，小工具在 shadow root 裡繪製，所以不會跟你的樣式打架。純 HTML、WordPress、Shopify、Webflow 以及任何 JavaScript 框架上都能用。

選用屬性

名稱	型別	必填	說明
data-key	string	必填	小工具的公開金鑰，從控制台複製。
data-position	left \| right	選填	按鈕放在哪個角落，會覆蓋控制台裡的設定。
data-theme	auto \| light \| dark	選填	淺色或深色視窗。預設跟著訪客的系統設定。
data-locale	string	選填	強制使用某種語言，例如 de 或 pt-BR。預設跟著瀏覽器。
data-launcher	auto \| manual	選填	設成 manual 可以隱藏浮動按鈕，改由你自己的元素打開聊天。

用自己的按鈕打開聊天

把 data-launcher 設成 manual 後，小工具在你呼叫之前不會出現。

<script src="https://api.ticketsx.xyz/widget.js" data-key="wk_your_key_here" data-launcher="manual" defer></script>
<button onclick="TicketsXChat.open()">Contact support</button>

TicketsXChat.open() 打開聊天視窗。
TicketsXChat.close() 和 TicketsXChat.toggle() 就是字面上的意思。
TicketsXChat.isOpen() 會回報視窗是否開著。
TicketsXChat.on('message', handler) 會在你的團隊回覆送達時觸發。