Appearance
Tích hợp CNV Chat
CNV Chat là dịch vụ chat-as-a-service riêng của CNV (sub-domain chat.cnvwork.com) — chạy độc lập với phần Inbox tích hợp sẵn trong CNV Work. Workspace có thể kết nối với một CNV Chat tenant để dùng widget chat web đặc thù (chat box trên website công ty bạn, popup chat trên landing page) thay vì native Inbox.
Truy cập
Vào menu Cài đặt > Tích hợp > CNV Chat.
Lưu ý
Chỉ vai trò Owner mới có quyền thiết lập và ngắt kết nối CNV Chat.
Khi nào dùng CNV Chat
| Tình huống | Nên dùng |
|---|---|
| Bạn chỉ cần trả lời tin nhắn Facebook, Zalo, email | Inbox native (đã có sẵn) |
| Bạn cần widget chat trên website công ty + chat box tuỳ biến giao diện | CNV Chat + Inbox |
| Bạn muốn nhân viên dùng app chat dedicated (mobile chat 24/7) | CNV Chat |
| Bạn cần OmniChannel toàn diện: web widget + Facebook + Zalo + Email + WhatsApp | CNV Chat kết nối vào Inbox |
CNV Chat không thay thế Inbox — nó bổ sung kênh chat web widget và đồng bộ 2 chiều vào Inbox của bạn.
Tổng quan luồng đồng bộ
- Khách chat trên widget → CNV Chat nhận → đẩy vào Inbox CNV Work
- Nhân viên trả lời trong Inbox → đẩy ngược về widget
- Mỗi cuộc hội thoại tự động link với CRM Contact nếu khách cung cấp email/phone
Thiết lập kết nối
Bước 1: Có tài khoản CNV Chat
Nếu chưa có, đăng ký tại https://chat.cnvwork.com/signup. Sau khi đăng ký, hệ thống cấp cho bạn:
- ID workspace chat — định danh duy nhất của bạn trong CNV Chat
- Khoá kết nối (API key) — để CNV Work gọi CNV Chat
- Khoá xác thực sự kiện — để CNV Work nhận tin nhắn từ CNV Chat một cách an toàn
Bước 2: Lấy thông số
Trong CNV Chat dashboard:
- Vào Cài đặt > Tích hợp
- Copy ID workspace chat
- Copy Khoá kết nối
- Copy Khoá xác thực sự kiện
Bước 3: Cấu hình trong CNV Work
- Vào Cài đặt > Tích hợp > CNV Chat
- Nhấn Kết nối
- Điền:
| Trường | Mô tả | Bắt buộc |
|---|---|---|
| ID workspace chat | Paste từ CNV Chat | Có |
| Khoá kết nối | Paste từ CNV Chat | Có |
| Khoá xác thực sự kiện | Paste từ CNV Chat | Có |
| Hướng đồng bộ | 2 chiều / chỉ nhận / chỉ gửi | Có |
| Tự liên kết contact | Tự tạo CRM contact khi khách chat | Mặc định bật |
| Map agent | Liên kết nhân viên CNV Work ↔ agent CNV Chat | Có |
- Nhấn Kiểm tra kết nối
- Nếu OK → nhấn Lưu
Mẹo
Việc map agent dựa trên email — đảm bảo email nhân viên trong CNV Work giống email agent trong CNV Chat để hệ thống tự liên kết.
Bước 4: Cài widget lên website
CNV Chat sẽ sinh ra đoạn mã nhúng để dán vào website công ty. Bạn copy đoạn mã đó và đưa cho người quản trị website dán vào trước thẻ </body> trên mọi trang cần hiển thị chat widget.
Sau khi cài, widget chat tự hiện ở góc dưới phải mọi trang.
Cấu hình đồng bộ chi tiết
Đồng bộ 2 chiều (recommended)
- Khách chat trên widget → tin nhắn xuất hiện trong Inbox sau 1-2 giây
- Nhân viên trả lời trong Inbox → tin nhắn gửi về widget gần như tức thì
- Trạng thái typing đồng bộ
- Mark as read đồng bộ
Đồng bộ Inbound only
- Tin nhắn từ khách → Inbox (read-only)
- Nhân viên phải trả lời từ CNV Chat dashboard, không từ Inbox CNV Work
- Phù hợp khi đội chat dùng CNV Chat dedicated, đội CRM chỉ xem để follow-up
Đồng bộ Outbound only
- Inbox CNV Work là nguồn duy nhất → đẩy ra widget
- Hiếm dùng, chỉ phù hợp trường hợp đặc biệt
Auto-link CRM Contact
Khi tính năng bật:
- Khách chat lần đầu → CNV Chat tạo session ẩn danh
- Khách nhập email/phone (qua form, hoặc trong tin nhắn) → CNV Chat extract
- CNV Work tìm Contact match → link vào hội thoại
- Nếu không có → tạo Contact mới với source =
chat-widget
Toàn bộ lịch sử chat hiển thị trong tab Hoạt động của Contact.
Map agent
Tab Agent mapping trong trang Tích hợp:
| CNV Work User | CNV Chat Agent | Sync |
|---|---|---|
| nguyen@cty.vn | nguyen@cty.vn | Auto |
| tran@cty.vn | tran.support@cty.vn | Manual (đã map) |
| hung@cty.vn | — | Chưa map |
Nhân viên chưa map sẽ không thể trả lời tin nhắn từ CNV Chat (chỉ xem được). Nhấn Map manual để liên kết thủ công.
Trạng thái kết nối
Phía trên trang Tích hợp hiển thị:
- Đã kết nối (xanh) — đồng bộ hoạt động bình thường, kèm thời gian kiểm tra cuối
- Lỗi kết nối (đỏ) — kèm mô tả lỗi (sai khoá kết nối, không nhận được sự kiện...)
- Tạm dừng (vàng) — admin chủ động tạm dừng
Nhấn Kiểm tra để test kết nối ngay.
Ngắt kết nối
- Vào Cài đặt > Tích hợp > CNV Chat
- Nhấn Ngắt kết nối
- Chọn xử lý hội thoại đang mở:
- Giữ lại trong Inbox (không sync thêm)
- Archive tất cả
- Xác nhận
Lưu ý
Ngắt kết nối không xoá dữ liệu CNV Chat. Để xoá tài khoản CNV Chat, vào dashboard CNV Chat.
Lỗi thường gặp
| Lỗi | Nguyên nhân | Xử lý |
|---|---|---|
| "ID workspace không hợp lệ" | Copy sai ID workspace chat | Copy lại từ CNV Chat dashboard |
| "Xác thực thất bại" | Sai khoá xác thực sự kiện | Đổi lại khoá, lưu cả 2 bên |
| Tin nhắn không đồng bộ | Tường lửa website chặn | Liên hệ IT cho phép kết nối tới chat.cnvwork.com |
| Agent không trả lời được | Chưa map nhân viên | Vào tab Map agent, liên kết thủ công |
| Widget không hiện trên website | Đoạn mã nhúng sai hoặc website chặn script ngoài | Liên hệ IT website kiểm tra |
Liên kết liên quan
- Inbox — quản lý hội thoại từ tất cả kênh
- CRM Contact — quản lý liên hệ liên kết từ chat
- Tích hợp CNV Call — bổ sung kênh thoại