Skip to main content

​
Visión general

El Canal API EventStream permite que aplicaciones externas interactúen con los asistentes de Inagent mediante una API REST. Las respuestas del asistente se reciben por Server-Sent Events (SSE), por lo que el cliente puede procesar mensajes y estados en tiempo real a medida que se generan.
Usa este canal cuando necesites iniciar sesiones desde una aplicación propia, enviar mensajes a un asistente, escuchar eventos en streaming, reconectarte a una sesión existente o cerrarla desde tu backend.

​
Dominios disponibles

​
Base URL

Ejemplos:
  • USA: https://api.backend.us1.inconcert.cloud/assistants-channel/api/v1/channel
  • Global: https://api.backend.inconcertcc.com/assistants-channel/api/v1/channel

​
Autenticación

Todos los endpoints requieren una API Key enviada en el header HTTP apikey.
​
string
required
Clave de acceso proporcionada para tu integración.
Las peticiones sin una API Key válida serán rechazadas por el gateway. No incluyas esta credencial en código cliente, repositorios, logs ni ejemplos compartidos.

​
Flujo típico

  1. Crea la sesión con el endpoint Init.
  2. Conserva el sessionId y el consumerId recibidos en el evento Initialized.
  3. Envía mensajes con Talk usando esos identificadores.
  4. Procesa la respuesta del asistente desde el stream SSE abierto.
  5. Cierra la sesión con Destroy cuando termine la conversación.

​
Endpoints del canal

Crear sesión

Abre una sesión de inferencia y recibe los eventos mediante SSE.

Enviar mensaje

Envía texto del usuario a una sesión activa.

Escuchar sesión

Conecta un nuevo consumer al stream de una sesión existente.

Destruir sesión

Finaliza una sesión activa y cierra sus recursos asociados.

​
Eventos SSE

Los endpoints Init y Listen devuelven un stream con Content-Type: text/event-stream. Cada evento sigue el formato estándar SSE:

​
Eventos de conexión

​
Eventos de conversación

​
Eventos de herramientas

​
Eventos de modificadores

​
Eventos de estado

​
Reconexión

Si el servidor necesita reiniciarse, enviará el evento reconnect_required antes de cerrar la conexión. El cliente puede reconectarse con Listen usando el sessionId de la sesión previa.
Conserva el sessionId en tu aplicación mientras la conversación esté activa. Esto permite reconectar listeners sin iniciar una sesión nueva.

​
Límite de sesiones

El canal aplica control de sesiones simultáneas por tenant. Si se alcanza el límite configurado, el endpoint Init responde con HTTP 429.