Tutoriale

Integrare prin webhook: trimite firmele noi în CRM-ul tău

12 iulie 2026

Integrare prin webhook: trimite firmele noi în CRM-ul tău

Webhook-ul conectează PilotAutomat direct la sistemul tău (CRM, foaie de calcul, aplicație proprie). De fiecare dată când se întâmplă ceva important într-o campanie, îți trimitem automat un mesaj la o adresă aleasă de tine, ca să imporți datele fără copiere manuală. Funcția este disponibilă pe planurile care o includ.

Ce evenimente primești

  • company.new: o firmă nouă a fost detectată și înrolată în campanie. Primești datele complete ale firmei: CUI, denumire, nr. reg. com., cod CAEN, adresa completă (județ, localitate, stradă, cod poștal) și detaliile SIRUTA.
  • link.click: un destinatar a dat click pe link. Trimitem doar click-urile reale, ale oamenilor, accesările automate ale roboților sunt filtrate.
  • call.click: un destinatar a apăsat pe numărul de telefon din pagina ta.

Cum îl activezi

  1. În campanie, mergi la pasul de livrare, la secțiunea Webhook (integrare CRM).
  2. Completează adresa webhook (trebuie să fie https și publică, nu o adresă internă).
  3. Salvează. Îți generăm automat o cheie de semnătură pe care o folosești ca să verifici că evenimentele vin de la noi.
  4. Apasă Trimite eveniment de test ca să confirmi că sistemul tău primește corect datele.

Cum verifici semnătura

Fiecare cerere e semnată. În antetul X-PilotAutomat-Signature primești valoarea sha256=<semnătură>, calculată cu HMAC-SHA256 peste corpul exact al cererii, folosind cheia ta secretă. În sistemul tău, recalculezi aceeași semnătură și o compari: dacă se potrivește, cererea e autentică. Mai primești și antetul X-PilotAutomat-Event (tipul evenimentului) și X-PilotAutomat-Delivery (id-ul livrării).

Cum arată datele trimise

Corpul cererii e JSON, cu un plic standard și datele evenimentului în câmpul data:

{
  "id": "…",
  "event": "company.new",
  "campaign_id": 42,
  "campaign_name": "Firme noi Cluj",
  "occurred_at": "2026-07-12T10:00:00Z",
  "data": {
    "cui": "12345678",
    "name": "Alpha SRL",
    "nr_reg_com": "J12/2983/2022",
    "caen": "6201",
    "phone": "+40721111111",
    "address": { "county": "CLUJ", "locality": "Cluj-Napoca", "street": "Memorandumului", "postal_code": "400114" },
    "siruta": { "code": "54975", "locality_name": "CLUJ-NAPOCA", "urban_rural": "1" }
  }
}

Corelezi evenimentele între ele după CUI sau după telefon, prezente în toate evenimentele.

Livrare sigură și retrimitere

Trimitem în fundal, cu reîncercări automate dacă serverul tău nu răspunde pe moment. Sub câmpul webhook vezi ultimele livrări cu starea lor (reușit, în așteptare sau eșuat) și codul de răspuns, ca să depistezi rapid o eventuală problemă de configurare.