HubSpot
Integrazione HubSpot
CRMDisponibile
BRAIAN si collega a HubSpot tramite Private app token. Gli agenti possono lettura di contatti e deal, aggiornamento delle lifecycle stage e lettura dei dati di campagna. Ogni azione è limitata dai permessi concessi all'integrazione, eseguita sotto una policy versionata e registrata nell'audit log con l'agente, l'orario e il record interessato.
Che cosa può fare BRAIAN?
SalesAgent e MaAgent leggono contatti, deal e dati delle campagne, aggiornano le lifecycle stage e registrano le attività che eseguono. La connessione usa un token di private app i cui scope sono impostati per portale.
| Capacità | Agente | Lettura o scrittura |
|---|---|---|
| Lettura di contatti e deal | SalesAgent | Lettura |
| Aggiornamento delle lifecycle stage | MaAgent | Scrittura |
| Lettura dei dati di campagna | MaAgent | Lettura |
| Registrazione delle attività | SalesAgent | Scrittura |
Come si collega?
- Metodo di connessione
- Private app token
- Credenziale
- Un token di private app HubSpot, creato nel portale del cliente e revocabile in qualsiasi momento.
Le credenziali sono custodite in un secrets store cifrato. BRAIAN non conserva mai le password degli utenti finali.
Quali permessi sono richiesti?
- crm.objects.contacts / crm.objects.dealsLettura e scrittura sugli oggetti CRM usati dai processi configurati.
- marketing.campaigns.readDati di performance delle campagne, in sola lettura.
I permessi sono richiesti al livello minimo necessario ai processi configurati. Gli scope non utilizzati non vengono concessi.
Quali processi la usano?
Processi che girano su questa connessione e domini a cui appartengono.
Processo inbound
Processo outbound
Offerta
Come si revoca l'accesso?
L'accesso si revoca in HubSpot stesso — disattivando la credenziale o rimuovendo gli scope concessi — oppure in BRAIAN disconnettendo l'integrazione. I processi già in esecuzione si fermano alla chiamata successiva verso HubSpot e restano in attesa di revisione invece di completarsi con dati parziali; l'interruzione e lo stato di ogni processo sono registrati nell'audit log.
Domande frequenti
BRAIAN conserva i dati di HubSpot?
BRAIAN legge ciò che serve a un processo, quando serve. I record recuperati da HubSpot sono trattenuti solo per la durata del processo e nella traccia di audit delle azioni compiute; HubSpot resta il sistema di registrazione.
Cosa succede se la connessione si interrompe durante un processo?
Il processo si ferma allo step fallito e resta in attesa di revisione. Nulla viene scritto due volte: le scritture già completate restano nell'audit log e gli step rimanenti riprendono solo a connessione ripristinata.
I permessi possono essere definiti per agente?
Sì. Gli scope sono definiti per agente, non per sistema: sulla stessa connessione verso HubSpot un agente può leggere e un altro no.
