Passer à la navigation

Attio

Identifiez les appelants, ajoutez de nouvelles personnes et consignez les notes d'appel dans Attio pendant les appels.

Votre réceptionniste peut reconnaître les appelants déjà présents dans Attio, ajouter les nouveaux appelants en tant que personnes avec leur nom et leur numéro de téléphone, et laisser une note indiquant ce qu’ils souhaitaient afin que votre équipe puisse effectuer un suivi. Deux options permettent de vous connecter :

  • Les outils Webhook appellent directement l’API d’Attio, sans compte Zapier ni utilisation de tâches Zapier.
  • Les actions Zapier se connectent à Attio pour vous, mais chaque action utilise des tâches de votre forfait Zapier.

Utilisez les outils Webhook, sauf si vous ne pouvez pas demander à un administrateur Attio de créer un jeton d’accès.

Option 1 : Outils Webhook (recommandé)

1

Créer un jeton d’accès

Vous devez être administrateur Attio. Sélectionnez le menu déroulant à côté du nom de votre Workspace, ouvrez Workspace settings, accédez à l’onglet Developers, puis sélectionnez New access token. Nommez-le, par exemple Reception.ai, et accordez-lui uniquement les périmètres dont ces outils ont besoin : lecture de la configuration des objets (object_configuration:read), lecture et écriture des enregistrements (record_permission:read-write) et lecture et écriture des notes (note:read-write). Les libellés dans Attio peuvent légèrement différer de ces noms.

Le jeton n’expire pas et peut voir chaque personne de votre Workspace. Supprimez-le dans Attio s’il est compromis.

2

Créer les outils Webhook

Pour chaque outil ci-dessous, accédez à Integrations, sélectionnez Add integration, puis choisissez Webhook Tool. Chaque outil envoie le même en-tête : Authorization (Secret), défini sur Bearer suivi de votre jeton.

3

Ajouter une règle

Ajoutez une règle indiquant à votre réceptionniste d’utiliser Attio uniquement pour reconnaître les appelants et de ne jamais leur lire les enregistrements ou les notes.

Rechercher l’appelant

ChampValeur
Nomfind_attio_person
Description”Recherchez l’appelant parmi nos personnes dans Attio à l’aide de son numéro de téléphone. Utilisez cet outil au début d’un appel. Transmettez le record_id de la personne à l’outil de notes.”
MéthodePOST
URLhttps://api.attio.com/v2/objects/people/records/query
En-têtes de requêteAuthorization (Secret) : Bearer suivi de votre jeton
Paramètres du corpsfilter (objet, obligatoire), avec le champ ci-dessous
limit (entier, valeur fixe) : 5
Attribuer aux agentsRéceptionniste

Sélectionnez Add field sur filter et ajoutez :

  • phone_numbers (chaîne, obligatoire, issu de la conversation) : « Le numéro de téléphone de l’appelant au format international, par exemple +14155550123. »

Attio renvoie uniquement les personnes dont le numéro enregistré correspond exactement. Enregistrez donc les numéros avec leur indicatif pays.

Ajouter l’appelant

ChampValeur
Nomcreate_attio_person
Description”Ajoutez l’appelant en tant que personne, uniquement lorsque find_attio_person ne l’a pas trouvé. Transmettez le record_id de la nouvelle personne à l’outil de notes.”
MéthodePOST
URLhttps://api.attio.com/v2/objects/people/records
En-têtes de requêteAuthorization (Secret) : Bearer suivi de votre jeton
Paramètres du corpsdata (objet, obligatoire), avec les champs ci-dessous
Attribuer aux agentsRéceptionniste

Sélectionnez Add field sur data et ajoutez values (objet, obligatoire). Dans values, ajoutez :

  • name (objet, obligatoire), avec trois champs :
    • first_name (chaîne, obligatoire, issu de la conversation) : « Le prénom de l’appelant. »
    • last_name (chaîne, obligatoire, issu de la conversation) : « Le nom de famille de l’appelant, ou une chaîne vide s’il ne l’a pas donné. »
    • full_name (chaîne, obligatoire, issu de la conversation) : « Le prénom et le nom de famille de l’appelant. »
  • phone_numbers (tableau, obligatoire, issu de la conversation) : « Exactement un élément, correspondant au numéro de téléphone de l’appelant. » Sous Each item, choisissez string, décrit comme suit : « Le numéro de téléphone de l’appelant au format international, par exemple +14155550123. »
  • email_addresses (tableau, issu de la conversation) : « Exactement un élément, correspondant à l’adresse email de l’appelant. Omettez-le s’il n’en a pas fourni. » Sous Each item, choisissez string, décrit comme suit : « L’adresse email de l’appelant. »

Enregistrer une note

ChampValeur
Nomadd_attio_note
Description”Notez ce que souhaitait l’appelant dans l’enregistrement de sa personne, avant la fin de l’appel.”
MéthodePOST
URLhttps://api.attio.com/v2/notes
En-têtes de requêteAuthorization (Secret) : Bearer suivi de votre jeton
Paramètres du corpsdata (objet, obligatoire), avec les champs ci-dessous
Attribuer aux agentsRéceptionniste

Sélectionnez Add field sur data pour chacun des éléments suivants :

  • parent_object (chaîne, valeur fixe) : people
  • parent_record_id (chaîne, obligatoire, issu de la conversation) : « Le record_id de la personne provenant de find_attio_person ou de create_attio_person. »
  • title (chaîne, obligatoire, issu de la conversation) : « Un titre court, par exemple : Appel de Jane Doe au sujet d’un devis. »
  • format (chaîne, valeur fixe) : plaintext
  • content (chaîne, obligatoire, issu de la conversation) : « Ce que souhaitait l’appelant, en quelques phrases. »

