> ## Documentation Index
> Fetch the complete documentation index at: https://developers.insuranceboosters.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Automatizaciones

> Crea automatizaciones por webhook, programación o eventos de registros, publícalas y consulta sus ejecuciones.

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

<Steps>
  <Step title="Crea la automatización">
    Define el nombre, el trigger y al menos un paso.
  </Step>

  <Step title="Publica una versión">
    La publicación crea una instantánea inmutable que usarán las ejecuciones.
  </Step>

  <Step title="Actívala">
    Solo las automatizaciones `enabled` y publicadas aceptan disparos.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Revisa ejecuciones">
    Consulta el listado de runs y el detalle de cada paso.
  </Step>
</Steps>

## Identificadores

| Identificador | Uso                                                         |
| ------------- | ----------------------------------------------------------- |
| `workflowId`  | Identifica la automatización.                               |
| `versionId`   | Identifica una versión publicada.                           |
| `runId`       | Identifica una ejecución.                                   |
| `secret`      | Secreto del trigger webhook; forma parte de la URL pública. |

<Warning>
  Trata `secret` como una credencial. No lo expongas en repositorios, tickets ni capturas.
</Warning>

## Triggers

| Tipo                      | Cómo se dispara                                                                                                |
| ------------------------- | -------------------------------------------------------------------------------------------------------------- |
| `webhook`                 | `POST /webhooks/{workflowId}/{secret}` con el body que quieras reutilizar en los pasos.                        |
| `cron`                    | Según la expresión cron y zona horaria, o de inmediato con `POST /workflows/{workflowId}/trigger-now`.         |
| `database_record_created` | Automáticamente cuando se crea un registro en el tablero indicado por `databaseId`.                            |
| `database_record_updated` | Automáticamente cuando cambian los campos o el alcance de un registro en el tablero indicado por `databaseId`. |

Para los triggers de registros, obtén primero el `databaseId` con [Listar tableros](/tableros/listar-tableros). La automatización debe estar publicada y activa cuando ocurra el evento.

## Acciones de paso

| `actionKey`       | Qué hace                                                                        | Guía                                                                 |
| ----------------- | ------------------------------------------------------------------------------- | -------------------------------------------------------------------- |
| `browser.use`     | Un agente de IA autónomo navega la web y devuelve JSON estructurado y archivos. | [Agente IA: investigar la web](/automatizaciones/paso-navegador)     |
| `browser.script`  | Un agente de IA sigue tu guion en un portal: login, reportes, descargas.        | [Agente IA: automatizar portal](/automatizaciones/paso-agente-guion) |
| `system.delay`    | Espera una duración o hasta una fecha/hora.                                     | [Esperar](/automatizaciones/paso-esperar)                            |
| `http.request`    | Llama a una URL externa (`method`, `url`, `headers`, `body`).                   | [HTTP](/automatizaciones/paso-http)                                  |
| `code.javascript` | Ejecuta JavaScript en sandbox (`input` → `output`).                             | [JavaScript](/automatizaciones/paso-javascript)                      |

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

## Autenticación

Las operaciones de administración usan tu API key:

```http theme={null}
x-ib-api-key: <tu-api-key>
```

El disparo de webhook **no** usa API key: la autenticación es el `secret` en la URL.

Consulta [Autenticación](/autenticacion) si todavía no tienes una clave.

## Operaciones

<Columns cols={2}>
  <Card title="Listar automatizaciones" icon="list" href="/automatizaciones/listar-automatizaciones">
    Recorre automatizaciones con paginación por cursor.
  </Card>

  <Card title="Crear automatización" icon="plus" href="/automatizaciones/crear-automatizacion">
    Define trigger y pasos en borrador.
  </Card>

  <Card title="Consultar automatización" icon="search" href="/automatizaciones/consultar-automatizacion">
    Obtén el borrador o la versión publicada.
  </Card>

  <Card title="Actualizar automatización" icon="pencil" href="/automatizaciones/actualizar-automatizacion">
    Modifica el borrador antes de publicar.
  </Card>

  <Card title="Publicar" icon="upload" href="/automatizaciones/publicar-automatizacion">
    Crea una versión inmutable.
  </Card>

  <Card title="Activar / desactivar" icon="power" href="/automatizaciones/activar-automatizacion">
    Controla si acepta nuevos disparos.
  </Card>

  <Card title="Disparar webhook" icon="webhook" href="/automatizaciones/disparar-webhook">
    Encola una ejecución con un POST público.
  </Card>

  <Card title="Ejecutar ahora (cron)" icon="play" href="/automatizaciones/ejecutar-ahora">
    Prueba una automatización programada de inmediato.
  </Card>

  <Card title="Versiones" icon="git-branch" href="/automatizaciones/listar-versiones">
    Consulta el historial de publicaciones.
  </Card>

  <Card title="Ejecuciones" icon="history" href="/automatizaciones/listar-ejecuciones">
    Revisa runs y el detalle de cada paso.
  </Card>

  <Card title="Tipos de paso" icon="blocks" href="/automatizaciones/tipos-de-paso">
    Navegador, JavaScript, HTTP, Esperar y cómo pasar variables.
  </Card>

  <Card title="Usar navegador" icon="globe" href="/automatizaciones/paso-navegador">
    Ejecuta una tarea web y devuelve un output JSON reutilizable.
  </Card>

  <Card title="Paso JavaScript" icon="code" href="/automatizaciones/paso-javascript">
    Objetos disponibles, buenos y malos ejemplos.
  </Card>
</Columns>