Desarrolladores / API

Si tú o tu equipo técnico quieren ir más allá del panel de EMMIA —integrando tus agentes en tu propio sitio o sistema, o conectando herramientas externas— esta página te orienta sobre las dos vías disponibles: la API pública REST y el portal de desarrolladores de EMMIA.

API pública REST de tus agentes

EMMIA expone una API REST (/api/v1) que te permite conversar con tus agentes desde tus propias aplicaciones, usando una API key de organización con el prefijo pk_live_.

En resumen:

• Autenticación mediante la cabecera x-api-key (o Authorization: Bearer pk_live_...).
• Endpoints para listar tus agentes, ver el detalle de uno, y conversar con él.
• La conversación responde por streaming (Server-Sent Events), en fragmentos de texto en tiempo real.
• El acceso a la API, la cantidad de keys permitidas y los límites de peticiones por minuto/día dependen de tu plan — ver Planes.

Para crear una key y ver el detalle técnico de autenticación, formato de eventos y ejemplos de código, revisa API Keys, donde encontrarás la guía completa con ejemplos en curl y JavaScript.

Portal de desarrolladores de EMMIA

Además de la API de agentes, EMMIA cuenta con un portal de desarrolladores separado, pensado para quienes quieren construir e integrar herramientas (tools) externas que luego cualquier organización pueda habilitar en sus agentes, similar a un pequeño marketplace de integraciones.

Si tu objetivo es:

• Conversar con tus agentes desde tu propio sistema → usa la API pública REST descrita arriba, con una API key de tu organización.
• Construir una herramienta nueva que otros agentes puedan usar (por ejemplo, conectar un sistema propio como una tool que el agente puede invocar) → esto se gestiona desde el portal de desarrolladores de EMMIA, con su propia cuenta de desarrollador independiente de tu cuenta de organización.

Nota: el portal de desarrolladores es una plataforma aparte del panel principal de EMMIA, orientada a quienes construyen integraciones, no a la operación diaria de tu negocio. Si solo quieres usar herramientas ya disponibles (como CRM, agenda, Jira, GitHub, etc.) en tus agentes, no necesitas el portal de desarrolladores — puedes habilitarlas directamente desde la pestaña de Herramientas de cada agente.