把挂件加到网站上

从挂件卡片复制代码，粘贴到每个需要显示聊天按钮的页面上，位置在 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) 会在你的团队回复送达时触发。