Despliega chat de servidor a servidor, transmite tokens en tiempo real a tu propia interfaz y dispara automatizaciones desde webhooks que terminan en tu host de FlexyAgents. Las rutas que aparecen a continuación son los manejadores reales de Next.js: copia los valores desde Despliegue tras generar la conexión a la API de FlexyAgents.
¿Necesitas claves antes? Crea un espacio de trabajo y abre Configuración → Claves de API o el modal de conexión del agente.
Superficies HTTP de un vistazo
Las rutas reflejan el árbol de rutas de Next.js. Sustituye los marcadores por el ID del agente y el host de tu pantalla de despliegue.
Envía un cuerpo JSON con un array messages (rol + contenido) y el flag stream opcional. Bearer valida contra la clave API de FlexyAgents guardada en la conexión del agente; con clave correcta se resuelve la organización automáticamente.
Las automatizaciones publicadas pueden exponer URLs webhook que deserializan payloads y llaman a executeAutomation—útil cuando tus servicios deben iniciar flujos sin OAuth.
Rutas hermanas bajo /api/webhooks gestionan WhatsApp, Instagram, Facebook Messenger, email entrante y callbacks similares para que el despliegue omnicanal quede en tu dominio.
Configura webhooks salientes firmados desde el panel cuando quieras que FlexyAgents envíe eventos de conversación o del sistema a tu SIEM, data lake o puente con ticketing.
Llamada mínima sin transmisión en tiempo real
curl -X POST "https://TU_HOST_APP/api/agents/ID_AGENTE/chat" \
-H "Authorization: Bearer TU_CLAVE_API_FLEXYAGENTS" \
-H "Content-Type: application/json" \
-d '{"messages":[{"role":"user","content":"Hola"}],"stream":false}'Sustitúyelos por los valores copiados de Despliegue → API tras conectar la aplicación de FlexyAgents en ese agente.
Invocar
La pantalla de despliegue copia un curl contra tu host en vivo. El handler valida claves API con el almacén de conexiones de automatización, carga comportamiento + conocimiento e incrementa uso como cualquier otro canal.
El cuerpo debe incluir al menos un turno de chat. El ejecutor recorta el historial al último mensaje de usuario para la recuperación pero acepta arrays multi-turno para uso futuro.
Con stream: true recibes fragmentos NDJSON (un objeto JSON por línea) que el frontend puede volcar en UI a medida que llegan tokens.
Las cuentas de servicio deben usar la clave de conexión FlexyAgents generada por agente. Las pruebas interactivas pueden usar sesión del panel, pero servidor a servidor siempre Bearer.
Límites con Redis devuelven 429 ante picos. El plan añade MESSAGE_LIMIT_REACHED para cupos mensuales alojados/BYOK y techos de tokens en inferencia alojada.
Eventos
Las rutas entrantes normalizan firmas de vendor mientras la configuración saliente vive junto al resto de integraciones. Las automatizaciones también pueden POST HTTP arbitrario dentro de un flujo.
Cuando un flujo publica un disparador webhook, FlexyAgents guarda el segmento de ruta y verifica payloads antes de llamar a executeAutomation con el cuerpo parseado.
WhatsApp, Instagram DM, Messenger y email entrante registran endpoints HTTPS públicos para que Meta, Twilio o el correo verifiquen y entreguen eventos.
Las acciones de automatización pueden POST o PUT a URLs del cliente con cuerpos plantillados—p.ej. “notificar Opsgenie” o “crear ticket Jira” sin esperar conector de primera parte.
Referencia
Las páginas de marketing son narrativas; los ingenieros deben apoyarse en /docs, definiciones OpenAPI en el repo y los snippets de despliegue que siempre coinciden con tus IDs de tenant.
Empieza en /docs con guías conceptuales y enlaza a /api para inicios rápidos, primers de autenticación y referencias en pestañas cuando existan.
El repositorio incluye OpenAPI completo con esquemas de auth, payloads de chat y recursos REST auxiliares—genera clientes o importa a Postman desde ese archivo.
No toda experiencia necesita REST crudo—el script embebido llama al mismo endpoint de chat con contexto de visitante. Combina API con widget para autoservicio web y jobs backend.
Combina las APIs con Automatizaciones, Canales y gobernanza en Estadísticas.
Siguiente paso
Genera la clave de conexión de FlexyAgents, pégala en tu almacén de secretos y apunta los webhooks de automatización a las rutas que controlas. Cuando estés listo, conecta la observabilidad al mismo espacio de estadísticas que ya usa tu equipo de éxito de cliente.