Vai alla navigazione

Attio

Riconosci chi chiama, aggiungi nuove persone e registra le note delle chiamate in Attio durante le chiamate.

La tua receptionist può riconoscere i chiamanti già presenti in Attio, aggiungere i nuovi chiamanti come persone con nome e numero di telefono e lasciare una nota su ciò che desideravano, così il tuo team può ricontattarli. Ci sono due modi per connettersi:

  • Gli strumenti webhook chiamano direttamente l’API di Attio, senza account Zapier né utilizzo di task Zapier.
  • Le azioni di Zapier accedono ad Attio per tuo conto, ma ogni azione utilizza task del tuo piano Zapier.

Usa gli strumenti webhook, a meno che tu non riesca a ottenere da un amministratore di Attio la creazione di un token di accesso.

Opzione 1: Strumenti webhook (consigliato)

1

Crea un token di accesso

Devi essere un amministratore di Attio. Seleziona il menu a discesa accanto al nome del tuo workspace, apri Impostazioni del workspace, vai alla scheda Sviluppatori e seleziona Nuovo token di accesso. Assegnagli un nome, ad esempio Reception.ai, e concedigli solo gli scope necessari a questi strumenti: lettura della configurazione degli oggetti (object_configuration:read), lettura-scrittura dei record (record_permission:read-write) e lettura-scrittura delle note (note:read-write). Le etichette in Attio potrebbero essere leggermente diverse da questi nomi.

Il token non scade e può visualizzare tutte le persone nel tuo workspace. Eliminalo in Attio se viene compromesso.

2

Crea gli strumenti webhook

Per ogni strumento qui sotto, vai a Integrazioni, seleziona Aggiungi integrazione e scegli Strumento webhook. Ogni strumento invia lo stesso header: Authorization (Segreto), impostato su Bearer seguito dal tuo token.

3

Aggiungi una regola

Aggiungi una regola che indichi alla tua receptionist di usare Attio solo per riconoscere i chiamanti e di non leggere mai record o note ad alta voce.

Trova il chiamante

CampoValore
Nomefind_attio_person
Descrizione”Trova il chiamante tra le nostre persone in Attio usando il numero di telefono. Usalo all’inizio di una chiamata. Passa il record_id della persona allo strumento per le note.”
MetodoPOST
URLhttps://api.attio.com/v2/objects/people/records/query
Header della richiestaAuthorization (Segreto): Bearer seguito dal tuo token
Parametri del bodyfilter (oggetto, obbligatorio), con il campo seguente
limit (intero, valore fisso): 5
Assegna agli agentiReceptionist

Seleziona Aggiungi campo in filter e aggiungi:

  • phone_numbers (stringa, obbligatorio, dalla conversazione): “Il numero di telefono del chiamante in formato internazionale, ad esempio +14155550123.”

Attio restituisce solo le persone il cui numero salvato corrisponde esattamente, quindi salva i numeri con il prefisso internazionale.

Aggiungi il chiamante

CampoValore
Nomecreate_attio_person
Descrizione”Aggiungi il chiamante come persona solo quando find_attio_person non lo ha trovato. Passa il record_id della nuova persona allo strumento per le note.”
MetodoPOST
URLhttps://api.attio.com/v2/objects/people/records
Header della richiestaAuthorization (Segreto): Bearer seguito dal tuo token
Parametri del bodydata (oggetto, obbligatorio), con i campi seguenti
Assegna agli agentiReceptionist

Seleziona Aggiungi campo in data e aggiungi values (oggetto, obbligatorio). In values, aggiungi:

  • name (oggetto, obbligatorio), con tre campi:
    • first_name (stringa, obbligatorio, dalla conversazione): “Il nome del chiamante.”
    • last_name (stringa, obbligatorio, dalla conversazione): “Il cognome del chiamante oppure una stringa vuota se non lo ha fornito.”
    • full_name (stringa, obbligatorio, dalla conversazione): “Il nome e il cognome del chiamante.”
  • phone_numbers (array, obbligatorio, dalla conversazione): “Esattamente un elemento, per il numero di telefono del chiamante.” In Ogni elemento, scegli string, con descrizione “Il numero di telefono del chiamante in formato internazionale, ad esempio +14155550123.”
  • email_addresses (array, dalla conversazione): “Esattamente un elemento, per l’indirizzo email del chiamante. Omettilo se non ne ha fornito uno.” In Ogni elemento, scegli string, con descrizione “L’indirizzo email del chiamante.”

Registra una nota

CampoValore
Nomeadd_attio_note
Descrizione”Annota ciò che desiderava il chiamante nel suo record persona, prima che la chiamata termini.”
MetodoPOST
URLhttps://api.attio.com/v2/notes
Header della richiestaAuthorization (Segreto): Bearer seguito dal tuo token
Parametri del bodydata (oggetto, obbligatorio), con i campi seguenti
Assegna agli agentiReceptionist

