Cách xử lý mã lỗi
Tổng quan
Zalo Notification Service(ZNS) cung cấp cho các Doanh nghiệp, developers về các mã lỗi thường gặp và giải pháp khi gặp những lỗi này.
Chi tiết và hướng dẫn xử lý mã lỗi
| Mã lỗi | Mô tả lỗi | Thông tin lỗi | Hướng dẫn xử lý |
|---|---|---|---|
| 0 | Success | Gửi thành công | |
| -100 | Unknown error | Xảy ra lỗi không xác định, vui lòng thử lại sau | |
| -101 | Application invalid | Ứng dụng gửi ZNS | Kiểm tra lại ID ứng dụng tại Zalo for Developers |
| -102 | Application not existed | Ứng dụng gửi ZNS | Kiểm tra lại ID ứng dụng tại Zalo for Developers |
| -103 | Application not activated | Ứng dụng chưa được kích hoạt | - B1: Truy cập Zalo for Developers và chọn ứng dụng cần kích hoạt - B2: Nhấn chọn kích hoạt ứng dụng ở góc trên bên phải |
| -104 | App secret key invalid | Secret key của ứng dụng không hợp lệ | Kiểm tra lại Secret key trong ứng dụng tương ứng tại Zalo for Developers |
| -105 | Application not link to any OA | Ứng dụng gửi ZNS chưa đươc liên kết với OA nào | |
| -106 | Method unsupported | Phương thức không được hỗ trợ | Đối chiếu phương thức hiện tại với API đã cung cấp. Chi tiết các phương thức tại đây |
| -107 | Message ID invalid | ID thông báo không hợp lệ | |
| -108 | Phone number invalid | Số điện thoại không hợp lệ | Kiểm tra lại thông tin, định dạng số điện thoại người nhận ZNS hiện đã gửi tin được đến các định dạng số điện thoại sau: - 84xxxx - 0xxxx - xxxx (Không có số 0 ở đầu do định dạng excel) |
| -109 | Template ID invalid | ID mẫu ZNS không hợp lệ | Kiểm tra lại ID của mẫu ZNS |
| -110 | Zalo version unsupported | Phiên bản Zalo app không được hỗ trợ. Người dùng cần cập nhật phiên bản mới nhất | |
| -111 | Template data empty | Mẫu ZNS không có dữ liệu | |
| -112 | Template data invalid | Nội dung mẫu ZNS không hợp lệ | Truyển sai format dữ liệu - Kiểm tra lại và truyền đúng theo format dữ liệu của biến |
| -1123 | QR code cannot be generated | Không thể tạo QR code, vui lòng kiểm tra lại | |
| -113 | Button invalid | Button không hợp lệ | |
| -114 | User is inactive, or rejects the message, or using an outdated Zalo version, or other internal errors | Người dùng không nhận được ZNS vì các lý do: Trạng thái tài khoản, Tùy chọn nhận ZNS, Sử dụng Zalo phiên bản cũ, hoặc các lỗi nội bộ khác | |
| -115 | Out of quota | Tài khoản ZNS không đủ số dư | Truy cập Zalo Cloud Account để kiểm tra số dư tài khoản và thực hiện nạp tiền nếu không đủ số dư (Xem thêm: Hướng dẫn nạp tiền vào ZCA ) |
| -116 | Text invalid | Nội dung không hợp lệ | |
| -117 | OA or App does not have permission to access this template | OA hoặc ứng dụng gửi ZNS chưa được cấp quyền sử dụng mẫu ZNS này | KH đang sử dụng Template đăng ký bằng thông tin OAid hoặc App id khác. KH cần kiểm tra lại App/OA/tempID tương ứng tại đây |
| -118 | Zalo account not existed | Tài khoản Zalo không tồn tại hoặc đã bị vô hiệu hoá | |
| -119 | Account can not receive message | Tài khoản không thể nhận ZNS | |
| -120 | OA does not have permission to use this feature | OA chưa được cấp quyền sử dụng tính năng này | Kiểm tra lại tính năng khả dụng hoặc liên hệ email support@zalo.cloud để được hỗ trợ. |
| -121 | Body data empty | Mẫu ZNS không có nội dung | Phải nhập nội dung mẫu ZNS. |
| -122 | Body format invalid | Body request không đúng định dạng JSON | |
| -123 | RSA message decoded failed | Giải mã nội dung thông báo RSA thất bại | |
| -124 | Access token invalid | Mã truy cập không hợp lệ | Kiểm tra/ lấy lại access token, gồm 2 cách: - Cách 1: Xác thực với giao thức OAuth, gồm các bước sau: 1. Lấy access token từ refresh token 2. Yêu cầu cấp mới access token - Cách 2: Xác thực với công cụ API Explorer |
| -125 | Official Account ID invalid | ID Official Account không hợp lệ | Kiểm tra lại OA id tại đây |
| -126 | Out of quota (development mode) | Ví (development mode) không đủ số dư | |
| -127 | Test template messages can only be sent to admin | Template test chỉ có thể được gửi cho quản trị viên | |
| -128 | Encoding key not existed | Mã encoding key không tồn tại | |
| -129 | RSA key cannot be generated | Không thể tạo RSA key, vui lòng thử lại sau | |
| -130 | Maximum character limit exceeded | N ội dung mẫu ZNS vượt quá giới hạn kí tự | |
| -131 | ZNS template not approved | Mẫu ZNS chưa được phê duyệt | |
| -132 | Parameter invalid | Tham số không hợp lệ | Truyền vào đúng với định dạng yêu cầu của từng biến. VD: biến <thoigian> định dạng dd/mm/yyyy nhưng data là "ngày hôm nay"(string) sẽ báo lỗi |
| -133 | This template cannot be sent at night (10PM-6AM) | Mẫu ZNS này không được phép gửi vào ban đêm (từ 22h-6h) | |
| -134 | User has not responded to opt-in inquiry | Người dùng chưa phản hồi gợi ý nhận ZNS từ OA | |
| -135 | No permission to send ZNS (not verified, in free subscription plan) | OA chưa có quyền gửi ZNS (chưa được xác thực, đang sử dụng gói miễn phí) | |
| -136 | ZCA association required | Cần kết nối với ZCA để sử dụng tính năng này | Ứng dụng cần kết nối với ZCA. KH xem chi tiết hướng dẫn tại đây |
| -137 | ZCA charge failure | Thanh toán ZCA thất bại (ví không đủ số dư,…) | Kiểm tra lại số dư ZCA |
| -138 | App does not have permission to access this feature | Ứng dụng gửi ZNS chưa có quyền sử dụng tính năng này | Lựa chọn ứng dụng hiện tại tại đây và kiểm tra xét duyệt đăng ký sử dụng API tương ứng |
| -139 | User refused to receive this type of ZNS | Người dùng từ chối nhận loại ZNS này | |
| -140 | No permission to send follow-up to this user | OA chưa được cấp quyền gửi ZNS hậu mãi cho người dùng này | Xem lại hạn mức gửi ZNS tại đây |
| -141 | User refused to receive ZNS | Người dùng từ chối nhận ZNS từ Official Account | |
| -142 | RSA key not exist | RSA key không tồn tại, vui lòng gọi API tạo RSA key | Kiểm tra/ khởi tạo lại RSA Key tại đây |
| -143 | RSA key already existed | RSA key đã tồn tại, vui lòng gọi API lấy RSA key | Kiểm tra lại RSA Key |
| -144 | ZNS daily quota exceeded | OA đã vượt giới hạn gửi ZNS trong ngày | Kiểm tra lại thông tin quota của OA hiện tại. Chi tiết xem tại đây |
| -145 | OA does not have permission to send this type of ZNS | OA không được phép gửi loại nội dung ZNS này | Kiểm tra xem lại nội dung ZNS có thể gửi tại đây |
| -146 | Template disabled due to low quality | Mẫu ZNS này đã bị vô hiệu hóa do chất lượng gửi thấp | |
| -147 | Template daily quota exceeded | Mẫu ZNS đã vượt giới hạn gửi trong ngày | |
| -148 | ZNS journey token missing | Không tìm thấy ZNS journey token | Kiểm tra lại Journey token đã được cấp tại đây |
| -149 | ZNS journey token invalid | ZNS journey token không hợp lệ | Kiểm tra ID journey token tại đây |
| -150 | ZNS journey token expired | ZNS journey token đã hết hạn | Kiểm tra/ khởi tạo lại ZNS Journey token tại đây |
| -151 | Not an E2EE template | Không phải mẫu ZNS E2EE | Kiểm tra lại mẫu ZNS có phải mẫu E2EE hay chưa |
| -152 | Get E2EE key failed | Lấy E2EE key thất bại |