Đơn hàng, giỏ hàng, thanh toán, vận chuyển, hủy hoặc đăng ký diễn ra trong hệ thống nguồn.
Events API
Gửi sự kiện từ cửa hàng hoặc ERP của bạn để kích hoạt tự động hóa trên WhatsApp.
Sử dụng Events API khi hệ thống của bạn cần thông báo giỏ hàng, đơn hàng, thanh toán, vận chuyển, hủy hoặc tạo khách hàng cho WPP Marketing.
Events API nhận sự kiện thương mại và sử dụng các tự động hóa đã cấu hình. Để gửi tin nhắn trực tiếp, hãy sử dụng Messaging API. Để theo dõi giao hàng, đã đọc và lỗi, hãy sử dụng webhook trạng thái.
Luồng
Hệ thống của bạn báo sự kiện. WPP Marketing quyết định tự động hóa.
Events API lý tưởng cho các cửa hàng tùy chỉnh, ERP, back office và các tích hợp không có connector plug-and-play.
Backend của bạn gửi sự kiện kèm token, định danh, khách hàng, giá trị và các liên kết có sẵn.
WPP Marketing kiểm tra xem có tự động hóa đang hoạt động cho sự kiện và khách hàng đó hay không.
Khách hàng nhận tin nhắn WhatsApp về phục hồi, thanh toán, đơn hàng, vận chuyển, chiến dịch hoặc hậu mãi.
Sự kiện thương mại được hỗ trợ.
Tên cuối cùng và các trường bắt buộc phải tuân theo tài liệu Events API.
POST
cart.created
Ghi nhận ý định mua hàng và cho phép tự động hoá theo dõi ban đầu.
Carrinho
POST
cart.abandoned
Kích hoạt khôi phục giỏ hàng với nhắc nhở và liên kết quay lại khi có sẵn.
Recuperação
POST
order.created
Thông báo đơn hàng được tạo hoặc đang chờ thanh toán cho tin nhắn giao dịch.
Pedido
POST
order.paid
Xác nhận thanh toán và cho phép tin nhắn xác nhận, hướng dẫn và các bước tiếp theo.
Pagamento
POST
order.shipped
Gửi cập nhật vận chuyển, theo dõi hoặc tình trạng hậu cần để giảm các yêu cầu thủ công.
Envio
POST
order.cancelled
Ghi nhận hủy đơn hàng để kích hoạt thông tin liên lạc được cấu hình cho sự kiện này.
Cancelamento
POST
customer.created
Cung cấp dữ liệu cho cơ sở liên hệ để chào mừng, quản lý quan hệ, thẻ và chiến dịch.
Cliente
Dữ liệu được đề xuất
Sự kiện càng tốt, tự động hóa càng hiệu quả.
Events API phải nhận đủ dữ liệu để xác định khách hàng, giao dịch, số tiền, trạng thái và các liên kết hữu ích cho tin nhắn.
Số điện thoại, tên, email, quốc gia và định danh bên ngoài giúp loại trùng và phân đoạn.
Số, ID bên ngoài, tổng, đơn vị tiền tệ, trạng thái, phương thức thanh toán và mục làm cho tin nhắn hữu ích hơn.
Trang thanh toán (checkout), thanh toán, theo dõi hoặc trang đơn hàng có thể được sử dụng trong tin nhắn tự động.
Cung cấp external_id hoặc order.id và giữ nguồn ổn định. Loại bỏ trùng lặp xem xét tài khoản, nguồn đã chuẩn hóa, loại sự kiện và định danh bên ngoài. Các sự kiện lặp lại trả về HTTP 200 với thông báo Duplicate event ignored. Endpoint này không sử dụng header Idempotency-Key của Messaging API.
HTTP 200 xác nhận sự kiện đã được xử lý, không phải là tin nhắn đã được gửi. Việc gửi yêu cầu có automation đang hoạt động cho sự kiện, dữ liệu khách hàng hợp lệ và kết nối được cấu hình. Theo dõi tin nhắn qua báo cáo và webhooks trạng thái.
Tạo credential với events:write và gửi sự kiện từ server. Giữ token ngoài frontend và các kho mã công khai. Sử dụng customer.phone cho số điện thoại và các đối tượng customer và order theo ví dụ và hợp đồng OpenAPI.
Muốn kết nối cửa hàng tùy chỉnh hoặc ERP không?
Mở tài liệu Events API để xác thực payloads, xác thực và các ví dụ trước khi gửi sự kiện vào môi trường production.