Lỗi
Mọi lỗi cùng một dạng, viết bằng tiếng Việt và nói cách xử lý. Địa chỉ gốc: https://app.zapro.vn/v1.
Dạng lỗi
{ "error": { "code": "template_not_approved", "message": "Mẫu \"khuyen-mai-t11\" đang chờ Zalo duyệt, chưa gửi được. Không có tin nào được gửi đi." } }| HTTP | code | Khi nào |
|---|---|---|
| 401 | missing_api_key | Thiếu header Authorization: Bearer zp_live_… |
| 401 | invalid_api_key | Key sai hoặc đã bị thu hồi. Tạo key mới ở trang API keys. |
| 403 | forbidden | Key chỉ-gửi-tin dùng cho việc cần key toàn quyền (webhook, đồng bộ mẫu, link Connect). |
| 403 | sandbox_recipient_not_allowed | OA sandbox chỉ gửi tới số điện thoại của thành viên công ty. |
| 403 | email_not_verified | Cần xác minh email trước khi kết nối OA thật, mời thành viên hay đổi gói. |
| 403 | plan_limit | Đã chạm giới hạn của gói (số OA, số webhook, ZaPro Connect). |
| 404 | not_found | Không có tin, mẫu, OA hoặc webhook này trong công ty của key. |
| 409 | oa_disconnected | OA đã mất kết nối. Chủ OA cần kết nối lại trên bảng điều khiển. |
| 422 | validation_error | Dữ liệu gửi lên chưa đúng: số điện thoại, tham số mẫu, thời điểm hẹn giờ, hoặc có trường không tồn tại (ZaPro báo lỗi thay vì bỏ qua). |
| 422 | template_not_approved | Mẫu đang chờ duyệt, bị từ chối hoặc bị tắt. Không có tin nào được gửi. |
| 429 | rate_limited | Quá 10 lệnh mỗi giây cho một key. Chờ một chút rồi gửi lại. |
| 429 | quota_exceeded | Gói Miễn phí đã dùng hết 1.000 tin, hoặc hết tin thử sandbox trong tháng. |
Lỗi của tin đã nhận nhưng thất bại khi gửi (số chưa dùng Zalo, người nhận chặn…) không trả về lúc gọi API mà nằm trong trường error của tin và trong sự kiện message.failed. Xem Tra cứu tin.