Conectează HubSpot la Elido

Integrarea HubSpot redirecționează evenimentele de conversie Elido în HubSpot sub formă de proprietăți de contact și actualizări de tranzacții. Când cineva dă clic pe un link urmărit și finalizează un obiectiv de conversie, Elido transmite datele de atribuire (sursă UTM, campanie, ID de clic) către HubSpot — fără să scrii niciun cod.

Conectează-te prin OAuth

1. Mergi la Dashboard → Conversions → HubSpot → Connect HubSpot.
2. Se deschide ecranul OAuth al HubSpot. Autentifică-te cu un cont care are acces „CRM → Objects".
3. HubSpot arată scope-urile solicitate: crm.objects.contacts.write și crm.objects.deals.write. Acestea permit Elido să scrie în proprietățile contactelor și să mute tranzacțiile prin etape.
4. Apasă pe Connect app. HubSpot te redirecționează înapoi către Elido.

Token-urile de reîmprospătare se rotesc automat. Dacă revoci accesul din partea HubSpot (Settings → Connected Apps), Elido oprește imediat trimiterea evenimentelor și afișează o eroare „token revoked" în jurnalul de livrări.

Mapează câmpurile

După conectare, mergi la Dashboard → Conversions → HubSpot → Configure:

1. Contact properties — alege în ce proprietăți de contact HubSpot scrie Elido. Câmpuri Elido disponibile: utm_source, utm_medium, utm_campaign, utm_content, utm_term, click_id, link_slug.
2. Deal stage — selectează pipeline-ul și etapa în care o conversie mută o tranzacție. Lasă gol dacă nu folosești tranzacții HubSpot.
3. Match contact by — email (dacă captezi email-ul prin pagina ta de destinație) sau ID-ul de contact HubSpot (pentru atribuire pe partea de server, unde transmiți hs_contact_id în URL).

Ce scrie Elido în HubSpot

Fiecare conversie creează un eveniment în cronologia HubSpot și (dacă este mapat) actualizează proprietățile contactului. Payload-ul brut pe care îl trimite Elido:

{
  "event": "conversion.recorded",
  "click_id": "clk_abc123",
  "value": 99.0,
  "currency": "EUR",
  "utm": {
    "source": "newsletter",
    "medium": "email",
    "campaign": "spring-2026"
  }
}

HubSpot arată acest lucru ca un eveniment personalizat în cronologia din fișa contactului. Actualizarea etapei tranzacției (dacă este configurată) se declanșează în aceeași cerere.

Ce nu se sincronizează

• Evenimentele de clic fără conversie — clicurile brute nu creează înregistrări în HubSpot. Doar conversiile o fac.
• Datele istorice — integrarea funcționează doar înainte, din momentul conectării.
• HubSpot → Elido — integrarea este doar în ieșire (outbound). Modificările tranzacțiilor din HubSpot nu se transmit înapoi către Elido.

Depanare

Eroare „Insufficient permissions" — Utilizatorul HubSpot care a autorizat nu avea acces de scriere CRM. Cere unui super-administrator HubSpot să reautorizeze din Dashboard → Conversions → HubSpot → Reconnect.

Contact negăsit — evenimente pierdute — Dacă Elido nu poate găsi un contact corespunzător după email sau ID, evenimentul este înregistrat în jurnal, dar nu este redirecționat. Verifică Dashboard → Conversions → Delivery log pentru intrări „no matching contact".

Conversiile sosesc cu atribuire de campanie greșită — Verifică dacă parametrii UTM sunt prezenți pe URL-ul de destinație. Elido îi capturează din clic; dacă linkul nu are UTM-uri, câmpurile HubSpot vor fi goale.

OAuth-ul expiră constant — HubSpot revocă token-urile pentru aplicațiile care nu apelează endpoint-ul de reîmprospătare timp de 6+ luni. Integrarea Elido se reîmprospătează la fiecare eveniment. Dacă nu ai primit nicio conversie de luni de zile, reconectează-te manual.