Question 1

¿Qué posibilidades de integración ofrece empirio.ai?

Accepted Answer

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.

Question 2

¿Para quién están pensadas las integraciones?

Accepted Answer

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.

Question 3

¿Qué paquete necesito para las integraciones?

Accepted Answer

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

Question 4

¿Qué es la API REST y para qué la necesito?

Accepted Answer

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.

Question 5

¿Dónde puedo crear una clave de API?

Accepted Answer

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.

Question 6

¿Qué son los webhooks y cómo los utilizo?

Accepted Answer

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».

Question 7

¿Qué ocurre si mi endpoint de webhook no está disponible en algún momento?

Accepted Answer

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.

Question 8

¿Qué es el servidor MCP?

Accepted Answer

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.

Question 9

¿Cómo conecto Claude o ChatGPT con empirio.ai?

Accepted Answer

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).

Question 10

¿Qué es la CLI y cuándo tiene sentido usarla?

Accepted Answer

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.

Question 11

¿Qué límites de uso se aplican a las integraciones?

Accepted Answer

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.

Question 12

¿Se transmitirán mis datos de forma segura al utilizar las integraciones?

Accepted Answer

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.

Question 13

¿Dónde puedo encontrar la documentación técnica completa?

Accepted Answer

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.

Question 14

¿A quién puedo dirigirme si tengo preguntas técnicas sobre la integración?

Accepted Answer

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.

Centro de ayuda