Đă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.
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.
Sử dụng URL an toàn, công khai và ổn định để nhận các sự kiện phản hồi.
Phản hồi bằng HTTP 200 hoặc 204 sau khi nhận sự kiện và xử lý các tác vụ chạy lâu trong hàng đợi nội bộ.
Sử dụng định danh tin nhắn và sự kiện để tránh trùng lặp khi gửi lại.
Ghi lại payload, ngày, trạng thái HTTP và kết quả xử lý để kiểm toán.
Sử dụng MESSAGE_ERROR để cảnh báo bộ phận hỗ trợ hoặc vận hành về các lỗi được trả về bởi bất kỳ kết nối nào.
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.