empirio.ai puede conectarse con otros sistemas de cuatro maneras: * REST API: gestiona encuestas y recupera respuestas mediante HTTPS. * Webhooks: envía nuevas respuestas en tiempo real a tu propio sistema. * Servidor MCP: permite que agentes de IA como ChatGPT o Claude trabajen directamente con tus encuestas y respuestas. * CLI: la herramienta de línea de comandos @empirio-ai/cli para scripts, automatizaciones o acciones rápidas desde el terminal. Todas las integraciones se encuentran actualmente en fase beta: los endpoints y el comportamiento aún pueden cambiar. Encontrarás más información en https://www.empirio.ai/integrations, incluida la documentación completa para desarrolladores.

Para todas las personas que no solo quieran usar empirio.ai a través de la interfaz web, sino también integrarlo en sus propios sistemas o flujos de trabajo. Casos de uso típicos: Desarrolladores que quieran crear encuestas de forma automatizada o incorporar las respuestas en sus propias herramientas (CRM, Data Warehouse, herramientas de BI). Empresas que deseen volcar las respuestas de las encuestas directamente en sistemas internos, por ejemplo, enviar un mensaje de Slack después de cada respuesta o transferir los datos a los informes. Analistas de datos que procesan regularmente las respuestas en SPSS, R o Python y quieren automatizar las exportaciones. Equipos que trabajan con agentes de IA y quieren dar a sus agentes acceso directo a empirio.ai a través del servidor MCP.

Las integraciones están disponibles a partir del plan Pro. Para un uso intensivo o a nivel empresarial, también hay un plan Enterprise con límites y condiciones ampliados. Para ello, ponte en contacto con el equipo de soporte en info@empirio.ai

La API REST es la interfaz clásica para la gestión programática de encuestas. A través de HTTPS puedes: * Crear, editar, publicar, duplicar y eliminar encuestas * Recuperar, filtrar, exportar y analizar respuestas * Calcular agregados, estadísticas y tablas cruzadas * Exportar gráficos en varios formatos (PowerPoint, PDF, Word, PNG) Puedes autenticarte con una clave de API (para aplicaciones de servidor a servidor) o mediante OAuth 2.1 (para aplicaciones que actúan en nombre de las personas usuarias). URL base: https://platform.empirio.ai/rest/v1 La documentación completa de los endpoints está disponible en la documentación para desarrolladores.

En el panel de control de empirio.ai, en «Integraciones». Con un solo clic generas una nueva clave. Importante: la clave solo se muestra una vez, así que guárdala de inmediato en un lugar seguro (por ejemplo, en un gestor de contraseñas o un almacén de secretos). Las claves de API tienen ámbitos (scopes): surveys para operaciones de encuestas, responses para el acceso a las respuestas. Al crearlas puedes definir qué permisos debe tener la clave.

Los webhooks son el contrapunto de la API: en lugar de que tengas que consultar los datos periódicamente, empirio.ai te envía activamente los datos en cuanto ocurre algo. Concretamente: en cuanto una persona termina una encuesta, empirio.ai envía una carga útil JSON firmada a la URL que hayas configurado. Puedes reaccionar de inmediato: por ejemplo, enviar correos de seguimiento automáticos, escribir datos en tu CRM o alimentar paneles en tiempo real. Por cada encuesta puedes registrar hasta tres endpoints de webhook. Los webhooks se configuran en «Integraciones».

En caso de error (tiempo de espera agotado, error del servidor, respuesta no válida), empirio.ai intenta la entrega hasta tres veces con intervalos crecientes: inmediatamente, luego después de 1 minuto y después de 10 minutos. Importante: los webhooks se entregan con una garantía de al menos una vez. En caso de duda, es preferible que un mensaje llegue dos veces a que no llegue. Utiliza la cabecera X-Empirio-Delivery-Id para detectar e ignorar duplicados en tu sistema.

MCP significa Model Context Protocol: un estándar que permite a los agentes de IA acceder directamente a sistemas externos. Con nuestro servidor MCP puedes conectar ChatGPT, Claude u otros hosts de IA compatibles con tus datos de empirio.ai. Ejemplos concretos de lo que tu agente de IA podrá hacer: «Enséñame las respuestas de mi última encuesta de satisfacción de clientes». «Crea una encuesta NPS de 5 preguntas para nuestro nuevo producto y publícala». «Exporta las respuestas de la encuesta X como una presentación de PowerPoint». «Elimina las 10 últimas respuestas incompletas». El agente llamará automáticamente a las herramientas adecuadas y te entregará el resultado. URL del servidor: https://platform.empirio.ai/mcp. La autenticación se realiza mediante OAuth 2.1 con PKCE y se negocia automáticamente, no tienes que configurar nada manualmente.

Para Claude: Ve a la sección de configuración de «Connectors», añade empirio.ai como servidor MCP remoto con la URL https://platform.empirio.ai/mcp. La autenticación se realiza automáticamente. Para ChatGPT (a través de la Responses API): Utiliza la entrada del servidor MCP en tu configuración de herramientas con la misma URL. Una vez establecida la conexión, el agente de IA tendrá acceso a todas las funciones para las que le concedas los permisos necesarios (scopes: surveys y/o responses).

La herramienta de línea de comandos @empirio-ai/cli es una interfaz instalable vía npm para desarrolladores que prefieren trabajar en el terminal o que quieren integrar empirio.ai en scripts y pipelines de CI. Instalación: npm install -g @empirio-ai/cli La CLI cubre todas las operaciones de la API REST. La autenticación se realiza mediante empirio login (OAuth, para uso interactivo) o mediante la variable de entorno EMPIRIO_API_KEY (para escenarios de CI y automatización). Requisito previo: Node.js versión 20 o superior.

Para que nuestra plataforma se mantenga estable para todo el mundo, existen límites claros: * Operaciones de lectura: 60 solicitudes por minuto y por clave o usuario. * Operaciones de escritura: 20 solicitudes por minuto y por clave o usuario. * Creación de encuestas: además, un máximo de 10 por hora y 50 por día y por cuenta. Si superas algún límite, la API responde con un estado 429 y una cabecera Retry-After que te indica cuánto tiempo debes esperar. Para clientes Enterprise con necesidades especialmente altas, podemos acordar límites personalizados.

Sí. Las integraciones siguen los mismos estándares de seguridad que el resto de la plataforma: Solo HTTPS: las conexiones no cifradas se rechazan. Autenticación mediante token Bearer: claves de API o tokens OAuth con ámbitos claramente delimitados. Webhooks firmados: cada entrega de webhook está firmada con HMAC y puede verificarse su autenticidad. Límites de frecuencia y claves de idempotencia: protegen frente a ejecuciones duplicadas accidentales y usos indebidos. Alojamiento en la UE: los endpoints de integración también se ejecutan en nuestra infraestructura ubicada en la UE.

La documentación completa para desarrolladores, con todos los endpoints, ejemplos, cargas útiles de webhooks y códigos de error, está disponible en empirio.ai/docs. Allí también puedes ver qué tipos de preguntas admite la API, cómo se estructuran las respuestas y cómo llamar a filtros, agregaciones y exportaciones.

Escríbenos a info@empirio.ai. Si tienes preguntas sobre la API o las integraciones, estaremos encantados de ayudarte; lo mejor es que nos indiques directamente: Qué quieres conseguir Qué endpoints utilizas El código de error exacto y el mensaje de error (si lo hay) Así podremos entender el caso rápidamente.