Hướng dẫn gửi API
1. Giới thiệu về các phương thức gửi ZNS
Có 2 hình thức gửi thông báo ZNS:
1. Qua API
2. Gửi theo chiến dịch (Không qua API)
| Qua API | Theo chiến dịch (Không qua API) |
· Gửi qua API · Cần nhân lực có kiến thức về kỹ thuật · Gửi số lượng lớn · Dữ liệu gửi API không được lưu trên ZCA | · Gửi qua file Excel tải lên ZCA · Cần chuẩn bị file Excel · Gửi số lượng có hạn mức · Dữ liệu gửi được lưu trên tài khoản ZCA |
2. Hướng dẫn gửi API
Sequence diagram API giữa Đối tác gửi tin, Zalo server và người nhận ZNS
Miêu tả chi tiết:
a. Gửi request API
Gửi request API theo hướng dẫn tại ĐÂY và lấy Access Token (Mã định danh để gửi ZNS) theo 1 trong 2 cách sau:
- Công cụ API explorer: Dành cho Admin của OA/Ứng dụng lấy mã xác thực gửi tin.
- Giao thức OAuth: Dành cho người có kiến thức về lập trình, hoặc khi Doanh nghiệp sử dụng Ứng dụng của bên thứ 3.
b. Response sau khi gửi API
Sau khi yêu cầu được gửi đi, máy chủ Zalo sẽ phản hồi với các thông tin sau:
| Tham số | Mô tả |
| error | 0 nếu request thành công Ngược lại, xem Error Code chi tiết tại đây |
| message | Mô tả của lỗi tương ứng |
| msg_id | ID của tin ZNS Lưu ý: chỉ trả về nếu yêu cầu thành công |
| sent_time | Thời gian máy chủ Zalo bắt đầu gửi ZNS (Định dạng timestamp) |
| quota | Thông tin quota của OA Lưu ý: chỉ trả về nếu yêu cầu thành công |
Example response
{
"error": 0,
"message": "Success",
"data": {
"msg_id": "a4d0243feee163bd3af2"
"sent_time": "1626926349402",
"quota": {
"dailyQuota": "500",
"remainingQuota": "499"
}
}
}
Xem chi tiết hơn về cấu trúc của request và response tại ĐÂY.
c. Sự kiện gửi ZNS
Nếu request thành công, tin ZNS sẽ được gửi tới người dùng:
· sent_time: Thời điểm máy chủ Zalo bắt đầu gửi ZNS.
· delivery_time: Thời gian người dùng nhận được ZNS trên thiết bị.
d. Sự kiện người dùng nhận được tin ZNS
Nếu ZNS được gửi thành công trên thiết bị của người dùng, thì một sự kiện sẽ được gửi t ới URL webhook của Doanh nghiệp.
| Tham số | Mô tả |
| sender | ID của Official Account gửi thông báo |
| recipient | Số điện thoại người dùng nhận thông báo |
| event_name | Tên sự kiện: user_received_message |
| delivery_time | Thời gian trên thiết bị người dùng nhận được ZNS |
| msg_id | ID của tin ZNS Lưu ý: chỉ trả về nếu yêu cầu thành công |
| tracking_id | Mã số đánh dấu lần gọi API của đối tác, do đối tác định nghĩa ở bước (1) |
| app_id | ID của ứng dụng gửi tin (ứng dụng mà OA đã cấp quyền) |
| timestamp | Thời điểm gửi sự kiện |
Xem thêm chi tiết sự kiện tại ĐÂY.
Nếu có bất kì yêu cầu hỗ trợ, khách hàng có thể liên hệ với đội ngũ hỗ trợ và chăm sóc khách hàng của Zalo Cloud qua email: support@zalo.cloud. Đội ngũ CSKH Zalo Cloud sẽ phản hồi cho khách hàng trong vòng 24h làm việc tiếp theo.