Seleziona Aggiungi campo in data per ciascuno dei seguenti:

  • parent_object (stringa, valore fisso): people
  • parent_record_id (stringa, obbligatorio, dalla conversazione): “Il record_id della persona da find_attio_person o create_attio_person.”
  • title (stringa, obbligatorio, dalla conversazione): “Un titolo breve, ad esempio: Chiamata da Jane Doe per un preventivo.”
  • format (stringa, valore fisso): plaintext
  • content (stringa, obbligatorio, dalla conversazione): “Ciò che desiderava il chiamante, in poche frasi.”

L’oggetto principale e il formato sono valori fissi, quindi le note vengono sempre aggiunte a una persona, anche se l’IA invia altri valori.

find_attio_person restituisce tutto ciò che è salvato nella persona. Mantieni la regola attiva affinché la tua receptionist usi Attio solo per riconoscere il chiamante e i chiamanti non sentano mai i dettagli di un’altra persona.

Seleziona Abilita su ogni strumento, quindi testa la tua receptionist con una chiamata da un numero salvato per una persona in Attio, poi come nuovo chiamante che richiede di essere ricontattato. La nuova persona e una nota vengono visualizzate in Attio.

Opzione 2: Zapier

1

Connetti Zapier

Se non l’hai ancora fatto, connetti Zapier in Reception.ai.

2

Aggiungi le azioni Attio

Nel tuo server MCP Zapier su mcp.zapier.com, aggiungi le azioni qui sotto dall’app Attio e connetti il tuo workspace Attio. Per ogni campo, imposta un valore fisso oppure lascia che l’IA lo compili, come indicato.

3

Assegna gli strumenti

In Reception.ai, apri la scheda Strumenti dell’integrazione Zapier, seleziona Aggiorna strumenti e assegna ogni azione come indicato.

4

Aggiungi una regola

Aggiungi una regola che indichi alla tua receptionist di usare Attio solo per riconoscere i chiamanti e di non leggere mai record o note ad alta voce.

Zapier agisce come l’utente Attio che ha connesso il workspace e può vedere tutto ciò che quell’utente può vedere. Connettilo con un membro il cui accesso sia limitato ai record necessari alla tua receptionist e mantieni la regola attiva affinché i chiamanti non sentano mai i dettagli di un’altra persona.

5

Testalo

Testa la tua receptionist con una chiamata da un numero salvato per una persona in Attio, poi come nuovo chiamante che richiede di essere ricontattato. La nuova persona e una nota vengono visualizzate in Attio.

Azioni Zapier

Trova il chiamante

CampoValore
Azione ZapierTrova record
Imposta in ZapierL’oggetto: Persone. L’attributo in base a cui cercare: numero di telefono.
Lascia compilare all’IAIl valore da cercare: il numero di telefono del chiamante.
Assegna aCliente

Aggiungi il chiamante

CampoValore
Azione ZapierCrea record
Imposta in ZapierL’oggetto: Persone. Eventuali attributi che devono essere sempre uguali, se li usi.
Lascia compilare all’IANome, cognome, numero di telefono e indirizzo email.
Assegna aCliente

Registra una nota

CampoValore
Azione ZapierCrea nota
Imposta in ZapierL’oggetto principale: Persone.
Lascia compilare all’IAL’ID del record principale (dalle azioni precedenti), un titolo e il testo della nota con ciò che serve al chiamante.
Assegna aCliente

Qualunque opzione tu usi, aggiungi una procedura affinché la tua receptionist cerchi prima il chiamante, crei una persona solo quando non trova corrispondenze e poi registri una nota.

Limitazioni

  • Attio verifica che i numeri di telefono siano validi. Indica alla tua receptionist, nella descrizione dello strumento o dell’azione, di inviare i numeri in formato internazionale, ad esempio +14155550123.
  • La creazione di una persona non riesce quando un’altra persona ha già lo stesso valore univoco, come un indirizzo email. La tua receptionist deve cercare prima.
  • I task creati tramite Zapier non possono essere collegati a un record Attio, quindi usa la nota per i dettagli della chiamata.
  • Con Zapier, ogni azione eseguita dalla tua receptionist utilizza task del tuo piano Zapier. Zapier attualmente conta due task per ogni chiamata riuscita; le chiamate non riuscite non vengono conteggiate. Quando il piano si esaurisce, le azioni si interrompono finché non viene reimpostato.

Risoluzione dei problemi

ProblemaCosa controllare
401 o 403 da AttioInizia il valore dell’header con Bearer e uno spazio, quindi verifica che il token abbia gli scope indicati sopra e non sia stato eliminato.
Un’azione Attio non viene visualizzata in Reception.aiSeleziona Aggiorna strumenti nell’integrazione Zapier dopo aver aggiunto le azioni in Zapier.
Un’azione mostra Modificata e non viene usataL’hai modificata in Zapier. Seleziona Aggiorna nella scheda Strumenti.
I chiamanti conosciuti non vengono trovatiVerifica che i numeri siano salvati con il prefisso internazionale. Con Zapier, verifica che Trova record cerchi nell’oggetto Persone in base al numero di telefono.
La creazione di una persona non riesceIl numero di telefono potrebbe non essere in formato internazionale oppure l’indirizzo email del chiamante è già salvato.
Le note non sono collegate al chiamanteLa tua receptionist ha bisogno dell’ID del record dallo strumento di ricerca o creazione oppure da Trova record o Crea record in Zapier.