Pesanan, troli, pembayaran, penghantaran, pembatalan atau pendaftaran berlaku dalam sistem sumber.
Events API
Hantar acara dari kedai atau ERP anda untuk mencetuskan automasi di WhatsApp.
Gunakan Events API apabila sistem anda perlu melaporkan troli, pesanan, pembayaran, penghantaran, pembatalan atau penciptaan pelanggan kepada WPP Marketing.
Events API menerima acara komersial dan menggunakan automasi yang dikonfigurasikan. Untuk menghantar mesej terus, gunakan Messaging API. Untuk menjejak penghantaran, bacaan dan ralat, gunakan webhook status.
Aliran
Sistem anda melaporkan acara. WPP Marketing menentukan automasi.
Events API sesuai untuk kedai tersuai, ERP, back office dan integrasi yang tidak mempunyai penyambung plug-and-play.
Backend anda menghantar acara dengan token, pengecam, pelanggan, nilai dan pautan tersedia.
WPP Marketing memeriksa sama ada terdapat automasi aktif untuk acara dan pelanggan tersebut.
Pelanggan menerima mesej WhatsApp untuk pemulihan, pembayaran, pesanan, penghantaran, kempen atau selepas jualan.
Acara komersial yang disokong.
Penamaan akhir dan medan wajib mesti mengikut dokumentasi Events API.
POST
cart.created
Merekod niat pembelian dan membolehkan automasi susulan awal.
Carrinho
POST
cart.abandoned
Mengaktifkan pemulihan troli dengan peringatan dan pautan kembali apabila tersedia.
Recuperação
POST
order.created
Memaklumkan pesanan dibuat atau menunggu pembayaran untuk mesej transaksional.
Pedido
POST
order.paid
Mengesahkan pembayaran dan membenarkan mesej pengesahan, arahan dan langkah seterusnya.
Pagamento
POST
order.shipped
Menghantar kemas kini penghantaran, penjejakan atau status logistik untuk mengurangkan tiket manual.
Envio
POST
order.cancelled
Merekod pembatalan pesanan untuk mencetuskan komunikasi yang dikonfigurasikan untuk acara ini.
Cancelamento
POST
customer.created
Memberi makan pangkalan kenalan untuk sambutan, pengurusan hubungan, tag dan kempen.
Cliente
Data yang disyorkan
Semakin baik acara, semakin baik automasi.
Events API mesti menerima data yang mencukupi untuk mengenal pasti pelanggan, pembelian, jumlah, status dan pautan berguna untuk mesej.
Nombor telefon, nama, e-mel, negara dan pengecam luaran membantu dalam deduplikasi dan segmentasi.
Nombor, ID luaran, jumlah, mata wang, status, kaedah pembayaran dan item menjadikan mesej lebih berguna.
Halaman checkout, pembayaran, penjejakan atau halaman pesanan boleh digunakan dalam mesej automatik.
Sediakan external_id atau order.id dan kekalkan sumber stabil. Penghapusan duplikasi mengambil kira akaun, sumber dinormalisasi, jenis acara dan pengecam luaran. Acara berulang mengembalikan HTTP 200 dengan petunjuk Duplicate event ignored. Endpoint ini tidak menggunakan header Idempotency-Key daripada Messaging API.
HTTP 200 mengesahkan acara telah diproses, bukan bahawa mesej telah dihantar. Penghantaran memerlukan automasi aktif untuk acara tersebut, data pelanggan yang sah dan sambungan yang dikonfigurasi. Jejaki mesej melalui laporan dan webhook status.
Buat credential dengan events:write dan hantar acara dari pelayan. Simpan token di luar frontend dan repositori awam. Gunakan customer.phone untuk nombor telefon dan objek customer dan order seperti dalam contoh dan kontrak OpenAPI.
Ingin menyambungkan kedai tersuai atau ERP?
Buka dokumentasi Events API untuk mengesahkan payload, pengesahan dan contoh sebelum menghantar acara ke pengeluaran.