Avec l'API de Skeepers (v2.0), vous pouvez connecter vos services à Skeepers afin d'exploiter les feedbacks et données collectées dans vos propres outils (CRM, plateforme d'emailing, logiciel maison).
Accessibilité
Avant toute chose, il est important de signaler que pour accéder à la configuration de l'API Skeepers, il est nécessaire d'être l'un des administrateurs du compte de votre organisation.
Un administrateur (aussi nommé responsable opérationnel du compte) est un "super utilisateur" qui détient les accès admins du compte Skeepers de votre organisation dans la plateforme Feedback Management. Il est habituellement désigné au début du partenariat avec Skeepers. Par la suite, il gère la création et la gestion des accès Skeepers Feedback Management sur le compte de votre organisation. Il détient ce droit :
Si vous n'êtes pas administrateur, nous vous invitons à le solliciter dans votre organisation interne pour effectuer les paramétrages de l'API avec vous.
Configurer l'API Skeepers pour un compte standard
Si vous êtes administrateur, vous êtes autonomes quant à l'utilisation de l'API Skeepers, vous pouvez créer autant d’utilisateurs API que vous le souhaitez depuis votre compte.
Pour ce faire, cliquez en haut à droite de la plateforme afin d'ouvrir le volet où vous pourrez choisir d'accéder à la configuration de votre compte d'utilisateur, à la configuration du compte Skeepers Feedback Management de votre organisation ou de vous déconnecter de la plateforme.
Cliquez sur 'Réglages pour [NOM DU COMPTE SKEEPERS DE VOTRE ORGANISATION]'.
Dans les réglages du compte de votre organisation, ouvrez l'onglet 'API'. Vous y découvrirez le lien vers la documentation API et la liste de tous les utilisateurs API créés sur le compte Skeepers de votre organisation. Appuyez ensuite sur le bouton 'Ajouter un nouvel utilisateur'.
Une fois dans la page de mise en place de l'API, tout comme un utilisateur du compte, vous pourrez choisir d'attribuer plus ou moins de rôles, droits et permissions à votre utilisateur API.
En cas de doute, n'hésitez pas à consulter l'article qui détaille l'impact de l'activation de chaque droit : Les différents rôles et droits accessibles sur la plateforme.
Vous bénéficiez d'une autonomie totale dans la configuration de l'API Skeepers.
Compte tenu de la technicité nécessaire à sa mise en place, nos experts techniques vous donnent accès à la documentation dédiée à l'API Skeepers qui détaille tous les appels qu'il est possible d'opérer.
La récupération du statut d'un feedback (invalide/test, valide) est possible. Toutefois, l'API ne pourra récupérer que les feedbacks en production, c'est-à-dire ceux qui sont identifiés comme "valides". Pour obtenir le statut d'un feedback, nous vous invitons à consulter la requête "GET Campaign Answers" détaillée dans la documentation API mise à votre disposition.
Configurer l'API Skeepers pour un compte parent
Si vous êtes administrateur, vous êtes autonomes quant à l'utilisation de l'API Skeepers, vous pouvez créer autant d’utilisateurs API que vous le souhaitez depuis votre compte.
Pour ce faire, cliquez sur la partie 'Comptes' du menu latéral gauche de la plateforme.
Dans les réglages du compte de votre organisation, ouvrez l'onglet 'API'. Vous y découvrirez le lien vers la documentation API et la liste de tous les utilisateurs API créés sur le compte Skeepers de votre organisation. Appuyez ensuite sur le bouton 'Ajouter un nouvel utilisateur'.
Une fois dans la page de mise en place de l'API, tout comme un utilisateur du compte, vous pourrez choisir d'attribuer plus ou moins de rôles, droits et permissions à votre utilisateur API.
En cas de doute, n'hésitez pas à consulter l'article qui détaille l'impact de l'activation de chaque droit : Les différents rôles et droits accessibles sur la plateforme.
Vous bénéficiez d'une autonomie totale dans la configuration de l'API Skeepers.
Compte tenu de la technicité nécessaire à sa mise en place, nos experts techniques vous donnent accès à la documentation dédiée à l'API Skeepers qui détaille tous les appels qu'il est possible d'opérer.
La récupération du statut d'un feedback (invalide/test, valide) est possible. Toutefois, l'API ne pourra récupérer que les feedbacks en production, c'est-à-dire ceux qui sont identifiés comme "valides". Pour obtenir le statut d'un feedback, nous vous invitons à consulter la requête "GET Campaign Answers" détaillée dans la documentation API mise à votre disposition.
Le fonctionnement des jetons (tokens)
Jeton de session (session token)
Un jeton de session permet d'authentifier et autoriser les requêtes API de la plateforme. Ce jeton est généré à chaque connexion de l'utilisateur API et est ensuite inclus dans les requêtes API afin d'identifier l'utilisateur et ses autorisations associées.
En résumé, le jeton de session agit comme un identifiant temporaire et sécurisé qui permet à l'API d'accéder aux fonctionnalités et aux données de la plateforme, tout en garantissant la sécurité et la confidentialité des informations échangées.
Dans Skeepers, les jetons de session ont une durée de validité de 5 minutes, la date d'expiration est indiquée sur la plateforme. Si le bouton 'Actualiser' est cliqué, un nouveau jeton de session sera généré et la durée de validité du jeton de rafraîchissement sera prolongée de 30 jours.
Jeton de rafraichissement (refresh token)
Un jeton de rafraîchissement est un type de jeton utilisé dans les systèmes d'authentification OAuth pour obtenir de nouveaux jetons de session (session tokens) sans nécessiter que l'utilisateur API se connecte à nouveau.
En résumé, le jeton de rafraîchissement est un mécanisme permettant de maintenir la session active et de garantir un accès continu et sécurisé aux fonctionnalités de Skeepers via son API.
Un jeton de rafraîchissement reste valide tant qu'il est utilisé régulièrement. Il restera donc actif tant que des interactions régulières avec Skeepers sont maintenues, dans d'autres cas, il expirera prématurément.
Si vous avez des questions, n'hésitez pas à contacter notre équipe Customer Care.