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