Connetti HubSpot a Elido

L'integrazione HubSpot inoltra gli eventi di conversione Elido in HubSpot come proprietà dei contatti e aggiornamenti delle trattative. Quando qualcuno fa clic su un link tracciato e completa un obiettivo di conversione, Elido invia i dati di attribuzione (sorgente UTM, campagna, click ID) a HubSpot — senza che tu scriva alcun codice.

Connetti tramite OAuth#

1. Vai su Dashboard → Conversioni → HubSpot → Connetti HubSpot.
2. Si apre la schermata OAuth di HubSpot. Accedi con un account che ha accesso "CRM → Objects".
3. HubSpot mostra gli scope richiesti: crm.objects.contacts.write e crm.objects.deals.write. Questi permettono a Elido di scrivere nelle proprietà dei contatti e spostare le trattative nelle fasi.
4. Fai clic su Connect app. HubSpot ti reindirizza su Elido.

I token di aggiornamento ruotano automaticamente. Se revochi l'accesso dal lato HubSpot (Impostazioni → App Connesse), Elido smette immediatamente di inviare eventi e mostra un errore "token revocato" nel log di consegna.

Mappa i campi#

Dopo la connessione, vai su Dashboard → Conversioni → HubSpot → Configura:

1. Proprietà contatto — scegli quali proprietà contatto HubSpot Elido scrive. Campi Elido disponibili: utm_source, utm_medium, utm_campaign, utm_content, utm_term, click_id, link_slug.
2. Fase della trattativa — seleziona la pipeline e la fase a cui una conversione sposta una trattativa. Lascia vuoto se non usi le trattative HubSpot.
3. Abbina contatto per — email (se catturi l'email tramite la tua landing page) o HubSpot contact ID (per attribuzione lato server dove passi hs_contact_id nell'URL).

Cosa Elido scrive in HubSpot#

Ogni conversione crea un evento timeline HubSpot e (se mappato) aggiorna le proprietà del contatto. Il payload raw che Elido invia:

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

HubSpot lo mostra come evento timeline personalizzato nel record del contatto. L'aggiornamento della fase della trattativa (se configurato) avviene nella stessa richiesta.

Cosa non si sincronizza#

• Eventi di clic senza conversione — i clic grezzi non creano record HubSpot. Solo le conversioni lo fanno.
• Dati storici — l'integrazione è solo in avanti dal momento della connessione.
• HubSpot → Elido — l'integrazione è solo in uscita. I cambiamenti di fase delle trattative in HubSpot non influenzano i link Elido.

Risoluzione dei problemi#

Errore "Insufficient permissions" — L'utente HubSpot che ha autorizzato non aveva accesso in scrittura CRM. Chiedi a un super admin HubSpot di ri-autorizzare da Dashboard → Conversioni → HubSpot → Riconnetti.

Contatto non trovato — eventi scartati — Se Elido non riesce a trovare un contatto corrispondente per email o ID, l'evento viene registrato ma non inoltrato. Controlla Dashboard → Conversioni → Log di consegna per le voci "no matching contact".

Conversioni che arrivano con attribuzione campagna errata — Verifica che i parametri UTM siano presenti sull'URL di destinazione. Elido li cattura dal clic; se il link non ha UTM, i campi HubSpot saranno vuoti.

OAuth continua a scadere — HubSpot revoca i token per le app che non chiamano l'endpoint di aggiornamento da 6+ mesi. L'integrazione Elido si aggiorna ad ogni evento. Se non hai ricevuto conversioni per mesi, riconnetti manualmente.