V251105 - Thông báo bổ sung Webhook loại sự kiện ZNS

Thân gửi Quý Đối tác/Khách hàng,

Tiếp nối tính năng Webhook đã ra mắt trong phiên bản trước V251006, eTelecom xin giới thiệu bản cập nhật mới mở rộng khả năng theo dõi và đồng bộ sự kiện ZNS (Zalo Notification Service) thông qua cơ chế Webhook đáng tin cậy.

1. Bổ sung loại sự kiện ZNS

• Hệ thống nay hỗ trợ loại sự kiện mới: zl_oa_message bên cạnh sự kiện call_log đã có trước đó.

• Giúp khách hàng theo dõi vòng đời của tin nhắn ZNS, bao gồm:

  • Gửi tin

  • Người dùng nhận tin

  • Tin nhắn được tính phí

  • Người dùng phản hồi tin đánh giá / response button

2. Chuẩn hóa sự kiện theo mô hình Event Sourcing

• Hệ thống không còn forward trực tiếp sự kiện từ Zalo.

• Thay vào đó, eTelecom tự sinh sự kiện nội bộ phản ánh trạng thái thực tế của từng tin nhắn.

• Cơ chế này đảm bảo độ tin cậy, khả năng truy vết và tính nhất quán dữ liệu giữa eTelecom và hệ thống của đối tác.

3. Cơ chế gửi lại tự động (Retry):

• Hệ thống tự động gửi lại sự kiện nếu lần gửi trước thất bại.

• Thời gian chờ giữa các lần gửi tăng dần (30s → 1p → ... → 24h), tối đa 14 lần thử trước khi chuyển trạng thái webhook sang vô hiệu hóa.

• Đảm bảo không mất sự kiện trong trường hợp kết nối mạng gián đoạn hoặc webhook phía đối tác gặp lỗi tạm thời.

Chân thành cảm ơn các Đối tác/Khách hàng đã luôn đồng hành cùng eTelecom!

Đội ngũ eTelecom.