Passer au contenu principal
Header

​
Clés API

Les clés API permettent un accès automatisé à vos données CRM, synchronisent les données avec d’autres systèmes, et créent des intégrations ou solutions personnalisées.

​
Créer une clé API

  1. Allez dans Paramètres → API & Webhooks
  2. Cliquez sur + Créer une clé en haut à droite
  3. Configurer votre clé API :
    • Nom : Donnez un nom descriptif à votre clé API
    • Date d’expiration : Définissez la date à laquelle la clé doit expirer
  4. Cliquez sur Enregistrer pour générer votre clé API
  5. Important : Copiez et enregistrez votre clé API immédiatement, elle n’est affichée qu’une seule fois
Une fois créée, votre clé API fournit l’accès à votre documentation API personnalisée et à l’espace d’expérimentation où vous pouvez tester des endpoints avec votre modèle de données réel.
Étant donné que votre clé API donne accès à des informations sensibles, vous ne devriez pas la partager avec des services auxquels vous ne faites pas pleinement confiance. Si elle est divulguée, quelqu’un peut l’utiliser de manière malveillante. Si la sécurité de votre clé API est compromise, désactivez-la immédiatement et générez-en une nouvelle.

​
Gérer les clés API

Régénérer une clé API :
  1. Allez dans Paramètres → API & Webhooks
  2. Cliquez sur la clé API que vous souhaitez régénérer
  3. Cliquez sur le bouton Régénérer
  4. Copiez et stockez immédiatement la nouvelle clé API.
Supprimer la clé API:
  1. Trouvez la clé API dans votre liste
  2. Cliquez sur la clé pour ouvrir ses détails
  3. Cliquez sur Supprimer pour la supprimer définitivement

​
Webhooks

Les webhooks permettent des mises à jour immédiates de votre URL spécifiée concernant des changements ou événements liés à vos données client. Par exemple, lorsqu’une Opportunité passe à “Fermé Gagné”, un webhook peut automatiquement déclencher la création d’une facture dans votre système comptable. Notez que ce type d’automatisation peut également être réalisé à l’aide de la fonctionnalité Workflows de Twenty, qui offre des déclencheurs basés sur des mises à jour de champs pour l’automatisation interne. Les Webhooks sont idéaux pour l’intégration avec les systèmes externes, tandis que les Workflows prennent en charge à la fois l’automatisation interne et les connexions via des déclencheurs de webhook, des nœuds de code et des nœuds HTTP.

​
Créer un Webhook

  1. Allez dans Paramètres → API & Webhooks → Webhooks
  2. Cliquez sur + Créer un webhook
  3. Entrez l’URL de votre webhook (où vous souhaitez recevoir des notifications)
  4. Cliquez sur Enregistrer
Votre webhook commencera immédiatement à recevoir des notifications en temps réel sur les modifications de vos données CRM.

​
Gérer les Webhooks

Supprimer le webhook:
  1. Allez dans Paramètres → API & Webhooks → Webhooks
  2. Trouvez le webhook que vous souhaitez supprimer
  3. Cliquez sur le webhook
  4. Cliquez sur Supprimer et confirmez dans la fenêtre contextuelle
Modifier un webhook:
  1. Cliquez sur le webhook que vous souhaitez modifier
  2. Mettez à jour l’URL ou d’autres paramètres
  3. Cliquez sur Enregistrer pour appliquer les modifications