Webhooks
Secțiune: Integrări & AI
URL:/admin/webhooks
Titlu pagină: Webhooks
Prezentare generală
Webhooks vă permit să trimiteți evenimente CRM către orice endpoint HTTP extern în timp real. Când apare un eveniment CRM configurat — un contact este creat, o factură este adăugată, o sarcină este finalizată — sistemul declanșează o cerere HTTP POST (sau GET/DELETE) către URL-ul specificat cu payload-ul evenimentului.
Valoare pentru business
Conectează CRM-ul la orice sistem extern, platformă de automatizare (Zapier, Make, n8n) sau integrare personalizată fără polling. Evenimentele sunt livrate în momentul în care se întâmplă.
- Cine îl folosește: IT, dezvoltatori, echipa de integrări, administratori CRM
- Beneficiu principal: Flux de date în timp real către sisteme externe; eliminați importurile/exporturile programate și reacționați instantaneu la evenimentele CRM.
- Metrici influențate: Latența integrării, timpul de răspuns al automatizării, acuratețea sincronizării datelor
Cazuri de utilizare tipice:
- Trimiteți date noi de lead-uri într-un canal Slack în timp real
- Declanșați o expediere într-un sistem logistic extern când o notă de livrare este creată în CRM
- Sincronizați statusul de plată al facturii la un sistem de contabilitate în momentul înregistrării plății
- Notificați un sistem de fulfillment personalizat când o comandă de vânzări este confirmată
Accesarea modulului
Din bara laterală de administrare, navigați la Webhooks, sau deschideți direct URL-ul:
/admin/webhooks
Concepte cheie
| Concept | Descriere |
|---|---|
| Webhook | O configurație de endpoint cu nume, URL, metodă, eveniment declanșator și antete opționale |
| Eveniment declanșator | Acțiunea CRM care declanșează webhook-ul (lead creat, factură adăugată, sarcină finalizată etc.) |
| Payload | Corpul JSON trimis la endpoint, incluzând datele evenimentului și câmpurile de îmbinare |
| Jurnal webhook | O înregistrare a fiecărei tentative de livrare cu codul de status HTTP și corpul răspunsului |
| Mod debug | Logare detaliată a detaliilor cerere/răspuns pentru depanare |
Acțiuni frecvente
- Creare webhook — definiți numele, URL-ul țintă, metoda HTTP (POST/GET), evenimentul declanșator și orice antete personalizate.
- Adăugare câmpuri de îmbinare — inserați valori dinamice ale câmpurilor CRM în payload folosind token-urile disponibile.
- Activare / dezactivare — comutați un webhook fără a-l șterge.
- Vizualizare jurnale — deschideți jurnalul webhook pentru a vedea fiecare tentativă de livrare, statusul HTTP și corpul brut al răspunsului.
- Vizualizare detaliu jurnal — intrați într-o intrare specifică din jurnal pentru a depana payload-ul și răspunsul.
- Activare mod debug — capturați detaliile complete ale cererii/răspunsului pentru un webhook în timpul dezvoltării.
- Testare livrare — trimiteți un payload de test pentru a verifica că endpoint-ul este accesibil și parsează corect.
Folosiți Testare Livrare pe un webhook nou înainte de activare — aceasta confirmă că endpoint-ul este accesibil, structura payload-ului este corectă și antetele de autentificare funcționează înainte ca evenimentele CRM reale să declanșeze webhook-ul.
Un webhook greșit configurat care returnează erori repetate va continua să reîncerce livrarea. Verificați Jurnalul Webhook regulat și dezactivați webhook-urile care eșuează pentru a preveni sarcina inutilă pe endpoint-ul țintă și pentru a evita ratarea detectării evenimentelor.
Sursă: crm-connect-main/app/modules/webhooks