Question 1

Quelles possibilités d’intégration offre empirio.ai ?

Accepted Answer

empirio.ai peut être connecté à d’autres systèmes de quatre manières :

* API REST – Gérer les enquêtes et récupérer les réponses via HTTPS.
* Webhooks – Pousser les nouvelles réponses en temps réel vers ton propre système.
* Serveur MCP – Permettre à des agents IA comme ChatGPT ou Claude de travailler directement avec tes enquêtes et leurs réponses.
* CLI – L’outil en ligne de commande @empirio-ai/cli pour les scripts, les automatisations ou des actions rapides depuis le terminal.

Toutes les intégrations sont actuellement en version bêta – les endpoints et le comportement peuvent encore changer.

Tu trouveras plus d’informations sur https://www.empirio.ai/integrations, y compris une documentation complète pour les développeurs.

Question 2

À qui s’adressent les intégrations ?

Accepted Answer

Pour toutes celles et tous ceux qui ne souhaitent pas utiliser empirio.ai uniquement via l’interface web, mais l’intégrer dans leurs propres systèmes ou workflows. Cas d’usage typiques :

Développeurs qui veulent créer des enquêtes de façon automatisée ou transférer les réponses dans leurs propres outils (CRM, data warehouse, outils de BI).

Entreprises qui souhaitent injecter directement les réponses aux enquêtes dans leurs systèmes internes – par exemple envoyer un message Slack après chaque réponse ou transmettre les données aux outils de reporting.

Analystes de données qui traitent régulièrement les réponses dans SPSS, R ou Python et veulent automatiser les exports.

Équipes qui travaillent avec des agents IA et souhaitent donner à leurs agents un accès direct à empirio.ai – via le serveur MCP.

Question 3

De quel forfait ai-je besoin pour les intégrations ?

Accepted Answer

Les intégrations sont disponibles à partir de l’offre Pro. Pour une utilisation intensive ou à l’échelle de l’entreprise, une offre Enterprise avec des limites et des conditions étendues est également proposée. Pour cela, veuillez contacter l’équipe support à l’adresse info@empirio.ai

Question 4

Qu’est-ce que l’API REST et à quoi sert-elle ?

Accepted Answer

L’API REST est l’interface classique pour gérer des enquêtes de façon programmatique. Via HTTPS, tu peux :

* créer, modifier, publier, dupliquer et supprimer des enquêtes
* récupérer, filtrer, exporter et analyser des réponses
* calculer des agrégats, des statistiques et des tableaux croisés
* exporter des graphiques dans différents formats (PowerPoint, PDF, Word, PNG)

Tu t’authentifies soit avec une clé API (pour les applications serveur-à-serveur), soit via OAuth 2.1 (pour les applications qui agissent au nom des utilisateur·rices).

URL de base : https://platform.empirio.ai/rest/v1

La documentation complète des endpoints se trouve dans la documentation développeur.

Question 5

Où puis-je créer une clé API ?

Accepted Answer

Dans le tableau de bord empirio.ai, sous « Intégrations ». En un clic, tu génères une nouvelle clé. Important : la clé n’est affichée qu’une seule fois – enregistre-la immédiatement en lieu sûr (par exemple dans un gestionnaire de mots de passe ou un secret store).
Les clés API ont des scopes : surveys pour les opérations liées aux enquêtes, responses pour l’accès aux réponses. Lors de la création, tu peux définir quelles autorisations la clé doit avoir.

Question 6

Que sont les webhooks et comment les utiliser ?

Accepted Answer

Les webhooks sont le pendant de l’API : au lieu de récupérer régulièrement les données, c’est empirio.ai qui te les envoie automatiquement dès qu’il se passe quelque chose.
Concrètement : dès qu’une personne termine un questionnaire, empirio.ai envoie une charge utile JSON signée à l’URL que tu as configurée. Tu peux réagir immédiatement – par exemple envoyer des e‑mails de suivi automatiques, écrire les données dans ton CRM ou alimenter des tableaux de bord en temps réel.

Pour chaque questionnaire, tu peux enregistrer jusqu’à trois points de terminaison (endpoints) de webhook.
Les webhooks se configurent dans « Intégrations ».

Question 7

Que se passe-t-il si mon point de terminaison de webhook n’est pas joignable ?

Accepted Answer

En cas d’erreur (délai d’attente dépassé, erreur serveur, réponse invalide), empirio.ai tente la livraison jusqu’à trois fois avec des intervalles croissants : immédiatement, puis après 1 minute, puis après 10 minutes.
Important : les webhooks sont livrés avec une garantie « au moins une fois ». En cas de doute, un message sera donc plutôt livré deux fois que pas du tout. Utilise l’en-tête X-Empirio-Delivery-Id pour détecter et ignorer les doublons de ton côté.

