API

Tra cứu và hủy tin

Danh sách tin, chi tiết từng tin kèm các mốc thời gian, hủy tin chưa gửi. Địa chỉ gốc: https://app.zapro.vn/v1.

GET/v1/messages Tin mới nhất trước. Lọc: status, oa, to. Phân trang: limit (tối đa 100), before (mã tin cuối trang trước).

GET/v1/messages/{id} Một tin kèm events: nhận lệnh, gửi đi, tới máy, thất bại, lý do.

DELETE/v1/messages/{id} Hủy tin đang chờ, đang hẹn giờ hoặc đang được giữ. Tin đã gửi đi thì không hủy được.

Tin thất bại trong 24 giờ qua

curl "https://app.zapro.vn/v1/messages?status=failed&limit=20" \
  -H "Authorization: Bearer $ZAPRO_API_KEY"

Lỗi của từng tin

Khi tin thất bại, trường error có code, message viết bằng tiếng Việt và zalo_code gốc của Zalo.

code	Ý nghĩa
recipient_not_on_zalo	Số chưa dùng Zalo hoặc tài khoản bị khóa. Zalo không tính phí; nên gửi SMS dự phòng.
recipient_opted_out	Người nhận đã từ chối hoặc chặn loại tin này.
recipient_not_eligible	Người nhận chưa có giao dịch với doanh nghiệp theo chính sách của Zalo.
recipient_inactive	Tài khoản Zalo của người nhận bị khóa hoặc không hoạt động quá 45 ngày.
oa_permission_revoked	Chủ OA đã gỡ quyền của ZaPro. Cần kết nối lại.
template_invalid	Mã mẫu không hợp lệ phía Zalo. Đồng bộ lại mẫu.