Skip to main content
La API de Automatizaciones te permite definir flujos con pasos ordenados, publicarlos y activarlos. Un flujo se dispara por webhook, cron, correo de Gmail o un evento de registro, y cada corrida queda consultable. En las rutas de la API, las automatizaciones se identifican como workflows.

​
Flujo recomendado

1

Crea la automatización

En Definición, indica el nombre, el trigger y al menos un paso.
2

Publica una versión

Publicar crea una instantánea inmutable. Las ejecuciones usan esa versión, no el borrador.
3

Actívala

Solo las automatizaciones publicadas y enabled aceptan disparos. El control está en Publicación.
4

Dispara el flujo

Según el trigger: webhook, cron, correo de Gmail o un registro del tablero. El detalle está en Disparos.
5

Revisa la ejecución

En Ejecuciones consultas el run y el resultado de cada paso.

​
Identificadores

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

​
Triggers

El tipo se define en el borrador. La referencia completa, con los endpoints para lanzar un webhook o un cron, está en Disparos. 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.

​
Secciones

Definición

Crea, consulta, actualiza y elimina el borrador.

Publicación

Publica una versión y actívala o desactívala.

Versiones

Consulta el historial de publicaciones.

Disparos

Webhook, cron, correo de Gmail y eventos de registro.

Ejecuciones

Revisa cada corrida y el resultado de sus pasos.

Pasos

Gmail, navegador, JavaScript, HTTP, Esperar y archivos entre pasos.

Definición

Listar automatizaciones

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

Crear automatización

Crea una automatización con trigger webhook, cron, Gmail 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.

Eliminar automatización

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

Publicación

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.

Versiones

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.

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.

Trigger de correo Gmail

Inicia una automatización cuando llega un correo a una cuenta Gmail conectada.

Ejecuciones

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.

Archivos entre pasos

Crea, consulta y reutiliza PDF, JSON, XML, hojas de cálculo y otros archivos dentro de una automatización.

Enviar correo con Gmail

Envía un correo con el paso gmail.send o con gmail.send() en un paso JavaScript. El mensaje es el mismo; cambia dónde va la cuenta y cómo pasas los datos.

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 Criterio IA

Convierte texto libre en decisiones tipadas: una categoría, una calificación o un sí/no, cada una con su probabilidad.

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.