Registra nel pannello un endpoint HTTPS del tuo sistema per ricevere i ritorni.
Webhook di stato
Ricevi nel tuo sistema lo stato dei messaggi WhatsApp.
Configura un URL per ricevere eventi standardizzati di creazione, consegna, lettura ed errore e consulta lo storico delle consegne tramite API indipendentemente dalla connessione scelta.
Flusso
WPP Marketing avvisa il tuo sistema quando lo stato cambia.
I webhook di stato sono utili per audit, riconciliazione, cruscotti interni, supporto e regole nel proprio sistema.
Attiva solo gli stati di cui il tuo sistema ha bisogno per evitare rumore operativo.
Creazione, consegna, lettura o errore vengono normalizzate allo stesso modo, indipendentemente dalla connessione selezionata.
Il tuo endpoint elabora il payload e lo storico delle consegne diventa disponibile nel pannello e tramite GET /webhooks.
Eventi disponibili e consultazione delle consegne.
I quattro eventi utilizzano lo stesso contratto in qualsiasi connessione e l'API consente di interrogare il risultato di ogni tentativo di consegna.
POST
MESSAGE_CREATED
Il messaggio è stato creato nel flusso e ha ricevuto un identificatore per il tracciamento.
Criação
POST
MESSAGE_DELIVERED
Messaggio consegnato al destinatario quando il canale restituisce la conferma.
Entrega
POST
MESSAGE_READ
Messaggio letto quando la conferma di lettura è disponibile.
Leitura
POST
MESSAGE_ERROR
Il messaggio ha riscontrato un errore durante l'invio, la convalida o l'elaborazione.
Erro
GET
/webhooks
Consulta la cronologia delle consegne con stato, tentativi, risposta HTTP e paginazione. Richiede lo scope webhooks:read.
Logs
Buone pratiche
Prepara il tuo endpoint per ricevere eventi ripetuti e fuori ordine.
I webhook sono invii tra sistemi. Il tuo backend deve rispondere rapidamente, registrare i log e processare in modo idempotente.
Usa un URL sicuro, pubblico e stabile per ricevere gli eventi di callback.
Rispondere con HTTP 200 o 204 dopo aver ricevuto l'evento e processare le attività di lunga durata in una coda interna.
Usa identificatori di messaggio e di evento per evitare duplicati nelle riconsegne.
Registrare payload, data, stato HTTP e risultato dell'elaborazione per audit.
Usa MESSAGE_ERROR per avvisare il supporto o l'operazione di eventuali errori restituiti da una connessione.
I webhook di stato sono risposte di WPP Marketing. Per inviare eventi commerciali del negozio, usa l'Events API.
Vuoi monitorare le consegne e gli errori nel tuo sistema?
Configura un URL nel pannello, scegli gli stati e monitora le consegne nel report dei webhook.