Înregistrează în panou un endpoint HTTPS din sistemul tău pentru a primi returnările.
Webhook-uri de stare
Primește în sistemul tău starea mesajelor WhatsApp.
Configurează un URL pentru a primi evenimente standardizate de creare, livrare, citire și eroare și consultă istoricul livrărilor prin API, indiferent de conexiunea aleasă.
Flux
WPP Marketing anunță sistemul dvs. când se schimbă statusul.
Webhooks de status sunt utile pentru audit, reconciliere, tablouri de bord interne, suport și reguli în propriul dvs. sistem.
Activează numai statusurile pe care sistemul tău trebuie să le prelucreze pentru a evita zgomotul operațional.
Crearea, livrarea, citirea sau eroarea sunt normalizate în același mod, indiferent de conexiunea selectată.
Endpoint-ul tău procesează payload-ul, iar istoricul livrărilor devine disponibil în panou și prin GET /webhooks.
Evenimente disponibile și interogare a livrărilor.
Toate cele patru evenimente folosesc același contract pe orice conexiune, iar API permite interogarea rezultatului fiecărei încercări de livrare.
POST
MESSAGE_CREATED
Mesajul a fost creat în flux și a primit un identificator pentru urmărire.
Criação
POST
MESSAGE_DELIVERED
Mesajul a fost livrat destinatarului atunci când canalul a returnat confirmarea.
Entrega
POST
MESSAGE_READ
Mesajul a fost citit când confirmarea de citire este disponibilă.
Leitura
POST
MESSAGE_ERROR
Mesajul a întâmpinat o eroare la trimitere, validare sau procesare.
Erro
GET
/webhooks
Vizualizați istoricul livrărilor cu status, încercări, răspuns HTTP și paginare. Necesită scope-ul webhooks:read.
Logs
Cele mai bune practici
Pregătiți endpoint-ul pentru a primi evenimente repetate și primite în afara ordinii.
Webhooks sunt livrări între sisteme. Backend‑ul tău trebuie să răspundă rapid, să înregistreze loguri și să proceseze idempotent.
Folosiți o adresă URL sigură, publică și stabilă pentru a primi evenimentele de callback.
Răspundeți cu HTTP 200 sau 204 după primirea evenimentului și procesați sarcinile de durată lungă într-o coadă internă.
Folosiți identificatori de mesaj și eveniment pentru a preveni duplicarea la re-livrări.
Înregistrați payload, data, statusul HTTP și rezultatul procesării pentru audit.
Utilizați MESSAGE_ERROR pentru a alerta suportul sau operațiunile cu privire la erorile returnate de orice conexiune.
Webhooks de status sunt răspunsuri de la WPP Marketing. Pentru a trimite evenimente comerciale ale magazinului, folosește Events API.
Vrei să monitorizezi livrările și erorile din sistemul tău?
Configurează o adresă URL în panou, alege stările și urmărește livrările în raportul webhooks.