Tài liệu

Nắm TicketsX nhanh hơn

Hướng dẫn thiết lập, toàn bộ danh sách lệnh, tính năng Premium và REST API, gom về một chỗ.

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ênKiểuBắt buộcMô tả
data-keystring
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-positionleft | 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-themeauto | 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-localestring
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-launcherauto | 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.