Orygo AI
Prenota una demo
CRM e marketing

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.

Prenota una demoCome si collega
  • 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 chi

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

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.

// Le azioni di Orygo AI su Attio
AzioneTipoCosa faCome trova la persona
Leggi personaLetturaCarica il profilo della persona e le trattative collegate, presentate all’agente come ordiniEmail, telefono con prefisso internazionale, o entrambi: prima l’email
Crea o aggiorna personaScritturaCrea la persona se non esiste, la aggiorna se esiste, senza perdere i dati già salvati. Può allegare o sostituire una notaPrima 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.

Dati

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.

// Cosa legge Orygo AI da una persona in Attio
GruppoCampi
RecordID del record, link alla persona in Attio, data di creazione
NomeNome completo, nome, cognome
RecapitiEmail principale, tutte le email, telefono
Profilo professionaleRuolo, descrizione, LinkedIn, ID dell’azienda collegata
LuogoCittà, regione, paese
Trattative, lette come ordiniNome, 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.

Aggiornamento

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.

// Cosa succede ai dati di una persona esistente quando l’agente la aggiorna
DatoComportamento
EmailLe email già salvate restano; una email nuova si aggiunge
TelefonoNormalizzato nel formato internazionale E.164 (per esempio +393331234567); i numeri già salvati restano, uno nuovo si aggiunge
Nome e cognomeSe l’agente non li manda, resta il valore attuale
Ruolo e descrizioneScritti con il valore che l’agente ha raccolto
Altri attributiI 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.

Note

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

Esempio
  1. 1
    Quando un cliente chiede un prodotto su misura o un preventivo, chiedi nome, email, telefono e cosa gli serve: misure, materiali, tempi.
  2. 2
    Cerca la persona con @Leggi persona Attio. Se ha già una trattativa aperta, digli in che fase è.
  3. 3
    Salva 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.
  4. 4
    Se nella conversazione il cliente aggiunge dettagli, aggiorna la stessa nota invece di crearne una nuova.
  5. 5
    Di’ 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.

Esempi

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.

// Esempi di conversazioni e cosa scrive l’agente in Attio (scenari illustrativi)
ConversazioneCosa legge l’agenteCosa scrive in Attio
Un negozio chiede su WhatsApp il listino per rivenditoriCerca 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 fornituraTrova la persona per email e legge la trattativa: fase, valore, valutaNulla, se non ci sono dati nuovi
Un cliente scrive da un nuovo numeroTrova la persona per emailAggiunge il nuovo telefono e tiene quello vecchio
Un cliente chiede un preventivo su misuraCerca la persona e le trattative aperteAggiorna la persona e allega la nota con misure e tempi
Collegamento

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.

  1. [01]

    In Attio apri Workspace settingsDal menu accanto al nome del workspace, poi la scheda Developers.
  2. [02]

    Crea un access tokenCon “+ New access token” e dagli un nome riconoscibile, per esempio “Orygo AI”.
  3. [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.
  4. [04]

    Incolla la chiave in Orygo AINell’integrazione Attio dell’agente.
  5. [05]

    Accendi le azioni una per unaSolo lettura, oppure anche crea o aggiorna persona.
  6. [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.

FAQ

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.

Altre integrazioniGli altri strumenti della stessa categoria
CRM e marketingHubSpot

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 HubSpot
CRM e marketingKlaviyo

Collega 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 klaviyo
Tutte le integrazioni →Tutte le funzionalità →Tutti i canali →
Demo

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