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.
Il webhook segnala il risultato di un messaggio; non è una richiesta di invio. Usa il Messaging API per inviare messaggi e il Events API per attivare automazioni con eventi commerciali supportati.
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.
Registra un URL HTTPS pubblica e abilita gli eventi nella dashboard. Il contratto attuale non invia una firma HMAC; configura protezioni e validazioni adeguate per il destinatario senza presumere una firma che non esiste.
Rispondi con un HTTP 2xx entro 15 secondi e elabora le attività di lunga durata in una coda interna. I reindirizzamenti non vengono seguiti.
Usa l'id dell'evento, inviato anche in Webhook-Id, per evitare elaborazioni duplicate e accettare eventi fuori ordine. Webhook-Attempt indica il numero di tentativo. Vengono registrati e inviati solo gli eventi abilitati.
Consulta tentativi e risposte HTTP in GET /webhooks con webhooks:read. I record completati, consegnati o con errore definitivo vengono mantenuti per 30 giorni. Proteggi i dati personali e il contenuto dei messaggi nei tuoi log.
Guasti di connessione, timeout e risposte 408, 425, 429 o 5xx possono generare fino a sette tentativi in totale, con intervalli di 1, 5 e 15 minuti e 1, 6 e 24 ore. Retry-After è rispettato fino a 24 ore. Altri errori 4xx interrompono la consegna.
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.