Audin Docs
Integrazioni

HubSpot

Collegare un portale HubSpot ad Audin — import in sola lettura di contatti, aziende, deal, attività e commerce, pipeline replicate, protezione dei record sincronizzati, riautorizzazione per i nuovi permessi e semantica delle cancellazioni.

Versione Markdown di questa pagina

Scarica o copia il contenuto di questa pagina in formato .md — utile per fornirlo a un agente AI che integra questa specifica feature.

Scarica .md

L'integrazione HubSpot importa in Audin contatti, aziende, deal, note e attività dal tuo portale — e, con i permessi aggiuntivi, anche prodotti, righe prodotto e preventivi — tenendoli aggiornati con sincronizzazioni orarie e notifiche in tempo reale.

Il principio da conoscere prima di tutto: l'integrazione è unidirezionale, da HubSpot verso Audin. HubSpot resta la fonte di verità: Audin non scrive mai nulla sul portale, e i campi importati sono protetti da modifica in Audin (si modificano su HubSpot).

Collegare il portale

Apri Impostazioni → Integrazioni → HubSpot nel dashboard (app.audin.ai) e premi Connetti HubSpot.

Premi "Continua su HubSpot". Non serve inserire nulla: vieni portato su HubSpot, dove scegli il portale e approvi i permessi (tutti di sola lettura). Hai 10 minuti per completare, poi la sessione scade.

Torni su Audin ("HubSpot collegato con successo!") e parte l'import iniziale completo. La dashboard mostra il portale collegato, i permessi concessi e la tabella "Oggetti sincronizzati" con lo stato di ogni oggetto (ultima sync, esito, record creati/aggiornati).

Cosa viene importato

Oggetto HubSpotIn Audin
ContattiLead del CRM
AziendeAziende
DealDeal (nelle pipeline replicate, vedi sotto)
Note, chiamate, email, meetingNote sulla timeline dei record
TaskAttività
Prodotti †Catalogo Prodotti
Righe prodotto †Righe dei deal/preventivi
Preventivi †Preventivi (in sola lettura, vedi sotto)

† Solo se i permessi commerce sono stati concessi (vedi Riautorizzare).

Vengono importate anche le associazioni (contatto↔azienda, deal↔contatti/aziende) e gli owner: gli owner HubSpot che non corrispondono a un utente Audin compaiono in Impostazioni → Team nella card "Owner importati da HubSpot", con il badge "da invitare" — invitandoli, all'accettazione il loro account viene collegato automaticamente e i record importati risultano già assegnati a loro.

Pipeline replicate

Le pipeline deal di HubSpot vengono replicate in Audin (stessi stage, stesso ordine), e gli stati lead di HubSpot diventano una pipeline dedicata chiamata "Stato Lead (HubSpot)".

Le pipeline replicate sono gestite dalla sincronizzazione: rinominarle o riordinarle in Audin non serve — alla passata successiva tornano come su HubSpot. Le modifiche strutturali si fanno sul portale. Le pipeline native di Audin non vengono mai toccate.

Record protetti (e dove vedere tutti i dati)

Sui record importati, i campi gestiti da HubSpot sono bloccati con un lucchetto (es. nome, email, telefono e stato sui lead; nome, dominio e settore sulle aziende; titolo e importo sui deal): il tooltip dice "Stato gestito dalla sorgente dati — modificalo alla sorgente". Restano invece liberi i campi operativi di Audin (assegnatario, priorità, tag, consensi, richiamate).

I preventivi importati hanno il badge HubSpot e non sono modificabili né inviabili da Audin: l'azione disponibile è "Apri su HubSpot". Lo stesso vale per le righe prodotto importate.

Tutte le proprietà HubSpot — anche quelle senza un campo dedicato in Audin — sono conservate senza perdite e consultabili dal pannello "Tutte le proprietà" sulla scheda del record, diviso in Campi anagrafici, Campi personalizzati e Dati tecnici.

Un campo svuotato su HubSpot non svuota il campo in Audin: la sincronizzazione sovrascrive solo con valori presenti. È una scelta deliberata per non perdere dati raccolti da altri canali (es. un telefono captato dal voice bot).

Aggiornamento dei dati

  • Ogni ora una passata incrementale allinea tutti gli oggetti.
  • In tempo reale arrivano le notifiche per contatti, aziende, deal, prodotti e righe prodotto (creazioni, cancellazioni e modifiche ai campi principali). Note, attività e preventivi si aggiornano alla passata oraria.
  • Per forzare una sincronizzazione manuale usa Impostazioni → Sorgenti dati, dove ogni oggetto HubSpot ha i pulsanti "Sincronizza ora" e "Risincronizza tutto".

Riautorizzare per abilitare nuovi oggetti

Se la connessione è stata fatta prima che Audin richiedesse i permessi commerce, la dashboard mostra un banner giallo: "Riautorizza per abilitare Prodotti e Preventivi. La connessione attuale non include i permessi necessari per sincronizzarli." Premi Riautorizza (o Riconnetti in alto a destra): rifai l'approvazione su HubSpot con i permessi aggiornati e al ritorno i nuovi oggetti compaiono nella tabella e iniziano a sincronizzarsi.

Cancellazioni su HubSpot

Quando un record viene cancellato sul portale:

  • contatti, aziende, deal, prodotti, note e attività restano in Audin ma vengono scollegati dalla sorgente: nessun dato va perso, e da quel momento diventano record normali, di nuovo modificabili in Audin;
  • preventivi e righe prodotto importati vengono invece eliminati (non hanno senso senza la loro sorgente). I preventivi nativi di Audin non sono mai toccati.

Non esiste un pulsante di disconnessione del portale: la connessione si gestisce con Riconnetti/Riautorizza. Per scollegare definitivamente il portale contatta il supporto.

Prossimi passi

On this page