Aller au contenu
Base de connaissances

Points d'intégration

Askalot propose trois points d’intégration complémentaires. Ils partagent les mêmes capacités de plateforme et le même modèle d’autorisations : choisissez celui qui correspond à la manière dont votre système communique avec Askalot.

Intégration Idéale pour Authentification
Claude (MCP + plugin) Des agents IA qui mènent le cycle de vie de la recherche par la conversation Connexion OAuth 2.1 dans le navigateur
API REST Automatisation de serveur à serveur, CI, applications sur mesure Jeton API personnel (en-tête X-Api-Token)
Format de présentation des enquêtes Afficher des enquêtes en direct dans l’interface de votre propre application Les mêmes identifiants REST

Le serveur MCP d’Askalot permet à Claude (Claude.ai, Claude Desktop, Claude Code) de gérer directement par la conversation projets, questionnaires, campagnes et analyse des données. Les utilisateurs de Claude Code peuvent en outre installer le plugin Askalot — compétences (skills), commandes slash et outils MCP réunis dans un seul paquet. L’authentification repose sur un flux OAuth 2.1 interactif : aucune clé API à gérer.

→ Guide d’intégration de Claude

Toutes les entités de la plateforme — projets, questionnaires, campagnes, répondants, enquêtes, lots, viviers, stratégies — sont disponibles sous https://portor.<tenant>.askalot.io/api/v1, avec une spécification OpenAPI 3.0 et une interface Swagger UI interactive à l’adresse /api/v1/docs.

L’authentification utilise un jeton API personnel :

  1. Connectez-vous à https://roundtable.<tenant>.askalot.io et ouvrez Paramètres du profil → Jetons API
  2. Générez un jeton (vous choisissez sa date d’expiration ; le jeton n’est affiché qu’une seule fois)
  3. Envoyez-le dans l’en-tête X-Api-Token de chaque requête

Le jeton hérite des rôles et des autorisations de votre compte et peut être révoqué à tout moment — la révocation prend effet immédiatement. Sur l’API REST, l’en-tête Authorization: Bearer est réservé aux jetons d’accès OAuth (les identifiants qu’utilise le transport MCP) ; les jetons API transitent toujours dans X-Api-Token.

→ Référence de l’API REST

Au lieu d’intégrer une page d’enquête aux couleurs d’Askalot, votre application peut piloter une session d’enquête item par item et afficher chaque question avec ses propres composants d’interface. Chaque étape arrive sous la forme d’un document JSON autonome — intitulé de la question, spécification du contrôle de saisie et options valides —, tandis que le moteur d’Askalot conserve côté serveur la logique du parcours, les branchements et la validation.

→ Format de présentation des enquêtes

Les agents et outils d’IA peuvent lire cette documentation en Markdown brut plutôt qu’en HTML :

Ce dont vous avez besoin Où l’obtenir
Un index de toutes les pages, avec un résumé d’une ligne pour chacune https://docs.askalot.io/llms.txt
Toute la documentation dans un seul fichier https://docs.askalot.io/llms-full.txt
Une page Ajoutez index.md à l’adresse de la page, par exemple https://docs.askalot.io/integrations/claude/index.md
Une page, sans changer son adresse Demandez la page avec l’en-tête Accept: text/markdown

Le Markdown reprend le contenu affiché sur la page, et ses liens sont absolus : un agent peut donc les suivre quel que soit son point de départ. Claude connecté via MCP peut aussi rechercher et lire la documentation grâce aux outils de documentation.