Documentation

Xem Markdown

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.

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ỗiNguyên nhânCách khắc phục
Widget chat không hiển thị trên websiteTên miền gắn mã nguồn không khớp với tên miền đã khai báo khi tạo widgetKiể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ề ChatboxAccess 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ăngVà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
Bài viết có hữu ích cho bạn không?
Nội dung trang