> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt. # Attio 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](#option-1-webhook-tools-recommended)** appellent directement l'API d'Attio, sans compte Zapier ni utilisation de tâches Zapier. * Les actions **[Zapier](#option-2-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é) ### 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. ### Créer les outils Webhook Pour chaque [outil ci-dessous](#find-the-caller), 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. ### Ajouter une règle Ajoutez une [règle](/docs/fr/reception-ai/receptionist/rules-and-procedures) 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 | Champ | Valeur | | ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Nom** | `find_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éthode** | POST | | **URL** | `https://api.attio.com/v2/objects/people/records/query` | | **En-têtes de requête** | `Authorization` (Secret) : `Bearer ` suivi de votre jeton | | **Paramètres du corps** | `filter` (objet, obligatoire), avec le champ ci-dessous `limit` (entier, valeur fixe) : `5` | | **Attribuer aux agents** | **Ré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 | Champ | Valeur | | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Nom** | `create_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éthode** | POST | | **URL** | `https://api.attio.com/v2/objects/people/records` | | **En-têtes de requête** | `Authorization` (Secret) : `Bearer ` suivi de votre jeton | | **Paramètres du corps** | `data` (objet, obligatoire), avec les champs ci-dessous | | **Attribuer aux agents** | **Ré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 | Champ | Valeur | | ------------------------ | --------------------------------------------------------------------------------------------------- | | **Nom** | `add_attio_note` | | **Description** | "Notez ce que souhaitait l'appelant dans l'enregistrement de sa personne, avant la fin de l'appel." | | **Méthode** | POST | | **URL** | `https://api.attio.com/v2/notes` | | **En-têtes de requête** | `Authorization` (Secret) : `Bearer ` suivi de votre jeton | | **Paramètres du corps** | `data` (objet, obligatoire), avec les champs ci-dessous | | **Attribuer aux agents** | **Ré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. > **Warning** > > `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](/docs/fr/reception-ai/receptionist/testing) 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 ### Connecter Zapier Si ce n'est pas encore fait, connectez [Zapier](/docs/fr/reception-ai/integrations/zapier) dans Reception.ai. ### Ajouter les actions Attio Dans votre serveur MCP Zapier sur [mcp.zapier.com](https://mcp.zapier.com), ajoutez les [actions ci-dessous](#zapier-actions) 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é. ### 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é. ### Ajouter une règle Ajoutez une [règle](/docs/fr/reception-ai/receptionist/rules-and-procedures) indiquant à votre réceptionniste d'utiliser Attio uniquement pour reconnaître les appelants et de ne jamais leur lire les enregistrements ou les notes. > **Warning** > > 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. ### Le tester [Testez votre réceptionniste](/docs/fr/reception-ai/receptionist/testing) 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 | Champ | Valeur | | --------------------------- | ---------------------------------------------------------------- | | **Action Zapier** | **Find Records** | | **Définir dans Zapier** | L'objet : People. L'attribut de recherche : numéro de téléphone. | | **Laisser l'IA renseigner** | La valeur à rechercher : le numéro de téléphone de l'appelant. | | **Attribuer à** | **Client** | #### Ajouter l'appelant | Champ | Valeur | | --------------------------- | ------------------------------------------------------------------------------------------------ | | **Action Zapier** | **Create Record** | | **Définir dans Zapier** | L'objet : People. Tous les attributs qui doivent toujours être identiques, si vous les utilisez. | | **Laisser l'IA renseigner** | Le prénom, le nom de famille, le numéro de téléphone et l'adresse email. | | **Attribuer à** | **Client** | #### Enregistrer une note | Champ | Valeur | | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ | | **Action Zapier** | **Create Note** | | **Définir dans Zapier** | L'objet parent : People. | | **Laisser l'IA renseigner** | L'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** | > **Tip** > > Quelle que soit l'option utilisée, ajoutez une [procédure](/docs/fr/reception-ai/receptionist/rules-and-procedures) > 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 Attio | Commencez 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.ai | Sé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ée | Vous l'avez modifiée dans Zapier. Sélectionnez **Update** dans l'onglet **Tools**. | | Les appelants connus ne sont pas trouvés | Vé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 échoue | Le 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'appelant | Votre 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. |