Collega HubSpot a Elido

L'integrazione con HubSpot scrive i clic sui link in HubSpot come eventi personalizzati della timeline. Quando qualcuno fa clic su un link monitorato ed Elido riesce a collegare il clic a un indirizzo email, l'evento compare nella scheda di quel contatto in HubSpot.

Collegare tramite OAuth

1. In Elido, apri Dashboard → Integrations → HubSpot e avvia la connessione.
2. Si apre la schermata OAuth di HubSpot. Accedi con un account autorizzato a installare app nel tuo portale.
3. HubSpot mostra gli scope richiesti: lettura e scrittura dei contatti, eventi della timeline e automazione. Elido cerca i contatti tramite email e scrive su di essi gli eventi della timeline.
4. Approva l'app. HubSpot ti reindirizza a Elido.

I refresh token vengono rinnovati automaticamente. Se revochi l'accesso dal lato HubSpot (Settings → Connected Apps), Elido non potrà più scrivere eventi finché non ricolleghi l'account.

Come un clic viene associato a un contatto

Elido cerca un indirizzo email in quest'ordine e usa il primo valido:

1. Un valore email passato insieme all'evento di clic.
2. metadata.email sull'evento di clic.
3. utm_content, se contiene un indirizzo email.
4. Un parametro di query email= nell'URL di destinazione (uno schema comune nelle email transazionali).

Poi cerca quell'email tra i tuoi contatti HubSpot. Se nessun contatto corrisponde, non viene scritto nulla.

Cosa scrive Elido in HubSpot

Per ogni clic associato viene creato sul contatto un evento della timeline con questi token:

• short_url e destination_url
• campaign (da utm_campaign) e source (da utm_source)
• occurred_at

HubSpot lo mostra come evento personalizzato della timeline nella scheda del contatto. Elido non modifica le proprietà dei contatti né i deal.

Cosa non viene sincronizzato

• Clic senza email - se Elido non riesce a identificare un'email, il clic viene ignorato.
• Conversioni - gli eventi di conversione non vengono ancora inviati a HubSpot (vedi la nota Pianificato qui sopra).
• Dati storici - l'integrazione vale solo da quando la colleghi in avanti.
• HubSpot → Elido - solo in uscita. Le modifiche in HubSpot non tornano a Elido.

Risoluzione dei problemi

I clic non compaiono sul contatto - Verifica che l'email raggiunga Elido tramite una delle quattro vie indicate sopra e che in HubSpot esista un contatto con esattamente quell'email (il confronto non distingue maiuscole e minuscole).

Gli eventi si sono interrotti dopo la revoca dell'app - Ricollega da Dashboard → Integrations → HubSpot.

Campaign o source vuoti nell'evento - Elido li ricava dai parametri UTM del clic. Se il link non ha UTM, quei token restano vuoti.