14.2
Đưa tiện ích lên website
Sao chép đoạn mã trên thẻ tiện ích và dán trước thẻ body đóng ở mọi trang cần hiện nút trò chuyện.
<script src="https://api.ticketsx.xyz/widget.js" data-key="wk_your_key_here" defer></script>Cài đặt chỉ có vậy. Không phải tải gì, không thêm thư viện, và tiện ích được vẽ trong shadow root nên không đụng vào phần giao diện của bạn. Nó chạy trên HTML thuần, WordPress, Shopify, Webflow và mọi framework JavaScript.
Thuộc tính tùy chọn
| Tên | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
| data-key | string | bắt buộc | Khóa công khai của tiện ích. Sao chép từ bảng điều khiển. |
| data-position | left | right | tùy chọn | Nút nằm ở góc nào. Ghi đè thiết lập trên bảng điều khiển. |
| data-theme | auto | light | dark | tùy chọn | Cửa sổ sáng hay tối. Mặc định theo thiết lập hệ thống của khách. |
| data-locale | string | tùy chọn | Ép một ngôn ngữ, ví dụ de hoặc pt-BR. Mặc định theo trình duyệt. |
| data-launcher | auto | manual | tùy chọn | Đặt thành manual để ẩn nút nổi và mở trò chuyện từ phần tử của riêng bạn. |
Mở trò chuyện bằng nút của riêng bạn
Khi data-launcher là manual, tiện ích nằm im cho tới khi bạn gọi.
<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() mở cửa sổ.
- TicketsXChat.close() và TicketsXChat.toggle() làm đúng như tên gọi.
- TicketsXChat.isOpen() cho biết cửa sổ có đang mở không.
- TicketsXChat.on('message', handler) chạy khi có câu trả lời từ đội ngũ của bạn.