Twenty CRM en pratique 4 min

API et webhooks de Twenty : relier le CRM au reste

Twenty génère une API pour chaque objet de votre modèle, standard ou personnalisé, en REST comme en GraphQL, et peut prévenir d'autres logiciels par des webhooks quand une fiche change. On s'en sert pour faire du CRM la source de vérité : le site y dépose les demandes, la facturation y lit les affaires gagnées, les assistants y cherchent l'information.

Sommaire7
  1. 01Une API qui suit votre modèle
  2. 02Ce que l’on relie, concrètement
  3. 03Webhooks : être prévenu plutôt que demander
  4. 04Les règles qui évitent les ennuis
  5. 05API, MCP et assistants d’IA
  6. 06Ce que l’ouverture ne règle pas
  7. 07Questions fréquentes

Un CRM qui ne parle à aucun autre outil finit doublé par des tableurs : la facturation tient sa liste de clients, le support la sienne, le site envoie ses demandes par e-mail. L’intérêt de Twenty, pour une équipe qui veut sortir de ce morcellement, tient beaucoup à son ouverture : tout ce qu’on voit dans l’interface se lit et s’écrit aussi par programme.

Une API qui suit votre modèle

D’après la documentation développeur de Twenty, chaque objet de l’espace de travail, y compris ceux que vous avez créés, dispose de son API en REST et en GraphQL, générée automatiquement. Ajoutez un objet « Contrats » : il est lisible et modifiable par l’API dans la foulée, sans développement côté CRM. C’est ce qui rend les intégrations rapides à monter, et c’est aussi ce qui impose de soigner le modèle de données, puisqu’il devient votre interface.

Ce que l’on relie, concrètement

Le CRM comme source de vérité

  1. Le site

    Chaque demande du formulaire crée ou complète une fiche.

  2. Twenty

    La personne, la société, l’opportunité et la tâche vivent ici.

  3. La facturation

    L’affaire gagnée y crée le client, sans ressaisie.

  4. Les assistants

    Ils cherchent l’information et préparent les mises à jour.

Chez nous, le site dépose chaque demande dans Twenty par un webhook entrant, et une copie brute est gardée à part : si le CRM est indisponible, rien n’est perdu. La fiche client unique montre ce que ce rassemblement change pour l’équipe, de la vente au support.

Webhooks : être prévenu plutôt que demander

Un webhook est un appel que Twenty envoie à une adresse de votre choix quand un événement se produit : une fiche créée, modifiée, supprimée. Il évite qu’un autre logiciel interroge le CRM en boucle pour savoir si quelque chose a changé. C’est le bon mécanisme pour déclencher un circuit n8n quand une opportunité passe en Gagné, ou pour tenir à jour un tableau de bord. Workflows Twenty ou n8n explique comment répartir les rôles entre le CRM et l’orchestrateur.

Les règles qui évitent les ennuis

  1. Une clé par intégration.

    Chaque branchement a sa clé, son rôle limité et un usage écrit ; une clé partagée par tous ne se révoque jamais.

  2. La date d’expiration notée.

    Les clés de Twenty expirent ; une intégration qui s’arrête sans raison commence souvent par là.

  3. Le bon débit.

    Les corrections de masse passent par l’API à un rythme qui respecte ses limites, par lots, avec reprise.

  4. Une trace hors du CRM.

    Ce qui entre par l’API depuis l’extérieur est gardé brut ailleurs, pour rejouer en cas d’échec.

  5. Un webhook vérifié.

    L’adresse qui reçoit les appels contrôle leur origine et ignore ce qu’elle ne reconnaît pas.

API, MCP et assistants d’IA

Au-dessus de l’API, Twenty propose un serveur MCP, le protocole qui permet à un assistant d’IA d’interroger des outils. Concrètement, une personne de l’équipe peut demander à son assistant « quelles opportunités n’ont pas bougé ce mois-ci » et obtenir la liste, sans écrire de requête. Le serveur s’appuie sur les mêmes droits que l’API : un assistant ne voit que ce que son rôle autorise. Parler à son CRM en langage naturel détaille les usages et les garde-fous, et le protocole MCP est documenté publiquement.

