Abonamentele la webhook-uri în Livespace CRM permit aplicației tale să primească informații în timp real despre evenimente importante din sistem, de exemplu crearea unei noi oportunități de vânzare sau schimbarea statutului acesteia. Acest lucru facilitează integrarea Livespace cu alte instrumente sau automatizarea proceselor tale.
În acest articol:
Concepte cheie
În Livespace, facem distincția între două concepte: un abonament webhook și un webhook.
Un abonament webhook este o configurație în care specifici:
când trebuie trimise datele (ce evenimente),
unde trebuie trimise (URL),
ce informații ar trebui incluse.
Un webhook este un mesaj individual trimis de Livespace în momentul în care are loc un eveniment, conform setărilor abonamentului.
Reține că abonamentul definește regulile de trimitere, iar webhook-ul este mesajul care este efectiv trimis.
Cum funcționează webhook-urile
Webhook-urile funcționează într-un mod simplu: atunci când se întâmplă ceva important în Livespace, sistemul trimite un webhook (un mesaj) către URL-ul specificat, conform configurației abonamentului.
Fiecare notificare include:
informații despre eveniment (de exemplu: ID-ul tranzacției, statusul, responsabilii, valoarea, produsele),
un header pentru verificarea autenticității,
un secret special (cheie secretă) care asigură securitatea.
După salvarea și activarea unui abonament, Livespace trimite mai întâi o notificare de test către endpoint-ul tău pentru a se asigura că este configurat corect și este pregătit să primească date. Abia după aceea sunt trimise webhook-uri reale pentru evenimentele efective.
Poți găsi documentația tehnică aici:
Prezentare generală a webhook-urilor în Livespace
Administratorii pot gestiona abonamentele webhook în Setări cont → Webhooks.
În lista de abonamente, poți verifica:
dacă abonamentul este activ,
numele și URL-ul acestuia,
evenimentele selectate,
ultima dată când a fost declanșat.
De asemenea, poți:
să activezi sau să dezactivezi abonamentul folosind comutatorul,
să editezi datele acestuia,
să vizualizezi secretul,
să ștergi abonamentele selectate.
Crearea unui nou abonament
Pentru ca Livespace să poată trimite webhook-uri către aplicația ta sau către un instrument extern, trebuie să creezi și să configurezi un abonament webhook.
Un webhook poate trimite date către orice instrument sau sistem care suportă primirea de webhook-uri. Acesta poate fi fie un instrument de integrare gata făcut, fie propriul tău API.
În Setări cont → Webhook-uri, selectează Adaugă abonare.
2. În secțiunea Configurare abonare, furnizează informațiile de bază:
Denumește această abonare – alege un nume pe care îl vei recunoaște ușor mai târziu.
Unde ar trebui să trimitem datele – lipește URL-ul endpoint-ului webhook.
3. Apoi, dă clic pe Următorul: Setează declanșatoarele.
4. Selectează evenimentul pentru care Livespace ar trebui să trimită date.
5. Apoi, dă clic pe Activează abonarea.
În acest moment, abonamentul tău devine activ – în exemplul de mai sus, webhook-urile vor fi trimise atunci când se creează o oportunitate de vânzare.
Dacă adaugi o nouă oportunitate în Livespace, instrumentul extern va primi informații despre aceasta.
Exemplu de primire a datelor în Zapier:
Reține că prima solicitare este o notificare de test trimisă către endpoint-ul tău pentru a te asigura că este configurat corect.
Ce conține notificarea?
Notificarea propriu-zisă conține cele mai importante informații despre oportunitatea de vânzare: ID, nume, status, responsabili, valoare, produse, costuri și etichete.
De unde obții URL-ul webhook-ului?
URL-ul webhook-ului (adresa endpoint) este generat de instrumentul sau sistemul care va primi notificările din Livespace. Poate fi o platformă de automatizare sau propriul tău API.
Mai jos găsești instrucțiuni pentru cele mai utilizate instrumente.
Zapier
Accesează secțiunea Zaps.
Apasă Create și selectează New Zap.
Apasă pe blocul Trigger.
Selectează Webhooks din lista de aplicații.
Alege evenimentul de tip trigger Catch Hook.
Accesează fila Test.
Copiază URL-ul webhook-ului generat.
Exemplu de configurare în Zapier:
Make
Accesează secțiunea Scenarios.
Apasă Create a new scenario.
Selectează Webhooks -> Custom webhook.
Adaugă un webhook nou sau selectează unul existent.
Copiază URL-ul generat.
N8N
Selectează Create workflow.
Apasă Add first step… și alege On webhook call.
Copiază Test URL sau Production URL:
Test URL este utilizat pentru testare,
Production URL poate fi folosit doar după publicarea workflow-ului.
Securitate și funcționalitate
Toate datele trimise prin webhook-uri sunt transmise exclusiv printr-o conexiune HTTPS criptată. Acest lucru asigură că informațiile sunt protejate în timpul transferului prin rețea.
Fiecare notificare conține un header special de verificare, generat pe baza secretului abonamentului. Acest lucru îți permite să verifici că datele provin cu adevărat de la Livespace și nu de la o terță parte. Este o măsură suplimentară de siguranță care crește securitatea integrării.
Dacă endpoint-ul tău (adresa către care se trimit webhook-urile) nu răspunde corect, Livespace va încerca automat să livreze notificarea de încă două ori la intervale scurte.
Webhook-urile funcționează astfel încât:
același eveniment poate fi trimis de mai multe ori,
evenimentele pot ajunge într-o ordine diferită de cea în care au avut loc efectiv.
Prin urmare, aplicația ta ar trebui să fie pregătită pentru acest lucru – de exemplu, verificând identificatori unici ai evenimentelor și răspunzând corespunzător pentru a evita operațiunile duplicate.
Poți găsi mai multe informații despre securitate aici:
Cele mai bune practici
Endpoint-ul tău ar trebui să răspundă rapid.
Dacă te aștepți la un număr mare de notificări, folosește cozi sau servere suplimentare.
Monitorizează endpoint-ul pentru a te asigura că notificările sunt primite.
Ce să faci dacă un webhook nu funcționează?
Problemele cu webhook-urile sunt, de cele mai multe ori, cauzate de o configurație incorectă a abonamentului sau de un endpoint indisponibil. Dacă un webhook nu funcționează, verifică următoarele:
Verifică URL-ul:
Asigură-te că URL-ul începe cu https://.
Dacă folosești instrumente externe (de ex. Zapier, Make), verifică că URL-ul corect a fost copiat de pe platforma lor.
Verifică endpoint-ul:
Livespace trimite o notificare de test după activarea abonamentului.
Endpoint-ul tău trebuie să răspundă cu un status 200 OK sau 204 No Content în maxim 3 secunde.
Dacă nu răspunde, verifică configurația serverului tău.
Verifică evenimentele selectate:
Asigură-te că evenimentele corespunzătoare sunt selectate în abonament.
Dacă webhook-ul a fost configurat anterior (de ex. în Zapier) și apoi încerci să creezi un abonament identic într-un alt cont Zapier sau pentru un alt utilizator, webhook-ul poate să nu fie creat corect.
Testează și monitorizează:
Testează primirea webhook-urilor folosind instrumente precum Zapier, Make sau propriul tău endpoint de test.
Monitorizează log-urile pe partea de recepție pentru a verifica că notificările ajung și sunt procesate corect.
Dacă, după verificarea punctelor de mai sus, webhook-ul încă nu funcționează, contactează Suportul Livespace – te vom ajuta să identifici cauza și să faci ca notificările să funcționeze corect.
Evenimente acceptate
În prezent, Livespace acceptă:
Eveniment | Descriere |
| Declanșat atunci când se creează o nouă oportunitate de vânzare |
| Declanșat atunci când se schimbă statusul unei oportunități de vânzare |