Ordine, carrello, pagamento, spedizione, annullamento o registrazione avvengono nel sistema di origine.
API eventi
Invia eventi dal tuo negozio o ERP per attivare automazioni su WhatsApp.
Usa la Events API quando il tuo sistema deve comunicare a WPP Marketing carrello, ordine, pagamento, spedizione, cancellazione o creazione cliente.
La Events API riceve l'evento commerciale e utilizza le automazioni configurate. Per inviare un messaggio direttamente, usa la Messaging API. Per monitorare consegna, letture e errori, usa il webhook di stato.
Flusso
Il tuo sistema segnala l'evento. WPP Marketing decide l'automazione.
L'Events API è ideale per negozi personalizzati, ERP, back office e integrazioni che non dispongono di un connettore plug-and-play.
Il tuo backend invia l'evento con token, identificatore, cliente, valori e link disponibili.
WPP Marketing verifica se esiste un'automazione attiva per quell'evento e quel cliente.
Il cliente riceve messaggi WhatsApp per recupero, pagamento, ordine, spedizione, campagna o post-vendita.
Eventi commerciali supportati.
La nomenclatura finale e i campi obbligatori devono seguire la documentazione delle Events API.
POST
cart.created
Registra l'intento d'acquisto e consente automazioni per il primo follow-up.
Carrinho
POST
cart.abandoned
Avvia il recupero del carrello con promemoria e link di ritorno quando disponibile.
Recuperação
POST
order.created
Notifica ordine creato o in attesa di pagamento per messaggi transazionali.
Pedido
POST
order.paid
Conferma il pagamento e consente un messaggio di conferma, istruzioni e i passi successivi.
Pagamento
POST
order.shipped
Invia aggiornamenti di spedizione, tracking o stato logistico per ridurre i ticket manuali.
Envio
POST
order.cancelled
Registra l'annullamento dell'ordine per avviare la comunicazione configurata per questo evento.
Cancelamento
POST
customer.created
Alimenta il database contatti per i messaggi di benvenuto, la gestione delle relazioni, i tag e le campagne.
Cliente
Dati consigliati
Più è efficace l'evento, migliore è l'automazione.
L'Events API deve ricevere dati sufficienti per identificare il cliente, l'acquisto, l'importo, lo stato e i link utili per il messaggio.
Numero di telefono, nome, e-mail, paese e identificatore esterno aiutano nella deduplicazione e nella segmentazione.
Numero, ID esterno, totale, valuta, stato, metodo di pagamento e articoli rendono il messaggio più utile.
La pagina di checkout, pagamento, tracciamento o dell’ordine può essere utilizzata nei messaggi automatici.
Fornisci external_id o order.id e mantieni la fonte stabile. La deduplicazione considera account, fonte normalizzata, tipo di evento e identificatore esterno. Gli eventi ripetuti restituiscono HTTP 200 con l’indicazione Duplicate event ignored. Questo endpoint non utilizza l’intestazione Idempotency-Key della Messaging API.
HTTP 200 conferma l’elaborazione dell’evento, non la consegna di un messaggio. L’invio richiede un’automazione attiva per l’evento, dati cliente validi e una connessione configurata. Monitora il messaggio tramite report e webhook di stato.
Crea una credential con events:write e invia gli eventi dal server. Tieni il token fuori dal frontend e dai repository pubblici. Usa customer.phone per il numero di telefono e gli oggetti customer e order come nell'esempio e nel contratto OpenAPI.
Vuoi connettere un negozio personalizzato o un ERP?
Apri la documentazione della Events API per convalidare i payload, l’autenticazione e gli esempi prima di inviare eventi in produzione.