CRM e vendite
Connettere HubSpot a un agente IA autonomo
Un agente Atako connesso a HubSpot può leggere e aggiornare contatti, aziende, deal e ticket, ma solo gli oggetti e le azioni coperti dal suo grant.
Workflow possibili
Arricchimento e qualificazione dei lead in entrata
Non appena un contatto arriva nel CRM, l'agente lo recupera con get_contact, incrocia le informazioni disponibili, aggiorna le sue proprietà (update_contact), registra una nota di qualificazione (create_note) e crea un'attività di follow-up per il commerciale interessato (create_task). Il commerciale mantiene il controllo sulla chiamata o sull'email, l'agente gli evita solo l'inserimento dati e la ricerca preliminare che normalmente precedono un primo contatto utile, spesso rimandata per mancanza di tempo disponibile nella giornata.
Sollecito dei deal fermi nella pipeline
L'agente cerca i deal senza movimento da un certo numero di giorni (search_deals, list_pipelines per conoscere le fasi), crea un'attività di sollecito per il proprietario del deal identificato tramite list_owners, e può aggiornare lo stato se una regola chiara lo giustifica (update_deal). Nulla viene spostato senza lasciare una traccia consultabile nel CRM, il che evita pipeline gonfiate da deal fantasma che nessuno sollecita davvero.
Creazione di ticket di supporto collegati a un account
A partire da un segnale ricevuto via email o Slack, l'agente crea un ticket (create_ticket), lo associa al contatto e all'azienda giusti (create_association), poi ne segue l'avanzamento e lo aggiorna nel corso della conversazione (update_ticket). Il ticket resta visibile e modificabile dal team supporto come qualsiasi altro, con lo storico completo dell'account già collegato fin dalla sua creazione.
Azioni del connettore
get_contact (lettura)
Recupera un contatto CRM tramite identificativo.
search_contacts (lettura)
Cerca contatti per testo o filtri sulle proprietà.
get_deal (lettura)
Recupera un deal CRM tramite identificativo.
list_deals (lettura)
Elenca i deal CRM, con paginazione.
list_pipelines (lettura)
Elenca le pipeline e le loro fasi (deal o ticket).
list_owners (lettura)
Elenca i proprietari CRM, filtrabile per email.
create_contact (scrittura)
Crea un contatto CRM.
update_contact (scrittura)
Aggiorna le proprietà di un contatto.
create_deal (scrittura)
Crea un deal CRM.
update_deal (scrittura)
Aggiorna un deal (fase, importo).
create_ticket (scrittura)
Crea un ticket di supporto.
create_task (scrittura)
Crea un'attività CRM (sollecito, chiamata).
create_note (scrittura)
Registra una nota, da associare a un record.
create_association (scrittura)
Associa due record CRM tra loro.
Prerequisiti
- Account HubSpot con diritti super admin per creare una private app.
- Creare una private app in Settings, poi Integrations, poi Private Apps.
- Selezionare gli scope necessari (contacts, companies, deals, tickets, owners in lettura/scrittura).
- Copiare il token di accesso mostrato dopo la creazione (prefisso pat-).
- In Atako, un diritto di amministrazione delle integrazioni per concedere il grant all'agente.
Come connettersi
- 1
Creare la private app HubSpot
In Settings, poi Integrations, poi Private Apps, creare un'app, darle un nome, poi scegliere i suoi scope nella scheda dedicata.
- 2
Generare e copiare il token
Una volta creata l'app, visualizzare e poi copiare il token di accesso (pat-...), mostrato una sola volta.
- 3
Connettere HubSpot in Atako
In Impostazioni, poi Integrazioni, incollare il token di accesso.
- 4
Concedere il grant all'agente
Dalla pagina dell'agente o dalla connessione, selezionare le azioni precise autorizzate e il loro ambito (sola lettura o lettura e scrittura).
Perché collegare un agente autonomo a HubSpot
HubSpot centralizza i contatti, i deal e i ticket di un team commerciale o supporto. Il lavoro ripetitivo che ne consegue, arricchire una scheda, sollecitare un deal fermo, creare un'attività di follow-up, si fa generalmente in tempo reale, quando qualcuno ci pensa. Un agente Atako connesso a HubSpot tramite tool calling svolge questo lavoro in continuo, nel proprio ambiente, senza aspettare che un commerciale apra la sua lista di attività del mattino.
La differenza rispetto a uno scenario di automazione classico: l'agente gira in permanenza e prende una decisione, non solo un'azione isolata. Può ricevere un segnale via email o Slack, cercare il contatto o il deal interessato in HubSpot, decidere se creare un'attività o aggiornare una proprietà, poi farlo, entro il perimetro esatto delle azioni che gli sono state concesse.
Il connettore HubSpot copre 37 azioni secondo la documentazione Atako (17 di lettura, 20 di scrittura), dalla ricerca di contatti alla creazione di proprietà personalizzate. Il caso d'uso più diretto: un agente di automazione del RevOps che monitora la pipeline, arricchisce i lead e segnala le anomalie di dati senza intervento manuale costante.
Limiti e buone pratiche
L'API HubSpot impone limiti di frequenza che variano in base all'abbonamento HubSpot dell'azienda (numero di richieste per intervallo di dieci secondi, e al giorno), con soglie ancora più rigide sugli endpoint di ricerca. Un agente che elabora un grande volume di contatti deve quindi distribuire le proprie chiamate invece di farle tutte insieme.
Alcune azioni di scrittura, come delete_contact o delete_deal, sono irreversibili lato HubSpot una volta eseguite. Sono utilizzabili solo se il grant dell'agente le autorizza esplicitamente, il che resta raro in pratica per questo tipo di azione.
Come per ogni integrazione Atako, la sola connessione non dà alcun accesso: serve un grant preciso (agente, azione, ambito). Vedere il modello di permessi e i piani per definire questo perimetro prima di collegare l'agente al vostro CRM.
Casi d'uso correlati
Integrazioni correlate
Domande frequenti
L'agente può inviare email marketing da HubSpot?
Può creare una bozza di email marketing (create_marketing_email) se questo scope è concesso, ma nulla parte senza un'azione di invio convalidata dal vostro team: il connettore non prevede alcuna azione di invio diretto di email marketing.
Serve un piano HubSpot a pagamento per connettere l'API?
L'API e le private app sono disponibili già dal piano gratuito di HubSpot per gli oggetti standard. Alcuni scope avanzati, come la creazione di proprietà personalizzate, possono dipendere dal livello tariffario sottoscritto.
Come revocare l'accesso dell'agente a HubSpot?
Eliminate o disattivate la private app lato HubSpot, oppure revocate la connessione lato Atako. L'accesso viene tagliato immediatamente e definitivamente per tutti gli agenti che lo utilizzavano.
L'agente può eliminare contatti dal CRM?
Sì, l'azione delete_contact esiste, ma solo se il grant dell'agente la autorizza esplicitamente con ambito scrittura. Per impostazione predefinita, nessuna azione è concessa: siete voi a decidere se l'eliminazione fa parte del perimetro dell'agente.
Cosa leggere dopo
Fonti
- HubSpot Developer Docs, Private apps · consultato il 4 settembre 2026
- HubSpot Developer Docs, API usage guidelines and limits · consultato il 4 settembre 2026
CTO di Atako
Questo contenuto è stato redatto dagli agenti IA di Atako, poi rivisto, corretto e approvato da Romain Laodicina, CTO di Atako.