Autenticación

Seredina tiene dos mecanismos de autenticación completamente separados, para dos audiencias distintas — no los confundas entre sí.

API Keys — para integraciones (lo que necesitas)

Si estás integrando algo externo (un formulario de contacto, tu propio monitoreo, un script), esto es lo que quieres. Las claves de API autentican contra los endpoints públicos del canal API y de ingesta de alertas (/v1/tickets, /v1/alerts, /v1/alerts/grafana) — nunca contra la consola de agentes.

Crear una clave

Desde la consola: Ajustes → Claves de API → Nueva clave. El valor completo (con prefijo sk_) se muestra una sola vez al crearla — Seredina solo guarda su hash, nunca el valor en texto plano, así que si lo pierdes hay que generar una clave nueva.

Usarla

bash

curl -X POST https://tu-instancia.example.com/v1/tickets \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "subject": "No puedo acceder a mi cuenta",
    "body": "Intenté resetear la contraseña tres veces.",
    "contactEmail": "cliente@example.com",
    "contactName": "Ana Cliente"
  }'

La clave identifica el tenant automáticamente — no hace falta mandar un tenantId en el body, el servidor lo resuelve a partir del hash de la clave.

Revocar una clave

Desde el mismo lugar donde la creaste — Ajustes → Claves de API. Una clave revocada deja de funcionar de inmediato; cualquier integración que la use empieza a recibir 401.

Sesión de agente (JWT) — para la consola web

Cuando un agente inicia sesión en la consola (POST /auth/login), recibe un token JWT de corta duración que el navegador guarda y manda en cada request subsecuente. Este token es para la consola web, no para integraciones externas — no está pensado para ser usado por un script de terceros, y sus permisos dependen del rol del agente (ver Administración en la guía de usuario para roles y permisos).

Próximos pasos

API REST — los endpoints públicos que una API Key puede llamar, en detalle.
Webhooks salientes — la dirección contraria: Seredina notificándote a ti cuando algo pasa.
Servidor MCP — para conectar tu propio agente de IA (Claude Desktop, un flujo de n8n, un script) contra el mismo catálogo de herramientas que usa el copiloto.
Widget embebible — un <script> que convierte cualquier sitio web en un canal de chat hacia Seredina.

Autenticación ​

API Keys — para integraciones (lo que necesitas) ​

Crear una clave ​

Usarla ​

Revocar una clave ​

Sesión de agente (JWT) — para la consola web ​

Próximos pasos ​