Bỏ qua để đến nội dung
  • troubleshooting
  • zalo connection

Xử lý sự cố Zalo & Quét QR kết nối (Zalo Connection)

TrolyPage hỗ trợ 3 loại kết nối Zalo chính: Zalo OA (Official Account), Zalo Personal (Zalo Cá nhân) và Zalo Bot API. Mỗi kênh có cơ chế duy trì kết nối và cách xử lý sự cố khác nhau.

Dấu hiệu sự cố Zalo Personal & Zalo OA

Phần tiêu đề “Dấu hiệu sự cố Zalo Personal & Zalo OA”
  • Dải banner màu cam/đỏ ZaloConnectionBanner xuất hiện ở đỉnh cuộc trò chuyện:
    • “Kết nối Zalo Personal có vấn đề”
    • “Không thể xác minh trạng thái Zalo Personal. Hệ thống vẫn đang tự kiểm tra lại.”
  • Tin nhắn Zalo gửi đi bị treo ở trạng thái Đang gửi... hoặc báo lỗi Failed.

Phân loại Sự cố theo từng loại kênh Zalo

Phần tiêu đề “Phân loại Sự cố theo từng loại kênh Zalo”

1. Zalo Personal (Tài khoản Zalo Cá nhân)

Phần tiêu đề “1. Zalo Personal (Tài khoản Zalo Cá nhân)”
  • Đặc điểm: Tự động đăng nhập qua mã QR hoặc Chrome Extension kết nối zalo_personal_config_id.
  • Nguyên nhân mất kết nối:
    • Bạn đăng xuất tài khoản Zalo trên điện thoại hoặc đăng nhập Zalo Web trên một trình duyệt khác làm trôi session.
    • Máy chủ tự động bị ngắt kết nối tạm thời (reconnecting).
  • Cách khắc phục:
    1. Nhấp nút Kiểm tra lại trên banner để kích hoạt hệ thống tự kết nối lại.
    2. Nếu hiện nút Kết nối lại: Nhấp vào nút để tới trang /app/channels#messaging.
    3. Mở ứng dụng Zalo trên điện thoại → Bấm Quét mã QR để đăng nhập lại tài khoản Zalo Cá nhân.

2. Zalo OA (Zalo Official Account)

Phần tiêu đề “2. Zalo OA (Zalo Official Account)”
  • Đặc điểm: Kết nối qua Zalo Developer App (App ID, App Secret, Refresh Token).
  • Nguyên nhân mất kết nối:
    • Refresh Token hết hạn (Zalo OA quy định Refresh Token có hiệu lực 3 tháng; Access Token hết hạn sau 25 giờ).
    • Quyền OA chưa cấp tính năng gửi tin CSKH hoặc hết hạn ngạch gói Zalo OA.
  • Cách khắc phục:
    1. Mở trang Cài đặt Kênh (/app/channels).
    2. Tìm kênh Zalo OA → Bấm Làm mới OAuth Zalo OA.
    3. Đăng nhập tài khoản Admin Zalo OA và xác nhận cấp lại quyền.

3. Zalo Bot API

Phần tiêu đề “3. Zalo Bot API”
  • Đặc điểm: Kết nối qua Bot Token của Zalo Bot.
  • Cách khắc phục: Kiểm tra lại Bot Token trong cài đặt kênh xem token có bị vô hiệu hóa trên Zalo Developer Portal hay không.

Bảng tra cứu Mã lỗi Zalo API

Phần tiêu đề “Bảng tra cứu Mã lỗi Zalo API”
Mã lỗi Nhãn thông báo Nguyên nhân & Khắc phục
-201 Token expired Refresh Token hoặc Access Token hết hạn. Bấm Làm mới OAuth.
-216 User not interested Khách hàng đã chặn (Block) hoặc hủy quan tâm Zalo OA.
-224 Out of quota Zalo OA đã dùng hết hạn ngạch tin nhắn chủ động trong tháng.
reconnecting Zalo đang tự kết nối lại Hệ thống đang chạy lại daemon kết nối ngầm, chờ 10-30s.

Bước tiếp theo

Phần tiêu đề “Bước tiếp theo”