Tipos de paso - Insurance Boosters API

Cada automatización es una secuencia ordenada de pasos. El actionKey define qué hace el paso; los demás campos dependen del tipo de acción.

Flujo de datos entre pasos

El trigger entrega un payload (trigger.body, y opcionalmente headers/query).
Antes de ejecutar un paso, la API resuelve plantillas {{...}} dentro de su input o, para browser.use, dentro de task.
El paso produce un output.
Con capture puedes copiar campos del resultado a context para reutilizarlos después.

Lee Variables y contexto antes de armar pasos complejos: ahí hay ejemplos completos de pasar variables entre pasos con steps.N.output y con capture/context.

Mini ejemplo: salida del paso 0 → entrada del paso 1

{
  "steps": [
    {
      "name": "Normalizar",
      "actionKey": "code.javascript",
      "input": { "referencia": "{{trigger.body.referencia}}" },
      "code": "output = { referencia: String(input.referencia || '').trim() };"
    },
    {
      "name": "Notificar",
      "actionKey": "http.request",
      "input": {
        "method": "POST",
        "url": "https://ejemplo.com/hooks/pago",
        "headers": { "Content-Type": "application/json" },
        "body": { "referencia": "{{steps.0.output.referencia}}" }
      }
    }
  ]
}

Guías por tipo de paso

Guía	`actionKey`	Cuándo usarla
Enviar correo con Gmail	`gmail.send`	Enviar texto, HTML o adjuntos desde una cuenta Gmail conectada.
Agente IA: investigar la web	`browser.use`	Un agente autónomo investiga la web, interactúa con páginas dinámicas o descarga archivos.
Agente IA: automatizar portal	`browser.script`	Un agente sigue tu guion en un portal conocido: login, reportes, descargas (RPA).
Criterio IA	`decision.evaluate`	Clasificar texto libre, calificarlo en una escala o responder un sí/no para decidir a dónde sigue el flujo.
Agente de IA: Emisión RC Profesional en GNP	`gnp.issue-policy-rc-professional`	Cotizar RC Profesional y emitir únicamente con confirmación explícita.
Agente de IA: Reporte de pólizas y recibos pendientes en GNP	`gnp.pending-receipts`	Exportar de GNP el reporte completo de cobranza pendiente, ya limpio y con el XLSX original.
Agente de IA: PDFs de recibos pendientes en GNP	`gnp.receipt-documents`	Descargar los PDF de los recibos pendientes de las pólizas indicadas.
Ejecutar JavaScript	`code.javascript`	Transformar datos, validar, orquestar llamadas, consultar MySQL/SFTP, enviar o leer correos Gmail, analizar adjuntos y terminar la automatización.
Solicitud HTTP	`http.request`	Llamar un endpoint externo con método, URL, headers y body.
Esperar	`system.delay`	Pausar por una duración o hasta una fecha/hora.

Anatomía de un paso

{
  "name": "Normalizar referencia",
  "actionKey": "code.javascript",
  "input": {
    "referencia": "{{trigger.body.referencia}}"
  },
  "code": "output = { referencia: String(input.referencia || '').trim() };",
  "capture": {
    "referencia": {
      "from": "response.body",
      "path": "referencia"
    }
  }
}

Campo	Descripción
`name`	Etiqueta legible (opcional, recomendada).
`actionKey`	Tipo de acción.
`input`	Datos del paso. Acepta plantillas `{{...}}`.
`task`	Solo en `browser.use`: instrucción para el navegador. Acepta plantillas `{{...}}`.
`resultSchema`	Solo en `browser.use`: JSON Schema del output esperado.
`wait`	Solo en `browser.use`: retraso inicial, intervalo de consulta y timeout total.
`code`	En `code.javascript` y `browser.script`: el script a ejecutar.
`credentialId`	En pasos nativos de GNP: credencial del portal perteneciente al tenant.
`capture`	Copia campos del resultado a `context`.
`timeoutMs`	Límite opcional de tiempo del paso.

Los pasos se ejecutan en orden. Para que una automatización tome un camino distinto según el contenido de un dato, usa Criterio IA para obtener la decisión y luego actúa sobre ella con {{steps.N.output.*}} en los pasos siguientes.

Siguiente paso

Enviar con Gmail

Correos de texto, HTML y adjuntos desde una credencial OAuth.

Usar navegador

Tareas web, schemas de resultado, wait y archivos.

Decidir con Criterio IA

Clasificar, calificar y decidir a dónde sigue el flujo.

Agente de IA para cobranza GNP

Reporte completo de pólizas y recibos pendientes, ya limpio.

Emitir RC Profesional en GNP

Cotización segura y emisión con confirmación explícita.

Variables y contexto

Cómo pasar datos del trigger y entre pasos.

Archivos entre pasos

Cómo crear y reutilizar PDF, JSON, XML y otros archivos.

Ejecutar JavaScript

Objetos disponibles, input/output y ejemplos.

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.

​Flujo de datos entre pasos

​Mini ejemplo: salida del paso 0 → entrada del paso 1

​Guías por tipo de paso

​Anatomía de un paso

​Siguiente paso

Enviar con Gmail

Usar navegador

Decidir con Criterio IA

Agente de IA para cobranza GNP

Emitir RC Profesional en GNP

Variables y contexto

Archivos entre pasos

Ejecutar JavaScript

Flujo de datos entre pasos

Mini ejemplo: salida del paso 0 → entrada del paso 1

Guías por tipo de paso

Anatomía de un paso

Siguiente paso