Question 8

Qu’est-ce que le serveur MCP ?

Accepted Answer

MCP signifie Model Context Protocol – un standard qui permet aux agents d’IA d’accéder directement à des systèmes externes. Avec notre serveur MCP, tu peux connecter ChatGPT, Claude ou d’autres hôtes d’IA compatibles à tes données empirio.ai.

Voici quelques exemples concrets de ce que ton agent d’IA pourra faire :
« Montre-moi les réponses de ma dernière enquête de satisfaction client. »
« Crée une enquête NPS de 5 questions pour notre nouveau produit et publie-la. »
« Exporte les réponses de l’enquête X sous forme de présentation PowerPoint. »
« Supprime les 10 dernières réponses incomplètes. »

L’agent appelle alors automatiquement les bons outils et te fournit le résultat.

URL du serveur : https://platform.empirio.ai/mcp. L’authentification se fait via OAuth 2.1 avec PKCE et est négociée automatiquement – tu n’as rien à configurer manuellement.

Question 9

Comment connecter Claude ou ChatGPT à empirio.ai ?

Accepted Answer

Pour Claude : dans les paramètres, va dans « Connectors », ajoute empirio.ai comme serveur MCP distant avec l’URL https://platform.empirio.ai/mcp. L’authentification se fait automatiquement.

Pour ChatGPT (via l’API Responses) : utilise l’entrée de serveur MCP dans ta configuration d’outils avec la même URL.

Une fois la connexion établie, l’agent IA a accès à toutes les fonctionnalités pour lesquelles tu lui accordes les autorisations nécessaires (scopes : surveys et/ou responses).

Question 10

Qu’est-ce que la CLI et quand est-il pertinent de l’utiliser ?

Accepted Answer

L’outil en ligne de commande @empirio-ai/cli est une interface installable via npm pour les développeurs qui préfèrent travailler dans le terminal ou qui souhaitent intégrer empirio.ai dans des scripts et des pipelines CI.

Installation :
npm install -g @empirio-ai/cli

La CLI couvre l’ensemble des opérations de l’API REST. L’authentification se fait soit via empirio login (OAuth, pour une utilisation interactive), soit via la variable d’environnement EMPIRIO_API_KEY (pour les scénarios CI et d’automatisation).

Prérequis : Node.js version 20 ou plus récente.

Question 11

Quelles limites de taux s’appliquent aux intégrations ?

Accepted Answer

Pour que notre plateforme reste stable pour tout le monde, nous avons défini des limites claires :

* Opérations de lecture : 60 requêtes par minute et par clé ou utilisateur·rice.
* Opérations d’écriture : 20 requêtes par minute et par clé ou utilisateur·rice.
* Création de sondages : en plus, maximum 10 par heure et 50 par jour et par compte.

Si tu dépasses une limite, l’API répond avec un statut 429 et un en-tête Retry-After qui t’indique combien de temps tu dois attendre.

Pour les clients Enterprise ayant des besoins particulièrement élevés, nous pouvons convenir de limites personnalisées.

Question 12

Mes données sont-elles transmises de manière sécurisée lorsque j’utilise les intégrations ?

Accepted Answer

Oui. Les intégrations respectent les mêmes normes de sécurité que le reste de la plateforme :

HTTPS uniquement : les connexions non chiffrées sont refusées.

Authentification par jeton Bearer : clés API ou jetons OAuth avec des périmètres d’accès clairement définis.

Webhooks signés : chaque livraison de webhook est signée avec HMAC et peut être vérifiée quant à son authenticité.

Limites de débit et clés d’idempotence : protègent contre les exécutions en double involontaires et les usages abusifs.

Hébergement dans l’UE : les points de terminaison d’intégration fonctionnent également sur notre infrastructure basée dans l’UE.

Question 13

Où puis-je trouver la documentation technique complète ?

Accepted Answer

La documentation complète pour les développeurs – avec tous les endpoints, des exemples, les payloads de webhooks et les codes d’erreur – est disponible sur empirio.ai/docs.
Tu y verras également quels types de questions sont pris en charge par l’API, comment les réponses sont structurées et comment appeler les filtres, agrégations et exports.

Question 14

À qui puis-je m’adresser pour des questions techniques concernant l’intégration ?

Accepted Answer

Écris-nous à info@empirio.ai. Pour toute question concernant l’API ou les intégrations, nous serons ravis de t’aider – idéalement en nous indiquant :

Ce que tu souhaites accomplir
Les endpoints que tu utilises
Le code d’erreur exact et le message d’erreur (le cas échéant)

Ainsi, nous pourrons comprendre rapidement la situation.

Centre d’aide