Đăng ký một endpoint HTTPS của hệ thống bạn trên bảng điều khiển để nhận phản hồi.
Webhook trạng thái
Nhận trạng thái tin nhắn WhatsApp trong hệ thống của bạn.
Cấu hình một URL để nhận các sự kiện chuẩn hóa về tạo, giao, đã đọc và lỗi, và kiểm tra lịch sử giao hàng qua API bất kể kết nối được chọn.
Luồng
WPP Marketing thông báo cho hệ thống của bạn khi trạng thái thay đổi.
Webhook trạng thái hữu ích cho kiểm toán, đối chiếu, bảng điều khiển nội bộ, hỗ trợ và các quy tắc trong hệ thống của bạn.
Webhook thông báo kết quả của một tin nhắn; nó không phải là yêu cầu gửi. Sử dụng Messaging API để gửi tin nhắn và Events API để kích hoạt tự động hóa với các sự kiện thương mại được hỗ trợ.
Chỉ bật các trạng thái mà hệ thống của bạn cần xử lý để tránh nhiễu hoạt động.
Việc tạo, giao, đọc hoặc lỗi được chuẩn hóa theo cùng một cách bất kể kết nối được chọn.
Endpoint của bạn xử lý payload và lịch sử giao hàng sẽ có sẵn trên bảng điều khiển và qua GET /webhooks.
Sự kiện có sẵn và tra cứu đơn hàng/giao hàng.
Cả bốn sự kiện đều sử dụng cùng một hợp đồng trên bất kỳ kết nối nào, và API cho phép truy vấn kết quả của từng lần thử gửi.
POST
MESSAGE_CREATED
Tin nhắn đã được tạo trong luồng và nhận được mã định danh để theo dõi.
Criação
POST
MESSAGE_DELIVERED
Tin nhắn đã được giao tới người nhận khi kênh trả về xác nhận.
Entrega
POST
MESSAGE_READ
Tin nhắn đã được đọc khi biên nhận đã đọc có sẵn.
Leitura
POST
MESSAGE_ERROR
Tin nhắn gặp lỗi khi gửi, xác thực hoặc xử lý.
Erro
GET
/webhooks
Xem lịch sử giao hàng với trạng thái, số lần thử, phản hồi HTTP và phân trang. Yêu cầu phạm vi webhooks:read.
Logs
Thực hành tốt nhất
Chuẩn bị endpoint của bạn để nhận các sự kiện bị lặp và không theo thứ tự.
Webhook là các chuyển giao giữa hệ thống. Backend của bạn nên phản hồi nhanh, ghi log và xử lý một cách idempotent.
Đăng ký một URL HTTPS công khai và bật sự kiện trong bảng điều khiển. Hợp đồng hiện tại không gửi chữ ký HMAC; cấu hình bảo vệ và xác thực phù hợp cho bộ nhận mà không giả định chữ ký không tồn tại.
Phản hồi bằng HTTP 2xx trong vòng 15 giây và xử lý các tác vụ tốn thời gian trong hàng đợi nội bộ. Không theo dõi chuyển hướng.
Sử dụng id của sự kiện, cũng được gửi trong Webhook-Id, để tránh xử lý trùng lặp và chấp nhận các sự kiện không theo thứ tự. Webhook-Attempt cho biết số lần thử. Chỉ các sự kiện được bật mới được ghi nhận và gửi.
Xem các lần thử và phản hồi HTTP tại GET /webhooks với webhooks:read. Các bản ghi hoàn thành, đã gửi hoặc thất bại vĩnh viễn được giữ trong 30 ngày. Bảo vệ dữ liệu cá nhân và nội dung tin nhắn trong nhật ký của bạn.
Lỗi kết nối, hết thời gian chờ và các phản hồi 408, 425, 429 hoặc 5xx có thể kích hoạt tối đa bảy lần thử tổng cộng, với các khoảng 1, 5 và 15 phút, và 1, 6 và 24 giờ. Retry-After được tôn trọng tối đa 24 giờ. Các lỗi 4xx khác sẽ dừng việc giao hàng.
Webhook trạng thái là phản hồi từ WPP Marketing. Để gửi sự kiện thương mại của cửa hàng, hãy sử dụng Events API.
Muốn theo dõi các lần giao hàng và lỗi trong hệ thống của bạn?
Thiết lập một URL trong trang quản trị, chọn trạng thái và theo dõi các lần giao hàng trong báo cáo webhooks.