Nhúng Chatbot
Thêm chatbot AI vào website với đoạn mã đơn giản.
Tổng Quan
Nhúng AI assistant vào website dưới dạng widget chat góc phải. Khách truy cập có thể hỏi đáp trực tiếp mà không cần rời trang.
Bao gồm: Streaming realtime · Lưu hội thoại · Đa ngôn ngữ (VI/EN) · Dark mode · Markdown & code block · Phản hồi 👍👎 · Mobile fullscreen
Lấy Mã Nhúng
- Vào Tích Hợp trong sidebar của Admin Panel
- Sao chép đoạn mã:
<script
src="https://cdn.assistantcore.com/embed/embed.js"
data-assistant-id="ID_TRỢ_LÝ"
data-api-base="https://api.assistantcore.com"
async
></script>- Dán vào HTML website, trước thẻ đóng
</body>
Thuộc Tính
| Thuộc tính | Bắt buộc | Mô tả |
|---|---|---|
data-assistant-id | ✅ | UUID trợ lý (lấy từ Admin) |
data-api-base | ✅ | URL của API server |
data-lang | ❌ | Ngôn ngữ: vi hoặc en. Mặc định tự phát hiện |
Nếu website có <html lang="vi">, widget sẽ tự động hiển thị Tiếng Việt mà không cần data-lang.
Nơi Thêm Mã
- WordPress — Giao diện → Theme Editor → Footer
- HTML — Trước
</body>trong file HTML - React/Next.js — Dùng
next/scriptvớistrategy="lazyOnload"
Cấu Hình Tên Miền
Widget chỉ hoạt động trên tên miền đã đăng ký:
- Vào Tích Hợp → Tên miền nhúng Widget
- Nhập tên miền (ví dụ:
www.mysite.com) - Nhấn Thêm → Lưu
Nếu không đăng ký tên miền, widget sẽ không hoạt động.
Tính Năng
Lưu hội thoại
Tin nhắn được lưu qua localStorage — reload trang không mất. Nhấn ✏️ trên header để bắt đầu cuộc trò chuyện mới.
Streaming & trạng thái
Phản hồi hiển thị realtime từng ký tự, kèm trạng thái xử lý ("Đang tìm kiếm tài liệu...") và gợi ý câu hỏi tiếp theo.
Markdown
Hỗ trợ bảng, code block có nhãn ngôn ngữ + nút sao chép, blockquote, danh sách. Link tự động mở tab mới.
Xử lý lỗi
Hiển thị thông báo rõ ràng khi hết lượt, lỗi mạng, hoặc lỗi server — kèm nút Thử lại khi có thể.
Dark mode & Responsive
Tự động theo cài đặt hệ thống. Fullscreen trên mobile (≤ 480px).
Widget nhúng có từ gói Pro trở lên. Gói Miễn Phí dùng chat tại support.assistantcore.com.