Frontline Studio · Integrations · Recorrido interactivo

Conectar APIs

Conecta sistemas externos a Frontline con patrones seguros de API y Webhook: payloads explícitos, variables, logs, fallbacks y sin credenciales hardcodeadas.

Recorrido interactivo7 min

API Publica

Usa la nueva Public API para integraciones profundas.

Usala cuando un sistema externo necesita crear, leer, coordinar o reportar sobre recursos de Frontline: agentes, flows/workflows, billing/uso y analitica donde esten soportados.

AgentesWorkflowsAnalyticsBilling/uso

Guia de Academy Abrir docs de la API

Flujo de trabajo builder with routing, Send Message steps, webhook handoff, and Draft or Live controls — Guía de pantallaIntegraciones
Mira Integraciones para ubicar la acción principal, los datos que la sostienen y qué debe revisar el equipo antes de avanzar.

Studio

Conecta esta configuracion con un resultado.

Identifica que se configura, que dato entra, que accion produce y donde se verifica antes de publicarlo.

Integration catalog showing connectors available when built-in tools are a better fit than a custom API call — Catalogo de integracionesConectores para agentes
Mira Integraciones para ubicar la acción principal, los datos que la sostienen y qué debe revisar el equipo antes de avanzar.

Qué vas a construir

Vas a construir un patrón seguro de integración para que un workflow llame un sistema externo o envíe un Outgoing Webhook, luego verifique la respuesta y rutee fallas.

El ejemplo debe usar endpoints placeholder y payloads de muestra. Nunca pongas secretos ni URLs privadas en contenido público de Academy.

Cuándo usarlo

Usa API Call u Outgoing Webhook cuando Frontline necesita información de un sistema externo, debe notificar otra herramienta o debe entregar un evento estructurado después de una decisión de workflow.

Usa primero CRM, Channels, Tables o contexto de agente cuando ya entregan la data necesaria.

API Publica de Frontline

Usa la API Publica de Frontline cuando una integracion necesita acceso programatico a asistentes, flows/workflows, billing/uso o analitica donde este soportado.

Esta pagina mantiene el patron operativo de alto nivel. Para endpoints, parametros, autenticacion y ejemplos de request, abre la referencia publica de Redocly: https://frontline-public-api.redocly.app/api.

Frontline CLI

Si el trabajo de integracion vive en terminal o scripts, revisa el paquete @getfrontline/cli en npm: https://www.npmjs.com/package/@getfrontline/cli/.

El CLI instala los binarios frontline y max para comandos de Public API, perfiles, salida JSON y flujos de Max.

Como elegir

Usa API Call u Outgoing Webhook cuando una ejecucion de workflow necesita llamar o notificar otro sistema.

Usa Public API o CLI cuando un sistema externo, script o developer necesita operar sobre recursos de Frontline fuera de una ejecucion puntual.

Antes de empezar

Confirma owner del sistema externo, endpoint, method, patrón de autenticación, request payload, campos de response, rate limits, timeout y ruta de fallback.

Guarda credenciales en el mecanismo de secretos o variables aprobado por el workspace. Los ejemplos públicos deben usar placeholders como {{apiKey}} o {{externalRecordId}}.

Implementación paso a paso

Abre Studio y el workflow que necesita la integración.

Agrega o inspecciona un nodo API Call u Outgoing Webhook según la dirección de la integración.

Mapea variables del workflow en campos del request en lugar de hardcodear valores específicos de clientes.

Mapea campos del response al siguiente paso del workflow solo después de confirmar la forma esperada.

Agrega una rama de falla para timeout, response no 2xx, campo faltante, credencial revocada o rate limit.

Ejecuta el workflow con un payload de muestra e inspecciona Logs antes de habilitar más tráfico.

Cómo verificar que funcionó

La ejecución de muestra debe mostrar request payload, response sanitizado, decisión de rama, acción posterior y manejo de error en Logs.

Un workflow que depende de una API no está listo para lanzamiento hasta que la rama de falla sea tan clara como la de éxito.

Errores comunes

No hardcodees tokens, API keys, bearer strings, IDs de clientes ni URLs privadas en nodos de workflow o ejemplos de Academy.

No asumas que la respuesta externa siempre trae el campo que necesitas.

