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 |
Claude via MCP
Section intitulée « Claude via MCP »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
API REST
Section intitulée « API REST »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 :
- Connectez-vous à
https://roundtable.<tenant>.askalot.ioet ouvrez Paramètres du profil → Jetons API - Générez un jeton (vous choisissez sa date d’expiration ; le jeton n’est affiché qu’une seule fois)
- Envoyez-le dans l’en-tête
X-Api-Tokende 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.
Format de présentation des enquêtes
Section intitulée « Format de présentation des enquêtes »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
Cette documentation en Markdown
Section intitulée « Cette documentation en Markdown »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.