API et webhooks

  • Pour des intégrations écrites une fois et qui tournent seules

  • Comportement prévisible, testable

  • Demande un profil technique

Serveur MCP

  • Pour des questions ponctuelles en langage courant

  • Réponses qui dépendent de l’assistant utilisé

  • Accessible à toute l’équipe, avec des droits limités

Ce que l’ouverture ne règle pas

Une API ne décide pas de ce qui fait foi. Si la facturation et le CRM peuvent tous deux modifier l’adresse d’un client, il faut écrire lequel gagne en cas de conflit. Cette règle, une ligne par information partagée, compte plus que la technique. Le guide pratique de Twenty place les intégrations dans l’ordre du déploiement, et notre offre CRM livre les premiers branchements avec leurs clés, leurs rôles et leur documentation.

Questions fréquentes

Faut-il choisir entre l’API REST et l’API GraphQL de Twenty ?

Non, les deux donnent accès aux mêmes objets. REST est souvent plus simple pour un outil d’automatisation ou un script ponctuel ; GraphQL permet de demander en une fois une fiche et ses relations, utile pour une application ou un tableau de bord. Le choix revient à la personne qui écrit l’intégration, selon ses habitudes et l’outil utilisé.

Peut-on relier Twenty à un logiciel qui n’a pas d’API ?

Directement, non : il faut un pont. Selon le logiciel, ce pont passe par des exports de fichiers déposés automatiquement, par une boîte mail dédiée ou par un automate qui pilote l’interface. Ces solutions fonctionnent mais demandent plus de surveillance qu’une vraie API. Elles valent d’être comparées au remplacement du logiciel s’il est central.

Les webhooks de Twenty sont-ils fiables ?

Ils sont fiables pour prévenir rapidement, mais un appel peut échouer si l’outil destinataire est indisponible à ce moment. Pour un circuit important, prévoyez une vérification de rattrapage, par exemple une lecture régulière par l’API des fiches modifiées récemment. Le webhook déclenche vite, la lecture de rattrapage garantit que rien n’est oublié.

Un assistant d’IA peut-il modifier les fiches par le serveur MCP ?

Oui, si son rôle l’autorise. La prudence conseille de commencer en lecture seule, puis d’ouvrir l’écriture sur des objets où une erreur se rattrape facilement, comme les notes ou les tâches. Les suppressions et les changements de statut importants restent des décisions humaines, validées par la personne responsable de la fiche.

Sources

  1. Twenty, documentation développeur (nouvel onglet)twenty.com
  2. Model Context Protocol, site officiel (nouvel onglet)modelcontextprotocol.io
Source 1

Twenty, documentation développeur

Lire sur twenty.com(nouvel onglet)
Source 2

Model Context Protocol, site officiel

Lire sur modelcontextprotocol.io(nouvel onglet)

Jim · fondateur de Brain Plus AI

À lire aussi en twenty crm en pratique

  • Guide pratique9 min

    Parler à son CRM en langage naturel : MCP et garde-fous

    Les CRM publient désormais un serveur MCP : depuis ChatGPT, Claude, Gemini ou Mistral, on interroge ses fiches et on prépare des mises à jour en langage courant. Ce que cela change pour une équipe commerciale, les droits à régler, et ce qu'un agent ne doit jamais faire seul.

  • Guide pratique8 min

    Fiche client unique : réunir CRM, facturation et support

    Le commercial propose une extension à un client dont la facture est impayée et le ticket ouvert depuis dix jours : il ne voyait ni l'une ni l'autre. Ce que change une fiche client unique pour chaque métier, les deux façons de la construire et la règle qui la rend fiable.

  • Guide pratique5 min Le guide du sujet

    Twenty CRM en pratique : le guide pour une équipe

    Modèle de données, vues, workflows, import, droits, hébergement, API et adoption : ce que Twenty demande et ce qu'il rend à une équipe commerciale. Le guide d'entrée de la rubrique, avec un lien vers chaque article qui approfondit.

WhatsApp