# Tích hợp Website Livechat ## Hướng dẫn tạo Access key qua livechat.cloudgo.vn, tạo widget chat và thiết lập giao diện, tính năng widget trên website. --- **Author:** Bùi Tùng | **Created:** 2026-09-02 | **Categories:** Chathub đa kênh | **URL:** https://docs-beta.cloudgo.vn/en/tich-hop-website-livechat --- ## Mục đích Tích hợp Website Livechat cho phép bạn gắn khung chat (widget) lên website, tiếp nhận và trả lời tin nhắn khách hàng truy cập website ngay trên Chatbox của CRM. ## Điều kiện - Có tài khoản quản trị nội bộ trên hệ thống livechat.cloudgo.vn để tạo Access key. - Có quyền chỉnh sửa mã nguồn hoặc CMS của website muốn gắn widget chat. - Người thực hiện kết nối trên CRM có quyền quản trị (Admin). ## 1. Tạo Access key trên livechat.cloudgo.vn **Bước 1:** Truy cập https://livechat.cloudgo.vn và đăng nhập bằng tài khoản quản trị nội bộ. **Bước 2:** Vào menu "Quản lý Tenants", chọn "Tạo Tenant". **Bước 3:** Nhập các thông tin để tạo API key và chọn "Thêm": - Tên Tenant: tên tenant để quản lý nội bộ. - Domain: domain sử dụng dịch vụ. **Bước 4:** Chọn "Xem chi tiết" của Tenant vừa tạo để lấy thông tin API key. **Bước 5:** Vào link cài đặt sử dụng dịch vụ và nhập key vào để kết nối. ## 2. Tạo widget chat trên CRM **Bước 1:** Vào cây menu, chọn mục "Hệ thống", chọn "Tích hợp MXH". **Bước 2:** Tại tab "Website", chọn "Thêm Widget Chat". **Bước 3:** Popup tạo mới Widget chat hiển thị, nhập các thông tin chung: - Tên cửa sổ chat: tên nội bộ để phân biệt các widget livechat. - Tên hiển thị: tên hiển thị cho khách hàng. - Tên miền: domain website sẽ sử dụng widget chat này. - Logo (nếu có): tải logo lên, nếu không dùng hình mặc định của hệ thống. **Bước 4:** Sau khi tạo thành công, hệ thống hiển thị đoạn mã nguồn của widget chat. Sao chép đoạn mã và chèn vào website muốn gắn. > **Lưu ý:** Phải gắn widget chat vào đúng website có tên miền tương ứng với thông tin đã nhập khi tạo widget, nếu không khung chat sẽ không hiển thị. ## 3. Thiết lập giao diện widget Bạn có thể thiết lập ngay khi tạo mới hoặc sửa widget sau đó. **Bước 1:** Tại tab "Website", chọn biểu tượng thêm tại widget muốn sửa, chọn "Sửa widget chat". **Bước 2:** Tại mục "Thiết lập giao diện", cấu hình: - Chiều cao/chiều rộng: tùy chỉnh kích thước khung chat. - Mô tả cửa sổ chat: tiêu đề phụ mô tả rõ hơn về khung chat. - Vị trí hiển thị: góc phải hoặc góc trái màn hình. - Lời mở đầu cuộc chat: tin nhắn mở đầu khi khách hàng bật cửa sổ chat. - Màu chủ đạo: màu sắc chủ đạo cho widget (có sẵn hoặc tùy chỉnh). ## 4. Thiết lập tính năng widget **Tính năng đính kèm tệp:** bật để khách hàng có thể đính kèm tệp hoặc hình ảnh khi nhắn tin vào widget. **Thu thập thông tin:** thiết lập biểu mẫu yêu cầu khách hàng cung cấp thông tin trước khi bắt đầu trò chuyện. - Tiêu đề biểu mẫu: lời chào mừng của biểu mẫu. - Các trường thông tin: Danh xưng, Họ và tên, Tổ chức, Điện thoại, Email, Địa chỉ. - Hiển thị: hiển thị hoặc ẩn từng trường trên biểu mẫu. - Bắt buộc: nếu bật, khách hàng phải nhập thông tin này trước khi chat. **Gợi ý chat:** thiết lập các tin nhắn nhanh để khách hàng bắt đầu cuộc trò chuyện. - Thêm mới: chọn "Thêm tin nhắn" rồi nhập nội dung. - Sắp xếp: nhấn giữ và kéo thả để sắp xếp thứ tự hiển thị. - Xóa: chọn icon thùng rác ở cuối nội dung. ## Kết quả mong đợi Widget chat hiển thị đúng trên website đã gắn mã nguồn, đúng giao diện và tính năng đã thiết lập. Tin nhắn khách hàng gửi từ widget đồng bộ về Chatbox trên CRM. ## Xử lý lỗi | Lỗi | Nguyên nhân | Cách khắc phục | | --- | --- | --- | | Widget chat không hiển thị trên website | Tên miền gắn mã nguồn không khớp với tên miền đã khai báo khi tạo widget | Kiểm tra lại "Tên miền" trong cấu hình widget, đảm bảo khớp chính xác với domain website | | Không nhận được tin nhắn từ widget về Chatbox | Access key chưa được nhập đúng ở bước cài đặt dịch vụ | Kiểm tra lại API key lấy từ livechat.cloudgo.vn và nhập lại vào link cài đặt | | Biểu mẫu thu thập thông tin không hiển thị | Chưa bật/thiết lập biểu mẫu trong mục Thiết lập tính năng | Vào mục 4, bật "Thu thập thông tin" và cấu hình lại các trường cần thiết |