Integrazione Attio: l’agente AI che legge e aggiorna il tuo CRM
Con l’integrazione Attio di Orygo AI, l’agente AI che risponde ai tuoi clienti in chat, per email e su WhatsApp trova la persona in Attio per email o per numero di telefono, legge profilo, azienda collegata e trattative, e le usa per rispondere. Quando la conversazione porta dati nuovi crea o aggiorna la persona senza sovrascrivere email, telefoni e nomi già salvati, e nella stessa operazione lascia una nota con il riassunto della conversazione. Si collega con una chiave API del workspace con tre permessi, e ogni azione si accende da sola.
2
azioni su Attio: leggi persona, crea o aggiorna persona con nota
16
campi della persona letti dall’agente, più le trattative
2
modi di trovare la persona: email o telefono con prefisso
3
permessi della chiave API: record, configurazione degli oggetti, note
Di Davide Petruzzi, founder di Orygo AI · Aggiornato il
Per quali ecommerce ha senso collegare Attio a un agente AI?
Attio è un CRM scelto soprattutto da startup e team commerciali B2B, e per un ecommerce ha senso quando una parte delle vendite passa da relazioni seguite a mano: rivenditori e ingrosso, ordini aziendali, prodotti su misura o di valore alto. In questi casi Orygo AI porta in Attio le persone e il contesto che arrivano da chat, email e WhatsApp, e risponde ai clienti sapendo chi sono.
Brand con canale wholesale
Il sito vende ai privati, il team commerciale segue negozi e distributori in Attio. L’agente riconosce un rivenditore già in pipeline e registra in Attio chi chiede per la prima volta un listino.
DTC con vendita assistita
Arredo, gioielli, bici, prodotti configurati: il cliente parla con una persona prima di comprare. L’agente raccoglie le richieste, crea la persona e lascia una nota che il consulente legge prima di richiamare.
Team piccoli che usano Attio per tutto
Startup e brand giovani che tengono in Attio clienti, partner e trattative. L’agente diventa un punto di ingresso in più verso lo stesso CRM.
Se i dati dei tuoi clienti stanno invece nello store e nel tuo strumento di email marketing, l’agente li legge da lì: ordini e profili da Shopify o dalle altre piattaforme ecommerce, consensi e valore del cliente da Klaviyo. Per chi usa HubSpot c’è l’integrazione HubSpot, con lettura delle trattative, lifecycle stage e ticket.
Cosa fa l’agente AI di Orygo dentro Attio?
L’agente AI di Orygo ha due azioni su Attio: legge una persona, con le trattative collegate, e crea o aggiorna una persona, con la possibilità di allegare una nota nella stessa chiamata. Le azioni si accendono separatamente: puoi dare all’agente solo la lettura, oppure anche la scrittura.
| Azione | Tipo | Cosa fa | Come trova la persona |
|---|---|---|---|
| Leggi persona | Lettura | Carica il profilo della persona e le trattative collegate, presentate all’agente come ordini | Email, telefono con prefisso internazionale, o entrambi: prima l’email |
| Crea o aggiorna persona | Scrittura | Crea la persona se non esiste, la aggiorna se esiste, senza perdere i dati già salvati. Può allegare o sostituire una nota | Prima l’email, poi il telefono |
Le azioni funzionano in ogni conversazione dell’agente: widget del sito, email, WhatsApp, Instagram, Messenger, Amazon e i ticket di Zendesk o Freshdesk. La ricerca per telefono rende Attio comodo soprattutto su WhatsApp, dove il cliente arriva con il suo numero. Il quadro di tutte le azioni dell’agente è nella pagina azioni e strumenti AI.
Quali dati di Attio legge l’agente AI?
Orygo AI legge da Attio 16 campi della persona, dall’email principale al profilo LinkedIn all’azienda collegata, e le trattative associate, che l’agente vede come ordini con nome, fase, valore e valuta. Se nel tuo workspace l’oggetto trattative è spento, l’agente riceve comunque la persona. La lettura non modifica nulla in Attio.
| Gruppo | Campi |
|---|---|
| Record | ID del record, link alla persona in Attio, data di creazione |
| Nome | Nome completo, nome, cognome |
| Recapiti | Email principale, tutte le email, telefono |
| Profilo professionale | Ruolo, descrizione, LinkedIn, ID dell’azienda collegata |
| Luogo | Città, regione, paese |
| Trattative, lette come ordini | Nome, fase, valore, valuta |
In pratica l’agente può rispondere a un rivenditore “la tua fornitura di primavera è nella fase Confermata” leggendo la trattativa, oppure salutare per nome un cliente che scrive da un nuovo numero ma con un’email già nota. Gli ordini dello shop online, con stato e tracking, l’agente li legge dallo store collegato con numero d’ordine ed email: il dettaglio è nella pagina sul tracking ordini con l’AI.
Come crea e aggiorna le persone senza sovrascrivere i dati?
Orygo AI cerca la persona in Attio prima per email e poi per telefono, e ne crea una nuova solo se nessuno dei due corrisponde. Su una persona esistente aggiunge senza togliere: le email e i telefoni già salvati restano, quelli nuovi si aggiungono, e un nome o un cognome mancante nella richiesta lascia il valore che c’era. Il risultato dice all’agente se la persona è stata creata, aggiornata o lasciata com’era.
| Dato | Comportamento |
|---|---|
| Le email già salvate restano; una email nuova si aggiunge | |
| Telefono | Normalizzato nel formato internazionale E.164 (per esempio +393331234567); i numeri già salvati restano, uno nuovo si aggiunge |
| Nome e cognome | Se l’agente non li manda, resta il valore attuale |
| Ruolo e descrizione | Scritti con il valore che l’agente ha raccolto |
| Altri attributi | I campi che corrispondono allo slug di un attributo Attio vengono scritti come testo |
| Attributi “solo se vuoti” | Con l’elenco fill_if_empty scegli gli attributi da scrivere solo quando la persona non ha ancora un valore, così l’agente non tocca quello che il tuo team ha già compilato |
Aggiorna in Attio, dall’helpdesk
La stessa logica è a disposizione del team. Con Attio collegato, nella scheda cliente dell’helpdesk di Orygo AI compare il pulsante Aggiorna in Attio: un clic crea la persona se non c’è, o la aggiorna se c’è già, senza sovrascrivere i dati esistenti. Nello stesso pannello l’operatore vede i dati letti da Attio accanto alla conversazione, insieme a quelli dello store e allo storico del cliente. Come si costruisce il profilo unico del cliente fra canali e CRM: profili clienti unificati.
Come lascia una nota della conversazione in Attio?
Quando crea o aggiorna una persona, Orygo AI può allegare una nota nella stessa operazione, con titolo e contenuto scritti dall’agente; se il titolo manca, la nota si chiama “Conversation”. Indicando l’ID di una nota esistente, l’agente la sostituisce invece di aggiungerne un’altra, così la stessa conversazione non riempie il record di note doppie.
Se la nota non va a buon fine, di solito perché la chiave API non ha il permesso note:read-write, l’aggiornamento della persona resta valido: il dato anagrafico non si perde per colpa della nota. Quando la nota viene pubblicata, l’agente riceve il suo ID insieme al profilo aggiornato. Qui sotto una procedura che usa la nota: criteri, nomi delle azioni e testi sono di esempio e vanno adattati al tuo processo.
Richiesta su misura
- 1Quando un cliente chiede un prodotto su misura o un preventivo, chiedi nome, email, telefono e cosa gli serve: misure, materiali, tempi.
- 2Cerca la persona con @Leggi persona Attio. Se ha già una trattativa aperta, digli in che fase è.
- 3Salva la persona con @Aggiorna persona Attio e allega una nota con titolo “Richiesta su misura” e un riassunto in tre righe: prodotto, misure, budget, tempi.
- 4Se nella conversazione il cliente aggiunge dettagli, aggiorna la stessa nota invece di crearne una nuova.
- 5Di’ al cliente che un consulente lo richiamerà entro due giorni lavorativi.
Come si scrivono le procedure, senza flussi a blocchi: procedure in linguaggio naturale. Quando la richiesta va passata subito a una persona, l’agente segue le regole del passaggio dal chatbot all’operatore.
Quali conversazioni diventano dati in Attio?
Con Orygo AI collegato ad Attio, le conversazioni che contano per il team commerciale diventano persone e note nel CRM, senza copia e incolla: richieste di rivenditori, preventivi, clienti che cambiano numero o email. Le domande di routine, come stato dell’ordine e disponibilità, l’agente le chiude da solo leggendo lo store.
| Conversazione | Cosa legge l’agente | Cosa scrive in Attio |
|---|---|---|
| Un negozio chiede su WhatsApp il listino per rivenditori | Cerca la persona per telefono: non c’è | Crea la persona con nome, ruolo e telefono, e una nota con città e volumi indicati |
| Un rivenditore chiede a che punto è la sua fornitura | Trova la persona per email e legge la trattativa: fase, valore, valuta | Nulla, se non ci sono dati nuovi |
| Un cliente scrive da un nuovo numero | Trova la persona per email | Aggiunge il nuovo telefono e tiene quello vecchio |
| Un cliente chiede un preventivo su misura | Cerca la persona e le trattative aperte | Aggiorna la persona e allega la nota con misure e tempi |
Come si collega Attio a Orygo AI?
Attio si collega a Orygo AI con una chiave API del workspace, creata da un amministratore di Attio con tre permessi: record_permission:read-write, object_configuration:read e note:read-write. La chiave si incolla nell’integrazione Attio dell’agente; poi accendi le azioni che ti servono e provi nel playground.
[01]
In Attio apri Workspace settingsDal menu accanto al nome del workspace, poi la scheda Developers.[02]
Crea un access tokenCon “+ New access token” e dagli un nome riconoscibile, per esempio “Orygo AI”.[03]
Imposta i permessiLettura e scrittura dei record, lettura della configurazione degli oggetti, lettura e scrittura delle note. Senza il permesso sulle note l’agente aggiorna le persone ma non lascia note.[04]
Incolla la chiave in Orygo AINell’integrazione Attio dell’agente.[05]
Accendi le azioni una per unaSolo lettura, oppure anche crea o aggiorna persona.[06]
Prova nel playgroundCon una persona di test, poi vai online.
Secondo la documentazione di Attio, le chiavi API sono disponibili su tutti i piani, non scadono e si possono modificare o cancellare in ogni momento dalla stessa pagina Developers. La chiave appartiene al singolo agente di Orygo AI. Lo configura con te un AI engineer dedicato: tempi e passaggi nella pagina come si va live; come vengono protetti chiavi e dati: sicurezza di Orygo AI. Tutte le integrazioni sono nella pagina integrazioni di Orygo AI.
Domande frequenti sull’integrazione Attio
Attio è un CRM adatto a un ecommerce?
Dipende da come vendi. Attio nasce per team commerciali e startup, quindi è adatto agli ecommerce che seguono a mano una parte dei clienti: rivenditori, ordini aziendali, prodotti su misura o di valore alto. Per i dati di chi compra solo online, l’agente di Orygo AI legge direttamente lo store e Klaviyo.
L’agente può sovrascrivere i dati che il mio team ha inserito in Attio?
Orygo AI aggiunge senza togliere: email e telefoni già salvati restano, un nome mancante non cancella quello attuale, e con l’elenco fill_if_empty gli attributi che scegli vengono scritti solo se sono ancora vuoti. Ruolo e descrizione vengono scritti con il valore raccolto in conversazione.
Orygo AI legge anche le aziende e le trattative di Attio?
Orygo AI legge l’ID dell’azienda collegata alla persona e le trattative associate, che l’agente vede come ordini con nome, fase, valore e valuta. Se l’oggetto trattative è spento nel tuo workspace, la persona viene restituita lo stesso.
Posso cercare un cliente in Attio solo con il numero di telefono?
Sì. Orygo AI trova la persona per email, per numero di telefono con prefisso internazionale, o con entrambi, e prova prima l’email. Quando salva un telefono lo porta nel formato internazionale E.164, come +393331234567.
Cosa succede se la chiave API non ha il permesso sulle note?
L’aggiornamento della persona va a buon fine lo stesso: solo la nota non viene pubblicata. Per avere anche le note, aggiungi il permesso note:read-write alla chiave dalla pagina Developers di Attio.
Il team può aggiornare Attio senza passare dall’agente?
Sì. Nell’helpdesk di Orygo AI, con Attio collegato, la scheda cliente ha il pulsante Aggiorna in Attio: crea la persona se non esiste e la aggiorna se esiste già, senza sovrascrivere i dati presenti in Attio.
Collega Orygo AI a HubSpot: l’agente legge contatti, ordini e NPS, aggiorna il lifecycle stage e apre ticket da chat, email e WhatsApp. Prenota una demo.
Scopri HubSpotCollega 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 che le conversazioni con i clienti arrivino in Attio da sole?
Prenota una demo: ti mostriamo l’agente di Orygo AI mentre trova una persona nel tuo Attio, legge le sue trattative e la aggiorna con una nota della conversazione, e insieme scriviamo le procedure per rivenditori e richieste su misura.