No omitas logs; las integraciones fallan de maneras que los operadores necesitan ver.

Solución de problemas

Si falla la API Call, revisa endpoint, method, variable de auth, body del request, timeout y código de response.

Si el siguiente nodo recibe data vacía, verifica mapeo del response y nombres de campos en Logs.

Si los retries crean duplicados, agrega idempotency o lookup antes de acciones de escritura.

Flujos relacionados

Construye un workflow para controlar cuándo corre la integración y cómo se rutean errores.

Crea una tabla cuando la integración necesita datos locales de referencia para ruteo o mapeo.

Siguiente paso claro

Crea una ejecución API de muestra con valores placeholder, verifica logs de éxito y falla, y documenta el owner de la credencial antes de pasar el workflow a Live.

Transcripción

Abrir transcripción buscable

Conecta sistemas externos a Frontline con patrones seguros de API y Webhook: payloads explícitos, variables, logs, fallbacks y sin credenciales hardcodeadas. Qué vas a construir Vas a construir un patrón seguro de integración para que un workflow llame un sistema externo o envíe un Outgoing Webhook, luego verifique la respuesta y rutee fallas. El ejemplo debe usar endpoints placeholder y payloads de muestra. Nunca pongas secretos ni URLs privadas en contenido público de Academy. Cuándo usarlo Usa API Call u Outgoing Webhook cuando Frontline necesita información de un sistema externo, debe notificar otra herramienta o debe entregar un evento estructurado después de una decisión de workflow. Usa primero CRM, Channels, Tables o contexto de agente cuando ya entregan la data necesaria. Antes de empezar Confirma owner del sistema externo, endpoint, method, patrón de autenticación, request payload, campos de response, rate limits, timeout y ruta de fallback. Guarda credenciales en el mecanismo de secretos o variables aprobado por el workspace. Los ejemplos públicos deben usar placeholders como {{apiKey}} o {{externalRecordId}}. Implementación paso a paso Abre Studio y el workflow que necesita la integración. Agrega o inspecciona un nodo API Call u Outgoing Webhook según la dirección de la integración. Mapea variables del workflow en campos del request en lugar de hardcodear valores específicos de clientes. Mapea campos del response al siguiente paso del workflow solo después de confirmar la forma esperada. Agrega una rama de falla para timeout, response no 2xx, campo faltante, credencial revocada o rate limit. Ejecuta el workflow con un payload de muestra e inspecciona Logs antes de habilitar más tráfico. Cómo verificar que funcionó La ejecución de muestra debe mostrar request payload, response sanitizado, decisión de rama, acción posterior y manejo de error en Logs. Un workflow que depende de una API no está listo para lanzamiento hasta que la rama de falla sea tan clara como la de éxito. Errores comunes No hardcodees tokens, API keys, bearer strings, IDs de clientes ni URLs privadas en nodos de workflow o ejemplos de Academy. No asumas que la respuesta externa siempre trae el campo que necesitas. No omitas logs; las integraciones fallan de maneras que los operadores necesitan ver. Solución de problemas Si falla la API Call, revisa endpoint, method, variable de auth, body del request, timeout y código de response. Si el siguiente nodo recibe data vacía, verifica mapeo del response y nombres de campos en Logs. Si los retries crean duplicados, agrega idempotency o lookup antes de acciones de escritura. Flujos relacionados Construye un workflow para controlar cuándo corre la integración y cómo se rutean errores. Crea una tabla cuando la integración necesita datos locales de referencia para ruteo o mapeo. Siguiente paso claro Crea una ejecución API de muestra con valores placeholder, verifica logs de éxito y falla, y documenta el owner de la credencial antes de pasar el workflow a Live.

Preguntas frecuentes

¿Dónde deberían vivir las credenciales?

Usa el mecanismo de secretos o variables aprobado por el workspace. No hardcodees secretos en nodos de workflow ni contenido de Academy.

¿Debo publicar URLs privadas en docs?

No. Los ejemplos públicos de Academy deben usar placeholders y descripciones sanitizadas de endpoints.

¿Cómo hago confiables los workflows con API?

Valida payloads, mapea responses explícitamente, agrega ramas de falla, inspecciona logs y evita escrituras duplicadas.