Skip to main content
Hướng dẫn gửi API

Hướng dẫn gửi API

1. Giới thiệu về các phương thức gửi Tin nhắn ZBS Template​

Có 2 hình thức gửi tin: 

1.      Qua API 

2.      Gửi theo chiến dịch (Không qua API)

Qua APITheo 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 ZBS

·        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 ZBS

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 tin

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 tin) 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ả
error0 nếu request thành công
Ngược lại, xem Error Code chi tiết tại đây
messageMô tả của lỗi tương ứng
msg_idID của tin
Lưu ý: chỉ trả về nếu yêu cầu thành công
sent_timeThời gian máy chủ Zalo bắt đầu gửi tin (Định dạng timestamp)
quotaThô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 tin ​

Nếu request thành công, tin 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 tin.

·       delivery_time: Thời gian người dùng nhận được tin trên thiết bị.

d. Sự kiện người dùng nhận được tin ​

Nếu tin đượ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ả
senderID của Official Account gửi thông báo
recipientSố điện thoại người dùng nhận thông báo
event_nameTên sự kiện: user_received_message
delivery_timeThời gian trên thiết bị người dùng nhận được ZNS
msg_idID của tin ZNS
Lưu ý: chỉ trả về nếu yêu cầu thành công
tracking_idMã 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_idID của ứng dụng gửi tin (ứng dụng mà OA đã cấp quyền)
timestampThờ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ợ, Quý khách có thể liên hệ với đội ngũ hỗ trợ và chăm sóc khách hàng của chúng tôi qua Biểu Mẫu: Mẫu hỗ trợ Zalo Business Solutions. Chúng tôi sẽ phản hồi Quý khách trong vòng 24h làm việc tiếp theo.

Bài viết này có hữu ích với bạn không?