Pour intégrer Fin avec des systèmes externes (par exemple Stripe), vous devez configurer un jeton d'authentification dans votre espace de travail Fin et vous assurer qu'il est correctement configuré. Voici les étapes détaillées 👇
Créer un jeton d'authentification dans Fin
Accédez à Paramètres > Authentification.
Cliquez sur Nouveau jeton.
Remplissez les champs du jeton avec les valeurs suivantes :
Saisissez un titre du jeton.
Saisissez une description.
Sélectionnez un type, par exemple Texte, requête HTTP, utilisateur.
Sous la valeur du jeton, saisissez votre clé API. Il s'agit soit de votre clé secrète de test (par exemple,
sk_test_...) soit de votre clé en production (par exemple,sk_live_...).Définissez le préfixe du jeton sur Bearer.
Définissez la clé pour l'en-tête de la requête sur Authorization.
Après avoir terminé cette étape, vous aurez créé un jeton d'autorisation qui suit ce format lorsqu'il est envoyé dans les requêtes. Par exemple :
Authorization: Bearer <your_stripe_api_key>
Configurer le jeton dans le connecteur de données
Accédez à Paramètres > Connecteurs de données.
Sélectionnez un connecteur de données existant ou créez-en un nouveau.
Localisez la section où vous pouvez sélectionner un jeton d'authentification.
Choisissez le jeton que vous venez de créer dans Fin.
Enregistrez ou confirmez les paramètres pour terminer l'intégration.
À ce stade, votre clé API sera liée avec succès à votre support Fin. Cette configuration garantit une communication fluide et sécurisée entre les systèmes externes et Fin, vous permettant d'accéder directement aux données externes dans vos workflows Fin.
Support multi-jetons
Vous pouvez attacher plusieurs jetons à un seul connecteur de données. Chaque jeton attaché doit être configuré avec une clé d'en-tête unique (par exemple, Authorization, X-API-Key). Tous les jetons attachés seront envoyés avec la requête.
Cette configuration vous permet de déclencher des connecteurs de données en utilisant ce jeton - soit via Workflows, soit via Fin. Le connecteur de données continuera de fonctionner même si la valeur du jeton est mise à jour, car elle sera actualisée en temps réel pour garantir une authentification ininterrompue.
Pour utiliser un JWT par utilisateur avec un connecteur de données, créez un jeton d'authentification « Utilisateur » et fournissez sa valeur actuelle via auth_tokens (par exemple, Intercom('setAuthTokens')), plutôt que de compter sur le Messenger intercom_user_jwt.
Créer un jeton API dans Fin (jetons OAuth)
Les jetons API peuvent être créés par des membres individuels de l'équipe pour permettre aux applications externes d'accéder aux données Fin via l'API.
Allez à Paramètres > Personnel > Jetons API.
Cliquez sur Créer un jeton API.
Saisissez un nom pour votre jeton API et cliquez sur Créer.
Vous pouvez utiliser votre jeton OAuth pour vous authentifier avec l'API Fin, par exemple :
GET https://api.intercom.io/conversations/123
Authorization: Bearer <your_oauth_token>
Note : Ces jetons fonctionnent de la même manière que les jetons créés via les App Packages. Fin crée automatiquement un App Package privé pour votre espace de travail.