# Tích hợp Zalo cá nhân ## Hướng dẫn tạo Access key qua zalogateway.cloudgo.vn và kết nối tài khoản Zalo cá nhân vào Chatbox trên CRM. --- **Author:** Bùi Tùng | **Created:** 2026-09-02 | **Categories:** Chathub đa kênh | **URL:** https://docs.cloudgo.vn/en/tich-hop-zalo-ca-nhan --- ## Mục đích Tích hợp Zalo cá nhân cho phép bạn nhắn tin và tiếp nhận tin nhắn từ tài khoản Zalo cá nhân ngay trên Chatbox của CRM, phù hợp khi bạn chăm sóc khách hàng qua Zalo cá nhân thay vì Zalo OA. ## Điều kiện - Có tài khoản quản trị nội bộ trên hệ thống zalogateway.cloudgo.vn để tạo Access key (do đội ngũ kỹ thuật CloudGO cấp). - Người thực hiện kết nối trên CRM có quyền quản trị (Admin). - Đã hoàn tất [Cấu hình chatbox tập trung](https://docs-beta.cloudgo.vn/cau-hinh-chatbox-tap-trung). ## 1. Tạo Access key trên zalogateway.cloudgo.vn **Bước 1:** Truy cập https://zalogateway.cloudgo.vn và đăng nhập bằng tài khoản quản trị nội bộ. **Bước 2:** Vào menu "Tenant", chọn "Thêm 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ụ. - Webhook URL: URL webhook để nhận thông báo. - License Package: gói dịch vụ tương ứng. - Proxy: chọn Auto Gateway. **Bước 4:** Chọn biểu tượng "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. > **Lưu ý:** Bước tạo Access key do đội ngũ kỹ thuật CloudGO thực hiện nội bộ. Nếu bạn là khách hàng, liên hệ CloudGO để được hỗ trợ tạo Tenant. ## 2. Kết nối Zalo cá nhân 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 "Zalo cá nhân", chọn "Kết nối Zalo cá nhân". **Bước 3:** Popup kết nối Zalo cá nhân hiện ra. Dùng Zalo cá nhân quét mã QR trong popup và cấp quyền kết nối với CRM. > **Lưu ý:** Khi đã kết nối tài khoản Zalo cá nhân vào CRM, không được đăng nhập tài khoản Zalo này trên trình duyệt khác, vì có thể làm gián đoạn kết nối. ## Kết quả mong đợi Tài khoản Zalo cá nhân xuất hiện trong danh sách kênh đã kết nối tại "Tích hợp MXH". Tin nhắn khách hàng gửi đến tài khoản Zalo cá nhân này sẽ đồng bộ về Chatbox trên CRM. ## Xử lý lỗi | Lỗi | Nguyên nhân | Cách khắc phục | | --- | --- | --- | | Quét mã QR không kết nối được | Mã QR đã hết hạn hoặc tài khoản Zalo đang đăng nhập nơi khác | Tải lại popup để lấy mã QR mới, đăng xuất Zalo khỏi các trình duyệt/thiết bị khác | | Mất kết nối Zalo cá nhân đột ngột | Tài khoản Zalo bị đăng nhập song song ở trình duyệt/thiết bị khác | Kết nối lại theo mục 2, đảm bảo không đăng nhập Zalo ở nơi khác | | Không lấy được Access key trên zalogateway.cloudgo.vn | Chưa được cấp tài khoản quản trị nội bộ | Liên hệ CloudGO để được hỗ trợ tạo Tenant và cấp Access key |