|
| 1 | +--- |
| 2 | +title: Clés API et Webhooks |
| 3 | +info: "Créer et gérer des clés API pour l'authentification et configurer des webhooks pour les notifications en temps réel." |
| 4 | +image: /images/user-guide/api/api.png |
| 5 | +sectionInfo: Découvrez comment connecter Twenty à vos autres outils. |
| 6 | +--- |
| 7 | + |
| 8 | +<Frame> |
| 9 | + <img src="/images/user-guide/api/api.png" alt="Header" /> |
| 10 | +</Frame> |
| 11 | + |
| 12 | +## Clés API |
| 13 | + |
| 14 | +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. |
| 15 | + |
| 16 | +### Créer une clé API |
| 17 | + |
| 18 | +1. Allez dans **Paramètres → API & Webhooks** |
| 19 | +2. Cliquez sur **+ Créer une clé** en haut à droite |
| 20 | +3. Configurer votre clé API : |
| 21 | + - **Nom** : Donnez un nom descriptif à votre clé API |
| 22 | + - **Date d'expiration** : Définissez la date à laquelle la clé doit expirer |
| 23 | +4. Cliquez sur **Enregistrer** pour générer votre clé API |
| 24 | +5. **Important** : Copiez et enregistrez votre clé API immédiatement, elle n'est affichée qu'une seule fois |
| 25 | + |
| 26 | +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. |
| 27 | + |
| 28 | +<Warning> |
| 29 | +É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. |
| 30 | +</Warning> |
| 31 | +<div style={{padding:'70.59% 0 0 0', position:'relative', margin: '32px 0px 0px' }}> |
| 32 | + <iframe |
| 33 | + src="https://player.vimeo.com/video/928786722?autoplay=1&loop=1&autopause=0&background=1&app_id=58479" |
| 34 | + frameBorder="0" |
| 35 | + allow="autoplay; fullscreen; picture-in-picture; clipboard-write" |
| 36 | + style={{ |
| 37 | + position:'absolute', |
| 38 | + top:0, |
| 39 | + left:0, |
| 40 | + width:'100%', |
| 41 | + height:'100%', |
| 42 | + borderRadius: '16px', |
| 43 | + border:'2px solid black' |
| 44 | + }} |
| 45 | + title="Export data" |
| 46 | + ></iframe> |
| 47 | +</div> |
| 48 | +<script src="https://player.vimeo.com/api/player.js"></script> |
| 49 | + |
| 50 | +### Gérer les clés API |
| 51 | + |
| 52 | +**Régénérer une clé API :** |
| 53 | + |
| 54 | +1. Allez dans **Paramètres → API & Webhooks** |
| 55 | +2. Cliquez sur la clé API que vous souhaitez régénérer |
| 56 | +3. Cliquez sur le bouton **Régénérer** |
| 57 | +4. Copiez et stockez immédiatement la nouvelle clé API. |
| 58 | + |
| 59 | +**Supprimer la clé API:** |
| 60 | + |
| 61 | +1. Trouvez la clé API dans votre liste |
| 62 | +2. Cliquez sur la clé pour ouvrir ses détails |
| 63 | +3. Cliquez sur **Supprimer** pour la supprimer définitivement |
| 64 | + |
| 65 | +## Webhooks |
| 66 | + |
| 67 | +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. |
| 68 | + |
| 69 | +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](/user-guide/workflows/getting-started-workflows), qui offre des déclencheurs basés sur des mises à jour de champs pour l'automatisation interne. |
| 70 | + |
| 71 | +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. |
| 72 | + |
| 73 | +### Créer un Webhook |
| 74 | + |
| 75 | +1. Allez dans **Paramètres → API & Webhooks → Webhooks** |
| 76 | +2. Cliquez sur **+ Créer un webhook** |
| 77 | +3. Entrez l'URL de votre webhook (où vous souhaitez recevoir des notifications) |
| 78 | +4. Cliquez sur **Enregistrer** |
| 79 | + |
| 80 | +Votre webhook commencera immédiatement à recevoir des notifications en temps réel sur les modifications de vos données CRM. |
| 81 | + |
| 82 | +<div style={{padding:'70.59% 0 0 0', position:'relative', margin: '32px 0px 0px'}}> |
| 83 | + <iframe |
| 84 | + src="https://player.vimeo.com/video/928786708?autoplay=1&loop=1&autopause=0&background=1&app_id=58479" |
| 85 | + frameBorder="0" |
| 86 | + allow="autoplay; fullscreen; picture-in-picture; clipboard-write" |
| 87 | + style={{ |
| 88 | + position:'absolute', |
| 89 | + top:0, |
| 90 | + left:0, |
| 91 | + width:'100%', |
| 92 | + height:'100%', |
| 93 | + borderRadius: '16px', |
| 94 | + border:'2px solid black' |
| 95 | + }} |
| 96 | + title="Export data" |
| 97 | + ></iframe> |
| 98 | +</div> |
| 99 | +<script src="https://player.vimeo.com/api/player.js"></script> |
| 100 | + |
| 101 | +### Gérer les Webhooks |
| 102 | + |
| 103 | +**Supprimer le webhook:** |
| 104 | + |
| 105 | +1. Allez dans **Paramètres → API & Webhooks → Webhooks** |
| 106 | +2. Trouvez le webhook que vous souhaitez supprimer |
| 107 | +3. Cliquez sur le webhook |
| 108 | +4. Cliquez sur **Supprimer** et confirmez dans la fenêtre contextuelle |
| 109 | + |
| 110 | +**Modifier un webhook:** |
| 111 | + |
| 112 | +1. Cliquez sur le webhook que vous souhaitez modifier |
| 113 | +2. Mettez à jour l'URL ou d'autres paramètres |
| 114 | +3. Cliquez sur **Enregistrer** pour appliquer les modifications |
| 115 | + |
0 commit comments