---
title: HubSpot
description: 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.
---

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

<Steps>
<Step>
**Apri Impostazioni → Integrazioni → HubSpot** nel dashboard
(`app.audin.ai`) e premi **Connetti HubSpot**.
</Step>
<Step>
**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.
</Step>
<Step>
**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).
</Step>
</Steps>

## Cosa viene importato

| Oggetto HubSpot | In Audin |
|---|---|
| Contatti | **Lead** del CRM |
| Aziende | **Aziende** |
| Deal | **Deal** (nelle pipeline replicate, vedi sotto) |
| Note, chiamate, email, meeting | **Note** sulla timeline dei record |
| Task | **Attività** |
| 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](#riautorizzare-per-abilitare-nuovi-oggetti)).

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)"**.

<Callout type="warn">
  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.
</Callout>

## 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**.

<Callout type="info">
  **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).
</Callout>

## 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.

<Callout type="info">
  Non esiste un pulsante di disconnessione del portale: la connessione si
  gestisce con **Riconnetti**/**Riautorizza**. Per scollegare
  definitivamente il portale contatta il supporto.
</Callout>

## Prossimi passi

<Cards>
  <Card
    href="/docs/integrazioni/shopify"
    title="Shopify"
    description="Clienti, ordini e spedizioni dello store, con contesto acquisti per i bot."
  />
  <Card
    href="/docs/integrazioni"
    title="Integrazioni"
    description="Le altre integrazioni native della piattaforma."
  />
</Cards>