> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt. # Twenty Votre réceptionniste peut identifier les appelants déjà présents dans Twenty et ajouter les nouveaux appelants en tant que personnes, avec leur nom, leur numéro de téléphone et le motif de leur appel, afin que votre équipe commerciale puisse assurer le suivi. Reception se connecte au [serveur MCP](/docs/fr/reception-ai/integrations/mcp-server) intégré à Twenty, qui fonctionne avec Twenty Cloud et Twenty auto-hébergé. Vous pouvez aussi concevoir des [outils webhook](/docs/fr/reception-ai/integrations/webhooks) pour l’API REST de Twenty, mais le serveur MCP demande moins de configuration : il fournit à votre réceptionniste des outils prêts à l’emploi pour rechercher et ajouter des personnes, déjà associés aux champs de votre Workspace, y compris le champ du motif d’appel ci-dessous. ## Configuration ### Ajoutez un champ pour le motif d’appel Les personnes dans Twenty ne possèdent pas de champ de notes. Pour conserver le motif de l’appel dans leur fiche, accédez à **Paramètres** → **Modèle de données**, ouvrez **Personnes**, puis ajoutez un champ **Texte** nommé `Call reason`. Seuls les administrateurs du Workspace peuvent modifier le modèle de données. ### Créez un rôle pour Reception.ai Accédez à **Paramètres** → **Membres** → **Rôles** et créez un rôle qui peut uniquement lire et créer des personnes. Vous lui attribuerez la clé API à l’étape suivante. ### Créez une clé API Accédez à **Paramètres** → **Développeurs** → **API**, puis sélectionnez **+ Créer une clé**. Nommez-la, par exemple, `Reception.ai`, et copiez-la immédiatement : Twenty ne l’affiche qu’une seule fois. Ouvrez ensuite le rôle que vous avez créé, accédez à son onglet **Attribution**, puis attribuez-lui la clé. > **Warning** > > La clé API peut lire et modifier tout ce que son rôle autorise. Ne la conservez pas dans des documents partagés et > supprimez-la dans Twenty si elle est divulguée. ### Ajoutez le serveur MCP Dans Reception.ai, accédez à **Intégrations**, sélectionnez **Ajouter une intégration**, puis choisissez **Serveur MCP**. | Champ | Valeur | | ------------------- | ----------------------------------------------------------------------- | | **Nom** | Twenty | | **Type de serveur** | HTTP streamable | | **URL du serveur** | L’adresse de votre Workspace suivie de `/mcp`, comme indiqué ci-dessous | | **Jeton secret** | Votre clé API | | Emplacement de Twenty | URL du serveur | | --------------------- | --------------------------------------------------------------------------- | | Twenty Cloud | L’URL de votre Workspace, par exemple `https://mycompany.twenty.com/mcp` | | Auto-hébergé | L’URL publique de votre instance, par exemple `https://crm.example.com/mcp` | Vous pouvez copier l’adresse exacte depuis **Paramètres** → **IA** → **MCP** dans Twenty. N’ajoutez pas `?mode=meta` à l’URL : ce mode donne à votre réceptionniste un outil unique capable d’exécuter n’importe quelle action. Sélectionnez **Activer**. Reception.ai envoie la clé comme jeton Bearer et répertorie les outils de Twenty. ### Attribuez les outils Twenty répertorie un outil pour chaque action de chaque objet. Ouvrez l’onglet **Outils** et attribuez uniquement les suivants au **Client** (réceptionniste) : * `find_many_people` : recherchez l’appelant par numéro de téléphone. * `create_one_person` : ajoutez un nouvel appelant avec son nom, son numéro de téléphone et le motif de son appel. Ne sélectionnez pas les outils de mise à jour et de suppression, ni les outils des autres objets. ### Ajoutez une procédure Ajoutez une [procédure](/docs/fr/reception-ai/receptionist/rules-and-procedures) pour les nouveaux prospects : recherchez d’abord l’appelant par numéro de téléphone, créez une personne uniquement si aucune correspondance n’est trouvée et renseignez toujours le prénom, le nom, le numéro de téléphone et le motif d’appel. Ajoutez une règle interdisant à votre réceptionniste de lire les fiches CRM aux appelants. ### Testez la configuration [Testez votre réceptionniste](/docs/fr/reception-ai/receptionist/testing) en appelant depuis un numéro enregistré pour une personne dans Twenty, puis en tant que nouvel appelant souhaitant obtenir un devis. La nouvelle personne apparaît dans **Personnes**, avec le motif d’appel renseigné. ## Limites * Twenty enregistre l’indicatif téléphonique du pays séparément du reste du numéro. Les appelants enregistrés sans indicatif pays ou dans un autre format peuvent ne pas être trouvés. Un appelant récurrent peut donc être ajouté deux fois. * Dans cette configuration, votre réceptionniste ne crée pas de notes, de tâches ni d’opportunités. Votre équipe traite les nouvelles personnes depuis la liste **Personnes**, par exemple avec une vue filtrée sur **Call reason**. * Les instances auto-hébergées nécessitent une version de Twenty incluant le serveur MCP, et leur URL publique doit être accessible depuis Internet via HTTPS. * L’API de Twenty autorise 100 requêtes par minute. Les Workspaces très sollicités avec d’autres intégrations peuvent atteindre cette limite. ## Résolution des problèmes | Problème | Vérifications à effectuer | | ------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Aucun outil n’est répertorié | Utilisez le type de serveur **HTTP streamable** et vérifiez que l’URL se termine par `/mcp`. En auto-hébergement, le paramètre `SERVER_URL` doit correspondre à votre URL publique. | | Un outil renvoie une erreur d’autorisation | Le rôle de la clé ne peut pas lire ou créer des personnes. Modifiez le rôle dans **Paramètres** → **Membres** → **Rôles**. | | Les appelants connus ne sont pas trouvés | Enregistrez les numéros de téléphone avec leur indicatif pays et dans un format unique. | | Le motif d’appel est vide | Sélectionnez **Actualiser les outils** après avoir ajouté le champ `Call reason`, puis sélectionnez **Mettre à jour** sur l’outil modifié. | | Vous avez modifié la clé | Modifiez l’intégration et utilisez **Faire pivoter le jeton secret (facultatif)**. La clé enregistrée ne s’affiche plus jamais. |