Înapoi la Glosar
Tehnologie
Webhook
Răspuns rapid
Notificare HTTP push trimisă automat când se întâmplă un eveniment - opusul lui "polling".
Concluzii cheie
- Polling REST: întrebi API-ul la fiecare 1-5 min "ai ceva nou?" → 12-60 cereri/oră inutile
- Webhook: te anunță în <1 sec când e ceva nou → 0 cereri inutile, latență minimă
Definiție
Webhook (sau "HTTP callback") e mecanismul prin care un sistem trimite automat un HTTP POST către un URL pre-configurat atunci când se întâmplă un eveniment (comandă nouă, factură emisă, livrare confirmată).
De ce e mai eficient decât polling-ul
- Polling REST: întrebi API-ul la fiecare 1-5 min "ai ceva nou?" → 12-60 cereri/oră inutile
- Webhook: te anunță în <1 sec când e ceva nou → 0 cereri inutile, latență minimă
Evenimente CRMconnect expuse ca webhook
- order.created / order.shipped / order.delivered
- invoice.issued / invoice.paid
- inventory.low_stock / inventory.reserved
- partner.created / partner.updated
- chargeback.received
Bune practici receiver webhook
- Răspunde HTTP 200 rapid (sub 5 sec), procesează asincron
- Validează signature (HMAC) pentru securitate
- Idempotență: același eveniment poate fi livrat de mai multe ori
Actualizat:
Întrebări frecvente
Ce se întâmplă dacă URL-ul meu e jos?+
CRMconnect retry cu exponential backoff (5 min, 30 min, 2h, 12h, 24h). După 5 încercări, evenimentul intră în dead-letter queue, vizibil în admin.