Skip to main content
La API de Automatizaciones te permite definir flujos con pasos ordenados, activarlos por webhook, cron o eventos de registros, publicar versiones y revisar cada ejecución. En las rutas de la API, las automatizaciones se identifican como workflows.

​
Flujo recomendado

1

Crea la automatización

Define el nombre, el trigger y al menos un paso.
2

Publica una versión

La publicación crea una instantánea inmutable que usarán las ejecuciones.
3

Actívala

Solo las automatizaciones enabled y publicadas aceptan disparos.
4

Dispara, programa o espera un evento

Usa el webhook público, trigger-now para probar un cron, o crea o actualiza un registro del tablero configurado.
5

Revisa ejecuciones

Consulta el listado de runs y el detalle de cada paso.

​
Identificadores

Trata secret como una credencial. No lo expongas en repositorios, tickets ni capturas.

​
Triggers

Para los triggers de registros, obtén primero el databaseId con Listar tableros. La automatización debe estar publicada y activa cuando ocurra el evento.

​
Acciones de paso

Para pasar datos del trigger y entre pasos, usa plantillas {{steps.N.output.*}}, capture y {{context.*}}. Empieza por Variables y contexto (incluye ejemplos completos) y el catálogo de Tipos de paso.

​
Autenticación

Las operaciones de administración usan tu API key:
El disparo de webhook no usa API key: la autenticación es el secret en la URL. Consulta Autenticación si todavía no tienes una clave.

​
Operaciones

Listar automatizaciones

Recorre automatizaciones con paginación por cursor.

Crear automatización

Define trigger y pasos en borrador.

Consultar automatización

Obtén el borrador o la versión publicada.

Actualizar automatización

Modifica el borrador antes de publicar.

Publicar

Crea una versión inmutable.

Activar / desactivar

Controla si acepta nuevos disparos.

Disparar webhook

Encola una ejecución con un POST público.

Ejecutar ahora (cron)

Prueba una automatización programada de inmediato.

Versiones

Consulta el historial de publicaciones.

Ejecuciones

Revisa runs y el detalle de cada paso.

Tipos de paso

Navegador, JavaScript, HTTP, Esperar y cómo pasar variables.

Usar navegador

Ejecuta una tarea web y devuelve un output JSON reutilizable.

Paso JavaScript

Objetos disponibles, buenos y malos ejemplos.

Listar automatizaciones

Recorre las automatizaciones de tu cuenta con paginación por cursor.

Crear automatización

Crea una automatización en borrador con trigger webhook, cron o evento de registro y uno o más pasos.

Consultar automatización

Obtén el borrador de una automatización o su versión publicada.

Actualizar automatización

Actualiza el borrador de una automatización. Los cambios no afectan ejecuciones hasta publicar.

Publicar automatización

Publica el borrador actual como una versión inmutable.

Activar automatización

Marca una automatización como enabled para aceptar disparos.

Desactivar automatización

Marca una automatización como disabled para dejar de aceptar nuevos disparos.

Eliminar automatización

Elimina una automatización para que deje de aparecer en listados y deje de aceptar disparos.

Disparar webhook

Encola una ejecución enviando un POST a la URL pública del webhook.

Ejecutar ahora (cron)

Encola de inmediato una ejecución de una automatización con trigger cron.

Listar versiones

Consulta el historial de versiones publicadas de una automatización.

Consultar versión

Obtén una versión publicada específica de una automatización.

Listar ejecuciones

Recorre las ejecuciones de una automatización con filtros y paginación por cursor.

Consultar ejecución

Obtén el estado y metadatos de una ejecución específica.

Listar pasos de una ejecución

Consulta la entrada, salida y estado de cada paso de una ejecución.

Pasos

Variables y contexto

Cómo pasar datos del trigger y entre pasos con plantillas, output, capture y context.

Paso Agente IA: investigar la web

Un agente de IA autónomo ejecuta una tarea en la web y devuelve un output JSON estructurado para los pasos siguientes.

Paso Agente IA: automatizar portal

Un agente de IA sigue tu guion en un navegador en la nube: login, portales y descargas.

Paso JavaScript

Ejecuta código JavaScript en sandbox: input, output, objetos disponibles y ejemplos.

Paso HTTP

Realiza una solicitud HTTP saliente desde una automatización.

Paso Esperar

Pausa una automatización por una duración o hasta una fecha y hora.