Twenty
Identifiez les appelants et ajoutez de nouveaux prospects à Twenty CRM via son serveur MCP.
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 intégré à Twenty, qui fonctionne avec Twenty Cloud et Twenty auto-hébergé. Vous pouvez aussi concevoir des outils webhook 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é.
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.
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 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 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.