Chuyển tới nội dung chính
ZZalo Platforms

Giới thiệu về Webhook

  • Zalo sẽ gửi các request http (method POST) đến webhook url của ứng dụng khi có tương tác từ người dùng hoặc các thay đổi liên quan đến Offical Account, bao gồm: có người dùng gửi tin nhắn tới Offical Account, các thay đổi liên quan tới bài viết(Article) hoặc cửa hàng(Zalo Shop). Các sự kiện webhook được gửi dưới dạng các yêu cầu POST đến webhook đã đăng ký trong trang cài đặt ứng dụng của bạn.
Lưu ý

Để đạt hiểu suất cao nhất. Webhook Url không nên dùng host:port, thay vào đó hãy dùng domain và phải được cấu hình https.

1. Hướng dẫn cấu hình Webhook​

  • Nhấn chọn "Thay đổi", Webhook Url sẽ được kích hoạt để bạn nhập thông tin vào:
  • Nếu bạn bật tính năng "Lọc cú pháp", webhook của bạn chỉ có thể nhận được các tin nhắn text bắt đầu bằng "#" từ người dùng:
  • Hãy bật Event Webhook mà bạn muốn nhận:

2. Yêu cầu về cấp quyền Official Account cho App:​

3. Yêu cầu hiệu suất cho webhook​

  • Phản hồi tất cả sự kiện webhook với http status code = 200 OK.
  • Phản hồi tất cả sự kiện webhook tối đa 2 giây.

Nếu webhook của bạn không đáp ứng được bất kỳ yêu cầu nào ở trên thì sẽ nhận được thông báo webhook không hoạt động gửi về tài khoản zalo của người quản lý ứng dụng.

4. Retry Event Webhook​

  • Zalo hỗ trợ gửi lại sự kiện về địa chỉ webhook đã đăng ký đối với những sự kiện gửi không thành công (Không mở được connection tới webhook url)
  • Zalo sẽ liên tục gửi lại các sự kiện tương tự sau các mốc thời gian sau: sau 30 giây, sau 5 phút, sau 15 phút, sau 30 phút, sau 1 giờ. Các sự kiện đó với nội dung hoàn toàn tương tự, nhưng sẽ có truyền thêm ở header của request trường "num_retry" - chính là số lần gửi lại sự kiện đó.
  • Bạn cần xử lý để webhook hoạt động lại trong khoảng thời gian sự kiện được gửi lại. Nếu webhook của bạn tiếp tục không đáp ứng được yêu cầu trong khoảng thời gian đó, bạn sẽ nhận được thông báo webhook đã bị vô hiệu hóa và ứng dụng của bạn sẽ bị hủy đăng ký nhận các sự kiện webhook cho Offical Account.
  • Sau khi khắc phục sự cố với webhook. Bạn cần xin quyền nhận sự kiện lại trong trang cài đặt của ứng dụng.