Đối với những doanh nghiệp cần gửi số lượng lớn tin nhắn ZBS Template một cách chủ động, linh hoạt và có thể tích hợp trực tiếp vào hệ thống vận hành sẵn có, ZBS Template Message API chính là giải pháp tối ưu nhất. Tuy nhiên, để triển khai đúng cách, doanh nghiệp cần hiểu rõ quy trình gửi request, cách xử lý response cũng như các sự kiện webhook liên quan. Bài viết dưới đây, Abenla sẽ hướng dẫn gửi ZBS qua API.

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

Hiện tại, Zalo Business Solutions hỗ trợ hai hình thức gửi tin nhắn ZBS Template: gửi qua ZBS Template Message API và gửi theo chiến dịch (không qua API). Mỗi phương thức đều có đặc điểm riêng, phù hợp với từng nhu cầu và năng lực kỹ thuật khác nhau của doanh nghiệp.

So sánh gửi qua API và gửi theo chiến dịch

Nhìn chung, API ZBS Template Message phù hợp với các doanh nghiệp có đội ngũ kỹ thuật riêng và nhu cầu gửi tin số lượng lớn, có thể tích hợp trực tiếp vào hệ thống CRM hoặc phần mềm quản lý khách hàng sẵn có. Trong khi đó, gửi theo chiến dịch phù hợp hơn với doanh nghiệp nhỏ, không có đội ngũ kỹ thuật, ưu tiên sự đơn giản và dễ thao tác.

Hướng dẫn gửi ZBS Template Message qua API

Quy trình gửi ZBS Template Message qua API diễn ra theo trình tự giữa ba bên: Đối tác gửi tin, Zalo server và người nhận tin. Dưới đây là mô tả chi tiết từng bước gửi tin.

1. Gửi Request API

Bước đầu tiên, doanh nghiệp cần gửi request API theo đúng hướng dẫn kỹ thuật của Zalo Business Solutions và lấy Access Token – mã định danh bắt buộc để có thể gửi tin. Doanh nghiệp có thể lấy Access Token theo một trong hai cách sau:

• Công cụ API Explorer: Dành cho Admin của Official Account (OA) hoặc Ứng dụng, giúp lấy mã xác thực gửi tin một cách trực quan, không đòi hỏi thao tác lập trình phức tạp.

• Giao thức OAuth: Phù hợp với người có kiến thức về lập trình, hoặc trong trường hợp doanh nghiệp đang sử dụng ứng dụng của bên thứ ba để gửi tin.

Việc lựa chọn đúng phương thức lấy Access Token ngay từ đầu sẽ giúp quá trình tích hợp API diễn ra thuận lợi hơn, tránh phát sinh lỗi xác thực trong quá trình gửi tin về sau.

2. Response sau khi gửi API

Sau khi request được gửi đi, máy chủ Zalo sẽ phản hồi lại với các thông tin cụ thể sau:

Ví dụ về một response thành công có cấu trúc như sau:

{
  "error": 0,
  "message": "Success",
  "data": {
    "msg_id": "a4d0243feee163bd3af2",
    "sent_time": "1626926349402",
    "quota": {
      "dailyQuota": "500",
      "remainingQuota": "499"
    }
  }
}

Thông qua response này, doanh nghiệp có thể chủ động kiểm tra trạng thái gửi tin, theo dõi quota còn lại của OA, cũng như xử lý lỗi kịp thời nếu request không thành công. Doanh nghiệp nên tham khảo thêm tài liệu chi tiết về cấu trúc request và response để nắm đầy đủ các trường dữ liệu khi triển khai thực tế.

3. Sự kiện gửi tin

Nếu request được gửi thành công, tin nhắn sẽ tiếp tục được chuyển đến người dùng cuối. Trong giai đoạn này, hệ thống ghi nhận hai mốc thời gian quan trọng:

• sent_time: Thời gian máy chủ Zalo bắt đầu gửi tin nhắn.

• delivery_time: Thời gian người dùng thực sự nhận được tin nhắn trên thiết bị của họ.

Việc theo dõi hai mốc thời gian này giúp doanh nghiệp đánh giá được tốc độ gửi tin thực tế, từ đó có cơ sở để tối ưu thời điểm gửi tin nhắn cho các chiến dịch tiếp theo.

4. Sự kiện người dùng nhận tin

Khi tin nhắn được gửi thành công đến thiết bị của người dùng, một sự kiện tương ứng sẽ được gửi về URL webhook mà doanh nghiệp đã đăng ký, với các thông tin chi tiết như sau:

Nhờ cơ chế webhook này, doanh nghiệp có thể tự động hóa hoàn toàn việc theo dõi trạng thái tin nhắn ngay trên hệ thống nội bộ, mà không cần thao tác kiểm tra thủ công. Đây cũng là nền tảng quan trọng để doanh nghiệp xây dựng các báo cáo, phân tích hiệu quả chiến dịch gửi tin theo thời gian thực.

Abenla – Đơn vị cung cấp dịch vụ ZBS uy tín

Việc tự triển khai tích hợp ZBS Template Message qua API đòi hỏi đội ngũ kỹ thuật am hiểu sâu về cấu trúc request, response cũng như cơ chế xử lý webhook. Điều không phải doanh nghiệp nào cũng sẵn sàng đáp ứng ngay từ đầu.

Abenla là đơn vị cung cấp dịch vụ gửi tin ZBS chuyên nghiệp, uy tín, hỗ trợ doanh nghiệp trọn gói từ khâu tư vấn lựa chọn phương thức gửi tin phù hợp, tích hợp ZBS Template Message API, đến vận hành và theo dõi hiệu quả chiến dịch gửi tin lâu dài. Khi lựa chọn Abenla để gửi ZBS, doanh nghiệp sẽ được hỗ trợ:

• Tư vấn lựa chọn phương thức gửi tin phù hợp qua API hoặc theo chiến dịch dựa trên quy mô và năng lực kỹ thuật thực tế.

• Triển khai tích hợp API ZBS nhanh chóng, chính xác, đúng chuẩn kỹ thuật của Zalo.

• Thiết lập và xử lý webhook tự động, giúp doanh nghiệp theo dõi trạng thái tin nhắn theo thời gian thực.

• Hỗ trợ xử lý lỗi request, tối ưu quota gửi tin để đảm bảo chiến dịch vận hành liên tục, ổn định.

• Đồng hành tư vấn chiến lược chăm sóc khách hàng dài hạn trên toàn bộ hệ sinh thái Zalo.

ZBS Template Message API là giải pháp phù hợp cho doanh nghiệp có nhu cầu gửi tin số lượng lớn, cần tích hợp trực tiếp vào hệ thống vận hành và mong muốn tự động hóa toàn bộ quy trình theo dõi trạng thái tin nhắn. Liên hệ Abenla để được tư vấn giải pháp ZBS và xem báo giá chi tiết.

Xem thêm:

Thông tin liên hệ:

Công ty TNHH ABENLA

• Địa chỉ: Số 3, đường số 7A Cư Xá Bình Thới, phường Bình Thới, Thành phố Hồ Chí Minh

• Hotline: 028 66808866

• Email: info@abenla.com