Chatbot AI per HubSpot: legge il CRM, qualifica i lead, apre ticket
Con l’integrazione HubSpot di Orygo AI, l’agente AI del tuo ecommerce legge il contatto dal CRM mentre risponde in chat, per email, su WhatsApp, Instagram, Messenger o Amazon: lifecycle stage, consensi, totale speso, ultimi ordini ricostruiti dalle trattative, ticket aperti, NPS e le tue proprietà personalizzate. Può creare o aggiornare il contatto, scrivendo il lifecycle stage quando qualifica un lead, e aprire un ticket HubSpot con le immagini che il cliente ha mandato in chat. Si collega con un token di accesso, ogni azione si accende da sola e il contatto si cerca sempre per email.
3
azioni su HubSpot: leggi contatto, crea o aggiorna contatto, apri ticket
14
gruppi di dati letti dal contatto, dai consensi all’NPS
7
valori di lifecycle stage che l’agente può scrivere
4
oggetti associati caricabili: trattative, ticket, line item, note
Di Davide Petruzzi, founder di Orygo AI · Aggiornato il
Cosa fa l’agente AI di Orygo dentro HubSpot?
L’agente AI di Orygo usa HubSpot in tre modi: legge il contatto per rispondere con il contesto giusto, crea o aggiorna il contatto quando la conversazione porta dati nuovi, e apre un ticket quando serve una persona del tuo team. Le tre azioni sono separate: puoi accendere solo la lettura e lasciare HubSpot intatto, oppure dare all’agente anche la scrittura.
| Azione | Tipo | Cosa fa | Come trova il contatto |
|---|---|---|---|
| Leggi contatto | Lettura | Carica profilo, consensi, acquisti, engagement, NPS, proprietà personalizzate, ordini dalle trattative, ticket e line item | |
| Crea o aggiorna contatto | Scrittura | Crea il contatto se l’email è nuova, lo aggiorna se esiste già. Scrive nome, cognome, telefono, azienda, ruolo, lifecycle stage e le proprietà HubSpot che indichi | |
| Crea ticket | Scrittura | Apre un ticket con oggetto, messaggio e priorità, lo associa al contatto e allega le immagini mandate in chat | Email, facoltativa |
Le azioni funzionano in ogni conversazione dell’agente: widget del sito, email, WhatsApp, Instagram, Messenger, Amazon e i ticket di Zendesk o Freshdesk. Le credenziali appartengono al singolo agente: se hai due agenti, per esempio uno per il negozio italiano e uno per quello estero, ognuno ha il suo collegamento. Il funzionamento di tutte le azioni, dallo store al CRM, è nella pagina azioni e strumenti AI.
Quali dati di HubSpot legge l’agente AI?
Quando il cliente dà la sua email, Orygo AI legge da HubSpot 14 gruppi di dati: identità, recapiti, indirizzo, dati anagrafici, ciclo di vita, consensi, acquisti, engagement, NPS, date, proprietà personalizzate, e dagli oggetti associati gli ordini ricostruiti dalle trattative, i ticket recenti e i line item. L’agente li usa per rispondere; la lettura non modifica il contatto.
| Gruppo | Campi |
|---|---|
| Identità | ID HubSpot, email ed email aggiuntive, nome completo, nome, cognome |
| Recapiti e lingua | Telefono, cellulare, numero WhatsApp, lingua preferita, fuso orario |
| Indirizzo | Via, città, provincia o stato, CAP, paese, codice paese. Se i campi postali sono vuoti, città e paese arrivano dai valori ricavati dall’IP |
| Dati anagrafici | Data di nascita, genere |
| Ciclo di vita | Lifecycle stage, lead status, ID del proprietario del contatto |
| Consensi | Disiscritto dalle email, indirizzo non valido, in quarantena, contatto marketing, motivo dell’hard bounce |
| Acquisti | Fatturato totale, numero di ordini, importo e data dell’ultimo ordine, data del primo ordine |
| Engagement | Ultimo contatto, ultima apertura e ultimo clic su un’email, numero di visite, ultima pagina vista, sorgente di traffico e dettaglio |
| NPS | Ultimo voto, ultimo commento, data dell’ultimo follow-up |
| Date | Creazione e ultimo aggiornamento del contatto |
| Proprietà personalizzate | Tutte quelle che hanno un valore, più quelle che indichi tu |
| Ordini recenti | Ricostruiti dalle trattative: nome, fase con etichetta leggibile, pipeline, importo, valuta, data di chiusura, creazione e aggiornamento, dal più recente |
| Ticket recenti | Oggetto, fase della pipeline, priorità, categoria, creazione e aggiornamento |
| Line item | Nome, SKU, quantità, prezzo, importo |
Ordini ricostruiti dalle trattative
Molti brand registrano gli acquisti in HubSpot come trattative (deal), soprattutto per ordini B2B, preventivi e vendite assistite. Orygo AI legge le trattative associate al contatto e le presenta all’agente come ordini: nome, importo, valuta, pipeline e fase con l’etichetta che vedi tu in HubSpot, non il codice interno. Così l’agente può rispondere “il tuo ordine del 3 ottobre è nella fase In produzione” senza che l’operatore apra il CRM. Dall’ID del portale si costruisce il link diretto al record HubSpot, utile al team nell’inbox. Gli ordini dello shop online, con stato e tracking, l’agente li legge invece dallo store collegato con numero d’ordine ed email: il dettaglio è nella pagina sul tracking ordini con l’AI.
Proprietà personalizzate e oggetti associati
Nel collegamento indichi le proprietà extra da leggere sempre, con il loro nome interno separato da virgole (per esempio loyalty_tier,customer_segment). Le proprietà personalizzate del portale che hanno un valore vengono scoperte da sole, tenute in memoria per circa un’ora e incluse nella lettura fino al limite di proprietà per richiesta di HubSpot. Gli oggetti associati da caricare sono trattative, ticket e line item di default; le note si aggiungono se servono.
Come qualifica i lead dalla chat e aggiorna il lifecycle stage?
Orygo AI qualifica un lead seguendo la procedura che scrivi tu: quando la conversazione soddisfa i tuoi criteri, l’agente crea o aggiorna il contatto HubSpot e imposta il lifecycle stage. Il contatto si trova per email: un’email nuova crea il contatto, un’email esistente lo aggiorna, e la risposta di HubSpot dice all’agente se il contatto è stato creato, aggiornato o lasciato com’era.
| Valore | Quando usarlo, per esempio |
|---|---|
| subscriber | Il visitatore lascia l’email per ricevere novità |
| lead | Chiede informazioni su un prodotto e lascia i suoi dati |
| marketing qualified lead | Risponde alle domande di qualifica che hai previsto |
| sales qualified lead | Un’azienda chiede un listino rivenditori o una fornitura |
| opportunity | Chiede un preventivo con quantità e tempi |
| customer | Ha già acquistato |
| evangelist | Cliente che consiglia il brand, per esempio dopo un NPS alto |
Oltre ai campi standard (nome, cognome, telefono, azienda, ruolo, lifecycle stage) l’agente scrive ogni campo extra il cui nome corrisponde a una proprietà reale del tuo portale, come una proprietà “interesse” o “canale di provenienza”. Se il contatto esiste e non c’è nulla di nuovo da scrivere, HubSpot resta com’è. Qui sotto una procedura di qualifica scritta come un’istruzione a un collega: criteri, nomi delle azioni e valori sono di esempio e vanno adattati al tuo processo commerciale.
Richiesta rivenditore
- 1Quando un’azienda chiede prezzi all’ingrosso o di diventare rivenditore, chiedi ragione sociale, nome, ruolo, email e telefono.
- 2Chiedi in quale città ha il punto vendita e quanti pezzi ordina in media al mese.
- 3Salva il contatto con @Aggiorna contatto HubSpot: azienda, ruolo, telefono e lifecycle stage “sales qualified lead”.
- 4Se ordina più di 50 pezzi al mese, apri un ticket con @Crea ticket HubSpot, priorità alta, oggetto “Nuovo rivenditore” e un riassunto della richiesta.
- 5Di’ al cliente che un commerciale lo contatterà entro un giorno lavorativo.
Come si scrivono e si correggono le procedure, senza flussi a blocchi: procedure in linguaggio naturale. Le richieste di rivenditori arrivano spesso su WhatsApp: lì l’agente chiede l’email prima di salvare, perché è il dato con cui HubSpot riconosce il contatto.
Come apre un ticket HubSpot da chat, email e WhatsApp?
Orygo AI apre un ticket HubSpot con oggetto, messaggio e priorità bassa, media o alta, da qualsiasi canale su cui sta rispondendo. Se l’email del cliente corrisponde a un contatto, il ticket viene associato a quel contatto; le immagini che il cliente ha mandato in chat, come la foto di un prodotto danneggiato, vengono caricate e allegate al ticket.
[01]
Il cliente descrive il problemaIn chat, per email, su WhatsApp, Instagram, Messenger o Amazon, e se serve manda una foto.[02]
L’agente raccoglie i datiChe la tua procedura richiede: email, numero d’ordine, descrizione, eventuali foto.[03]
Apre il ticket su HubSpotCon oggetto e messaggio scritti dall’agente e la priorità che hai previsto (media se non indicata).[04]
Associa e allegaIl ticket finisce sul contatto con quella email, con le immagini della chat già caricate.[05]
Il team lavora il caso in HubSpotDove gestisce già le richieste, senza copiare nulla dalla chat.
Il ticket HubSpot è uno dei modi in cui Orygo AI passa una conversazione al team, insieme al trasferimento live, al ticket email, a Slack e all’email: le regole su quando passare e a chi sono nella pagina sul passaggio dal chatbot all’operatore. Nelle analytics il ticket HubSpot aperto dall’agente conta come escalation riuscita, quindi lo vedi tra le risoluzioni dell’agente AI insieme alle conversazioni chiuse senza operatore.
Come usa NPS, storico ordini e consensi per rispondere meglio?
L’agente AI di Orygo legge il contatto HubSpot prima di rispondere e usa i dati secondo le regole che hai scritto nelle procedure: tono più attento con chi ha dato un NPS basso, attenzione diversa per chi ha già speso molto, nessuna proposta di newsletter a chi si è disiscritto. I dati restano in HubSpot; l’agente li legge a ogni conversazione, quindi sono sempre quelli aggiornati.
| Dato letto | Regola di esempio nella procedura |
|---|---|
| Ultimo voto e commento NPS | Se il voto è basso e il cliente scrive per un problema, scusati per l’esperienza precedente e passa il caso al team con priorità alta |
| Numero di ordini e fatturato totale | Se il cliente ha più di 5 ordini, offri il cambio taglia gratuito previsto dalla policy fedeltà |
| Proprietà personalizzata loyalty_tier | Per i clienti gold, proponi la consegna prioritaria |
| Consensi email | Non proporre l’iscrizione alla newsletter a chi risulta disiscritto o ha un indirizzo non valido |
| Ticket recenti | Se c’è già un ticket aperto sullo stesso tema, di’ al cliente che il team ci sta lavorando invece di aprirne un altro |
| Lingua preferita | Rispondi nella lingua del contatto quando il cliente scrive in modo ambiguo |
Per i clienti che tornano, l’agente ha anche lo storico delle conversazioni con Orygo AI su ogni canale: come si unisce al dato del CRM è spiegato nella pagina sui profili clienti unificati.
Cosa vede il team nell’inbox di Orygo AI?
Nell’helpdesk di Orygo AI la scheda HubSpot del cliente può stare accanto alla conversazione: l’operatore che riprende un caso dall’agente vede lifecycle stage, ordini dalle trattative, ticket aperti e NPS senza aprire un’altra scheda del browser. Sei tu a scegliere quali fonti compaiono nel pannello: store, HubSpot, altri CRM.
Scheda HubSpot accanto alla chat
Il pannello del profilo cliente mostra i dati letti da HubSpot insieme a quelli dello store e alle conversazioni passate. Dettagli nella pagina dell’helpdesk di Orygo AI.
Passaggio con il contesto
Quando l’agente passa il caso, l’operatore riceve oggetto, nota interna con problema e tentativi già fatti, conversazione completa e profilo del cliente.
Lavoro misurato
Le conversazioni chiuse dall’agente e quelle passate con un ticket HubSpot finiscono nelle analytics di Orygo AI, divise per procedura.
Come si collega HubSpot a Orygo AI?
HubSpot si collega a Orygo AI con un token di accesso del tuo account HubSpot, incollato nelle impostazioni dell’integrazione dell’agente. Poi scegli le proprietà extra e gli oggetti associati da leggere, accendi le azioni che vuoi usare e provi tutto nel playground prima di andare online.
[01]
Prepara il token in HubSpotSe hai già un’app privata, creata da un super admin, il token si trova in Development › Legacy apps › nome dell’app › scheda Auth. Dal 26 ottobre 2026 HubSpot non permette più di creare nuove app private legacy e indica come sostituto le service key (Development › Keys › Service keys), che crea un utente con accesso agli strumenti per sviluppatori: il team Orygo AI ti indica quale credenziale usare e quali permessi selezionare.[02]
Incolla il token in Orygo AINell’integrazione HubSpot dell’agente.[03]
Scegli cosa leggereLe proprietà extra con il loro nome interno e gli oggetti associati (trattative, ticket, line item, note).[04]
Accendi le azioni una per unaSolo lettura, oppure anche crea o aggiorna contatto e crea ticket.[05]
Scrivi o adatta le procedureChe usano HubSpot, come la qualifica dei rivenditori o l’apertura dei ticket per i resi.[06]
Prova nel playgroundCon un contatto di test, poi vai online.
Lo configura con te un AI engineer dedicato, insieme allo store e ai canali: i tempi e i passaggi sono nella pagina come si va live. Come vengono protetti token e dati dei clienti: sicurezza di Orygo AI.
Quando conviene collegare un agente AI esterno a HubSpot?
Collegare Orygo AI a HubSpot conviene quando HubSpot è il tuo CRM ma le risposte ai clienti dipendono anche dallo store: catalogo, ordini, tracking e resi. Orygo AI legge gli ordini da Shopify, WooCommerce, PrestaShop, Magento, BigCommerce o Salesforce Commerce Cloud, risponde su sei canali compreso Amazon e usa HubSpot per il contesto del cliente, la qualifica e i ticket.
| Lavoro | Dove avviene |
|---|---|
| Anagrafica, lifecycle stage, trattative, ticket, marketing | HubSpot, che resta la fonte del dato |
| Domande su prodotti, disponibilità, ordini e spedizioni | Orygo AI, che legge store e piattaforme di spedizione |
| Risposte su sito, email, WhatsApp, Instagram, Messenger e Amazon | Orygo AI, con lo stesso agente su ogni canale |
| Qualifica dei lead e ticket per il team | Orygo AI scrive su HubSpot, con le azioni che hai acceso |
| Vendite generate dalla chat | Orygo AI, con le vendite attribuite lette dallo store |
Se invece usi l’helpdesk di Zendesk o Freshdesk per l’assistenza, l’agente risponde lì sui ticket e usa HubSpot solo come CRM: le pagine integrazione Zendesk e integrazione Freshdesk spiegano come. Per il marketing via email e SMS l’integrazione dedicata è Klaviyo; per un CRM pensato per team commerciali snelli c’è Attio. Tutte le integrazioni sono nella pagina integrazioni di Orygo AI.
Domande frequenti sull’integrazione HubSpot
Orygo AI può cercare un contatto HubSpot con il numero di telefono?
No. Orygo AI cerca, crea e aggiorna i contatti HubSpot per email. Su WhatsApp, dove il cliente arriva con il numero di telefono, l’agente chiede l’email prima di leggere o salvare il contatto. Il numero WhatsApp, il telefono e il cellulare del contatto vengono comunque letti e possono essere aggiornati.
Orygo AI salva in HubSpot tutte le conversazioni?
No. Orygo AI scrive su HubSpot solo con le azioni che hai acceso: crea o aggiorna il contatto e apre ticket con oggetto, messaggio e immagini. Le conversazioni complete restano nell’helpdesk di Orygo AI, accanto al profilo del cliente.
L’agente può scrivere le mie proprietà personalizzate di HubSpot?
Sì. Oltre a nome, cognome, telefono, azienda, ruolo e lifecycle stage, l’agente scrive ogni campo il cui nome corrisponde a una proprietà reale del tuo portale. In lettura carica tutte le proprietà personalizzate che hanno un valore e quelle che indichi nel collegamento.
Le foto che il cliente manda in chat arrivano nel ticket HubSpot?
Sì. Quando l’agente apre un ticket HubSpot, le immagini che il cliente ha mandato nella conversazione vengono caricate e allegate al ticket, e il ticket viene associato al contatto se l’email corrisponde.
Posso usare HubSpot in sola lettura?
Sì. Ogni azione si accende da sola: puoi attivare solo la lettura del contatto e lasciare spente la creazione dei contatti e dei ticket. L’agente userà i dati di HubSpot per rispondere senza modificare nulla nel CRM.
Quale token serve ora che HubSpot non crea più nuove app private?
Se hai già un’app privata, usi il suo token di accesso. Dal 26 ottobre 2026 HubSpot non permette più di creare nuove app private legacy e indica come sostituto le service key: durante il setup il team Orygo AI ti dice quale credenziale creare e con quali permessi.
Collega Orygo AI ad Attio: l’agente trova la persona per email o telefono, legge le trattative e la aggiorna senza sovrascrivere i dati, con una nota della chat
Scopri attioCollega Orygo AI a Klaviyo: l’agente legge CLV e consensi, iscrive alle liste e trasforma chat e WhatsApp in eventi che avviano i tuoi flow.
Scopri klaviyoVuoi un agente AI che conosce i tuoi contatti HubSpot?
Prenota una demo: ti mostriamo l’agente di Orygo AI mentre legge un contatto dal tuo HubSpot, qualifica un lead scrivendo il lifecycle stage e apre un ticket con le foto mandate dal cliente, e insieme scriviamo le procedure per il tuo team.