Î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.
Webhook-ul raportează rezultatul unui mesaj; nu este o cerere de trimitere. Folosiți Messaging API pentru a trimite mesaje și Events API pentru declanșarea automatizărilor cu evenimente comerciale acceptate.
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.
Înregistrați un URL public HTTPS și activați evenimentele în panou. Contractul actual nu trimite o semnătură HMAC; configurați protecția și validarea adecvate pentru receptor fără a presupune o semnătură care nu există.
Răspundeți cu HTTP 2xx în maximum 15 secunde și procesați sarcinile de durată într-o coadă internă. Redirecționările nu sunt urmărite.
Folosiți id-ul evenimentului, trimis și în Webhook-Id, pentru a evita procesarea duplicată și a accepta evenimentele în afara ordinii. Webhook-Attempt indică numărul încercării. Doar evenimentele activate sunt înregistrate și trimise.
Consultați încercările și răspunsurile HTTP la GET /webhooks cu webhooks:read. Înregistrările finalizate, livrate sau eșuate definitiv sunt păstrate timp de 30 de zile. Protejați datele personale și conținutul mesajelor în propriile jurnale.
Defecțiuni de conexiune, timeout-uri și răspunsuri 408, 425, 429 sau 5xx pot declanșa până la șapte încercări în total, cu intervale de 1, 5 și 15 minute, și 1, 6 și 24 ore. Retry-After este respectat până la 24 de ore. Alte erori 4xx opresc livrarea.
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.