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.

API pública de Formularios de Captura

Si además querés consumir directamente la API de los formularios de captura —leer la configuración de un formulario o enviar un lead por código, en vez de usar el iframe o el script ya armados— revisa API de Formularios. A diferencia de la API de agentes, esta es pública (sin API key) y pensada para integraciones desde el navegador del visitante.

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.