API Keys
EMMIA tiene dos tipos distintos de API keys, según lo que quieras hacer: API keys de organización para integraciones generales con tus agentes, y API keys por agente para casos específicos como embeber el widget.
API keys de organización
Se gestionan desde Configuración → API Keys y sirven para llamar a tus agentes desde tus propias aplicaciones a través de la API pública REST de EMMIA (/api/v1).
Cómo crear una API key de organización
- Ve a Configuración → API Keys.
- Haz clic en Nueva key.
- Ingresa un nombre descriptivo (por ejemplo, "Mi App Web") y elige cuándo debe expirar (nunca, 30 días, 90 días o 1 año).
- Haz clic en Crear.
- Copia la key que se muestra — es la única vez que se te mostrará completa.
Cada key generada empieza con el prefijo pk_live_. Para usarla, envíala en la cabecera x-api-key (o como Authorization: Bearer pk_live_...) en cada petición a la API.
Nota: la disponibilidad de la API pública y la cantidad de keys que puedes crear dependen de tu plan. Si tu plan no incluye acceso a la API, verás un aviso para mejorar tu plan antes de poder crear una key.
Revocar una key
Si una key ya no la necesitas o sospechas que se filtró, revócala desde la lista de keys. Las integraciones que la estén usando dejarán de funcionar de inmediato.
API keys por agente
Cada agente tiene su propia pestaña de API Keys (dentro del detalle del agente), donde puedes generar keys específicas para ese agente en particular. Se usan sobre todo para embeber el widget de chat de ese agente en tu sitio web.
- Entra al agente y ve a la pestaña API Keys.
- Escribe un nombre para la key y haz clic en Generar.
- Copia la key mostrada — tampoco se vuelve a mostrar después.
Cuál usar
- Si vas a integrar tus agentes en un sistema propio usando la API REST (
/api/v1) para conversar por código, usa una API key de organización. - Si vas a embeber el widget de chat de un agente específico en tu sitio, usa la API key de ese agente.
Para más detalle sobre cómo llamar a la API pública, revisa Desarrolladores / API.