Registrare nel pannello un endpoint HTTPS del tuo sistema per ricevere i ritorni.
Webhook di stato
Ricevi nel tuo sistema lo stato dei messaggi di WhatsApp.
Configura un URL per ricevere eventi di coda, creazione, consegna, lettura, errore, numero non trovato, scadenza e logout.
Flusso
Il WPP Marketing avvisa il tuo sistema quando lo stato cambia.
I webhook di stato sono utili per auditing, riconciliazione, dashboard interne, supporto e regole del tuo sistema stesso.
Attiva solo gli stati che il tuo sistema ha bisogno di consumare per evitare rumore operativo.
Consegna, lettura, errore, scadenza, numero non valido o logout vengono rilevati nell'operazione.
L'endpoint elabora il payload, registra il log e aggiorna il tuo pannello interno o regola.
Eventi di ritorno disponibili.
Questi stati aiutano il tuo sistema a sapere cosa è successo dopo che un messaggio è entrato nel flusso di WhatsApp.
POST
QUEUE
Il messaggio è entrato in coda di elaborazione.
Fila
POST
MESSAGE_CREATED
Il messaggio è stato creato nel flusso e ha ricevuto un identificatore per il monitoraggio.
Criação
POST
MESSAGE_DELIVERED
Il messaggio è stato consegnato alla destinazione quando il canale restituisce conferma.
Entrega
POST
MESSAGE_READ
Il messaggio è stato letto, quando è disponibile la conferma di lettura.
Leitura
POST
MESSAGE_ERROR
Il messaggio ha riscontrato errore di invio, validazione o elaborazione.
Erro
POST
LOGOUT
La connessione WhatsApp è stata chiusa e potrebbe richiedere un'azione operativa.
Conexão
Buone pratiche
Prepara il tuo endpoint a ricevere eventi ripetuti e fuori ordine.
I webhook sono consegne tra sistemi. Il tuo backend deve rispondere rapidamente, registrare i log ed elaborare con idempotenza.
Usa URL sicuro, pubblico e stabile per ricevere gli eventi di ritorno.
Rispondi con HTTP 200 o 204 dopo aver ricevuto l'evento e processa i compiti lunghi in coda interna.
Usa identificatori di messaggio e evento per evitare duplicazioni in ri-invio.
Registra payload, data, stato HTTP e risultato dell'elaborazione per auditing.
Usa eventi di errore, numero non trovato e logout per avvisare supporto o operazioni.
Gli Webhook degli stati sono un ritorno di WPP Marketing. Per inviare eventi commerciali del negozio, usa Events API.
Vuoi monitorare le consegne e gli errori nel tuo sistema?
Configura un URL di webhook nel pannello e scegli quali stati devono tornare alla tua applicazione.