Keyda API Tiện ích
Dành cho nhà phát triển, hoặc bất kỳ ai muốn khung trò chuyện mở ra từ nút của riêng họ.
Đang cài đặt
<script src="https://keyda.in/business/widget.js"
data-key="kb_live_your_key_here" async></script>The script tag needs only src and data-key. Everything else — colours, position, greeting, language — comes from your dashboard so you never have to redeploy your site to change them.
The widget is drawn in the language set on Install → Language your bot speaks: its button, placeholders and notices, and the direction of the layout (Arabic and Urdu are right-to-left). The strings arrive with the widget's configuration, so there is no second request and nothing to translate on your side.
Chế độ
Nổi (mặc định). Nút khởi chạy ở góc, mở bảng trò chuyện.
Nhúng. Đặt một vùng chứa trống trên trang và khung chat sẽ tự điền vào đó:
<div data-keyda-bot style="height:520px"></div>Khung chứa cần có chiều cao. Ở chế độ nội tuyến, khung trò chuyện luôn hiển thị nên không có gì cần mở hay đóng.
JavaScript API
Có sẵn trên window.KeydaBot sau khi mã nguồn đã tải xong:
| Gọi | Nó làm gì |
|---|---|
KeydaBot.open() | Mở bảng trò chuyện |
KeydaBot.close() | Đóng lại |
KeydaBot.toggle() | Mở hoặc đóng |
KeydaBot.expand() | Làm cho bảng điều khiển cao bằng cửa sổ và rộng tối đa 760px |
KeydaBot.shrink() | Quay lại thẻ tiêu chuẩn |
KeydaBot.isOpen | true khi khung trò chuyện hiển thị |
KeydaBot.isExpanded | true khi bảng điều khiển được mở rộng |
KeydaBot.clientId | Client id mà trang này đang sử dụng |
Ví dụ — mở khung chat từ nút "Trò chuyện với chúng tôi" của chính bạn:
<button onclick="KeydaBot.open()">Chat with us</button>window.KeydaBot có thể chưa tồn tại trong giây lát sau khi trang tải xong. Hãy gắn trình xử lý sự kiện vào thao tác nhấp chuột thay vì gọi nó khi trang đang phân tích cú pháp.Cách hoạt động trên trang của bạn
- Bảng điều khiển mở ra phía trên nút khởi chạy, nút này giữ nguyên vị trí và biến thành nút đóng. Chạm lại vào đó, dấu ✕ ở tiêu đề hoặc nhấn Escape sẽ đóng đoạn chat.
- Khách truy cập có thể mở rộng bảng trò chuyện từ tiêu đề — nó sẽ phủ kín chiều cao cửa sổ và rộng tới 760px — và lựa chọn này được ghi nhớ trong trình duyệt của họ. Trên điện thoại, bảng trò chuyện đã chiếm toàn màn hình nên nút này sẽ không hiển thị.
- Your logo size setting changes the logo, not the button: the launcher keeps its size and the logo grows inside it. Button size (Install → Appearance) is what resizes the button itself — small, medium or large — whatever shape it is.
- Four button shapes: a pill with your label, a round bubble, a rounded square, and a chat bubble with a tail. The tail sits on the side facing your page.
- Mọi thành phần hiển thị bên trong shadow root, do đó CSS của bạn không thể làm hỏng tiện ích và CSS của tiện ích cũng không thể ảnh hưởng đến trang web của bạn.
- Bảng điều khiển chỉ tải khi khách mở lên, do đó không làm chậm trang web của bạn.
- Cuộc trò chuyện của khách truy cập sẽ tiếp tục trong 24 giờ nếu họ quay lại, sau đó sẽ bắt đầu phiên mới.
- Nếu không thể kết nối với trợ lý, tiện ích sẽ hiển thị một thông báo ngắn và tuyệt đối không làm phát sinh lỗi trên trang của bạn.