L’objet parent et le format sont des valeurs fixes : les notes sont ainsi toujours ajoutées à une personne, même si l’IA envoie d’autres valeurs.

find_attio_person renvoie tout ce qui est enregistré sur la personne. Conservez la règle afin que votre réceptionniste utilise Attio uniquement pour reconnaître l’appelant et que les appelants n’entendent jamais les informations d’une autre personne.

Sélectionnez Enable sur chaque outil, puis testez votre réceptionniste avec un appel provenant d’un numéro enregistré sur une personne Attio, puis en tant que nouvel appelant demandant à être rappelé. La nouvelle personne et une note apparaissent dans Attio.

Option 2 : Zapier

1

Connecter Zapier

Si ce n’est pas encore fait, connectez Zapier dans Reception.ai.

2

Ajouter les actions Attio

Dans votre serveur MCP Zapier sur mcp.zapier.com, ajoutez les actions ci-dessous depuis l’application Attio et connectez votre Workspace Attio. Pour chaque champ, définissez une valeur fixe ou laissez l’IA le renseigner, comme indiqué.

3

Attribuer les outils

Dans Reception.ai, ouvrez l’onglet Tools de l’intégration Zapier, sélectionnez Refresh tools, puis attribuez chaque action comme indiqué.

4

Ajouter une règle

Ajoutez une règle indiquant à votre réceptionniste d’utiliser Attio uniquement pour reconnaître les appelants et de ne jamais leur lire les enregistrements ou les notes.

Zapier agit comme l’utilisateur Attio qui a connecté le Workspace et peut voir tout ce que cet utilisateur peut voir. Connectez-vous avec un membre dont l’accès est limité aux enregistrements dont votre réceptionniste a besoin, et conservez la règle afin que les appelants n’entendent jamais les informations d’une autre personne.

5

Le tester

Testez votre réceptionniste avec un appel provenant d’un numéro enregistré sur une personne Attio, puis en tant que nouvel appelant demandant à être rappelé. La nouvelle personne et une note apparaissent dans Attio.

Actions Zapier

Rechercher l’appelant

ChampValeur
Action ZapierFind Records
Définir dans ZapierL’objet : People. L’attribut de recherche : numéro de téléphone.
Laisser l’IA renseignerLa valeur à rechercher : le numéro de téléphone de l’appelant.
Attribuer àClient

Ajouter l’appelant

ChampValeur
Action ZapierCreate Record
Définir dans ZapierL’objet : People. Tous les attributs qui doivent toujours être identiques, si vous les utilisez.
Laisser l’IA renseignerLe prénom, le nom de famille, le numéro de téléphone et l’adresse email.
Attribuer àClient

Enregistrer une note

ChampValeur
Action ZapierCreate Note
Définir dans ZapierL’objet parent : People.
Laisser l’IA renseignerL’ID de l’enregistrement parent (issu des actions précédentes), un titre et le texte de la note indiquant les besoins de l’appelant.
Attribuer àClient

Quelle que soit l’option utilisée, ajoutez une procédure afin que votre réceptionniste recherche d’abord l’appelant, crée une personne uniquement lorsqu’aucune correspondance n’est trouvée, puis enregistre une note.

Limites

  • Attio vérifie la validité des numéros de téléphone. Indiquez à votre réceptionniste, dans la description de l’outil ou de l’action, d’envoyer les numéros au format international, par exemple +14155550123.
  • La création d’une personne échoue lorsqu’une autre personne possède déjà la même valeur unique, telle qu’une adresse email. Votre réceptionniste doit d’abord effectuer une recherche.
  • Les tâches créées via Zapier ne peuvent pas être liées à un enregistrement Attio. Utilisez donc la note pour les détails de l’appel.
  • Avec Zapier, chaque action exécutée par votre réceptionniste utilise des tâches de votre forfait Zapier. Zapier compte actuellement deux tâches par appel réussi ; les appels échoués ne sont pas comptabilisés. Lorsque le forfait est épuisé, les actions s’arrêtent jusqu’à sa réinitialisation.

Résolution des problèmes

ProblèmeÉléments à vérifier
401 ou 403 renvoyé par AttioCommencez la valeur de l’en-tête par Bearer suivi d’un espace, et vérifiez que le jeton dispose des périmètres ci-dessus et n’a pas été supprimé.
Une action Attio n’apparaît pas dans Reception.aiSélectionnez Refresh tools dans l’intégration Zapier après avoir ajouté des actions dans Zapier.
Une action affiche Changed et n’est pas utiliséeVous l’avez modifiée dans Zapier. Sélectionnez Update dans l’onglet Tools.
Les appelants connus ne sont pas trouvésVérifiez que les numéros sont enregistrés avec leur indicatif pays. Avec Zapier, vérifiez que Find Records recherche le numéro de téléphone dans l’objet People.
La création d’une personne échoueLe numéro de téléphone n’est peut-être pas au format international, ou l’adresse email de l’appelant est déjà enregistrée.
Les notes ne sont pas liées à l’appelantVotre réceptionniste a besoin de l’ID de l’enregistrement provenant de l’outil de recherche ou de création, ou de Find Records ou Create Record dans Zapier.