Hướng dẫn cài đặt chatbot SiteBrain

Trang này hướng dẫn bạn tạo chatbot từ nội dung website và gắn nó lên mọi nền tảng phổ biến. Toàn bộ quá trình thường mất chưa tới 10 phút.

1. Tạo chatbot

Tạo tài khoản miễn phí bằng email hoặc Google.
Bấm Tạo chatbot, nhập địa chỉ website (ví dụ https://tencongty.vn) và chọn ngôn ngữ mặc định.
SiteBrain bắt đầu đọc website. Tiến độ hiển thị trực tiếp; website vài chục trang thường xong trong 1–3 phút.
Khi trạng thái chuyển sang Sẵn sàng, dùng khung Dùng thử bên phải để hỏi thử vài câu.

Nếu dashboard báo "Không đọc được trang nào", có thể website đang chặn bot (Cloudflare Bot Fight Mode, tường lửa). Xem cách cho phép SiteBrainBot.

Mẹo: nếu website có sitemap (/sitemap.xml), SiteBrain sẽ tìm thấy trang nhanh và đầy đủ hơn. Hầu hết plugin SEO như Yoast, Rank Math đều tạo sitemap tự động.

2. Lấy mã nhúng

Trong tab Tổng quan của chatbot, sao chép đoạn mã dạng:

<script src="https://sitebrain.io.vn/widget.js" data-bot="MA_CHATBOT" async></script>

Dán đoạn mã này vào trước thẻ </body> trên mọi trang muốn hiển thị chatbot.

3. Gắn lên WordPress

Cài plugin WPCode (hoặc "Insert Headers and Footers").
Vào Code Snippets → Header & Footer, dán mã vào ô Footer, bấm Save.
Mở website ở tab ẩn danh để kiểm tra nút chat ở góc phải màn hình.

4. Haravan, Sapo

Haravan: vào Website → Giao diện → Chỉnh sửa code, mở tệp layout/theme.liquid (hoặc tệp layout chính) và dán mã ngay trước </body>.

Sapo: vào Kênh bán hàng → Website → Giao diện → Sửa mã HTML/CSS, mở layout/theme.bwt và dán mã trước </body>.

5. Wix, Ladipage, Google Tag Manager

Wix: Settings → Custom Code → Add Custom Code, chọn "Body - end", áp dụng cho All pages.
LadiPage: Cài đặt → Mã chuyển đổi / Tracking → dán vào ô "Trước thẻ đóng body".
Google Tag Manager: tạo thẻ Custom HTML chứa đoạn mã, trigger All Pages, rồi Publish.
HTML thuần / React / Vue: thêm thẻ script vào template chung (ví dụ index.html).

6. Tuỳ chỉnh chatbot

Trong tab Cài đặt, bạn có thể đổi tiêu đề, lời chào, màu chủ đạo, vị trí nút chat (trái/phải), ngôn ngữ, và thêm hướng dẫn cho AI — ví dụ "Luôn mời khách để lại số điện thoại khi hỏi về báo giá dự án".

Mã nhúng cũng nhận các thuộc tính tuỳ chọn:

Thuộc tính	Ý nghĩa
`data-color="#e11d48"`	Màu nút chat trên trang này (ghi đè cài đặt)
`data-position="left"`	Đặt nút chat ở góc trái
`data-open="1"`	Mở sẵn khung chat khi tải trang

7. Quản lý nội dung

Cập nhật nội dung: sau khi sửa website, bấm "Cập nhật nội dung" để SiteBrain đọc lại. Gói trả phí tự cập nhật hằng tuần.
Xoá trang không liên quan: trong tab Nội dung, xoá các trang không muốn chatbot dùng.
Thêm kiến thức thủ công: nhập thông tin không có trên website như giờ làm việc, hotline, chính sách nội bộ.
Chặn một số trang: thêm quy tắc Disallow cho SiteBrainBot trong robots.txt (xem SiteBrainBot).

8. Xử lý sự cố

Không thấy nút chat: kiểm tra mã đã nằm trên trang (xem mã nguồn trang), xoá cache của plugin tối ưu (WP Rocket, LiteSpeed…). Tên miền phải nằm trong danh sách "Tên miền được phép nhúng".
Chatbot học được ít trang: website có thể chặn bot trong robots.txt, dùng JavaScript để hiển thị nội dung, hoặc đã đạt giới hạn trang của gói. Hãy thêm sitemap hoặc thêm kiến thức thủ công.
Câu trả lời chưa chính xác: bổ sung nội dung rõ ràng trên website hoặc thêm kiến thức thủ công; xem thêm bài tối ưu nội dung cho chatbot.

Cần hỗ trợ? Gửi email tới support@sitebrain.io.vn.