Triggers - Insurance Boosters API

Un trigger es el evento que inicia una automatización. Por ejemplo: una llamada HTTP, una hora programada, un registro nuevo o una respuesta de WhatsApp Flow. La automatización debe estar publicada y activa cuando ocurra el evento.

Orden recomendado

Crea la automatización con status: "disabled".
Configura el trigger y los pasos.
Publica una versión.
Activa la automatización.

Activar antes de publicar no crea una automatización ejecutable. Si creas con status: "enabled", comenzará a aceptar eventos en cuanto publiques la primera versión. Para evitar comportamientos distintos entre tipos de trigger, desactiva la automatización antes de editarla. Después publica la nueva versión y vuelve a activarla. Las respuestas de WhatsApp Flow usan la versión publicada; otros triggers pueden recalcular su selección o programación al guardar el borrador.

Tipos disponibles

Tipo	Configuración	Cuándo se dispara
`webhook`	`type`	Cuando llamas la URL pública de la automatización.
`cron`	`type`, `cron`, `timezone`	Según la programación configurada.
`database_record_created`	`type`, `databaseId`	Al crear un registro en el tablero seleccionado.
`database_record_updated`	`type`, `databaseId`	Al cambiar los campos o permisos de acceso de un registro.
`contact_created`	`type`	Al crear un contacto.
`contact_updated`	`type`	Al actualizar un contacto.
`whatsapp_flow_submission`	`type`, `flowId`	Cuando un contacto completa el WhatsApp Flow seleccionado.

Elige un trigger

Webhook

Inicia una automatización enviando una solicitud HTTP.

Programación

Ejecuta una automatización en días y horas definidos.

Registro creado

Reacciona cuando se agrega un registro a un tablero.

Registro actualizado

Reacciona cuando cambia un registro de un tablero.

Contacto creado

Inicia una automatización al crear un contacto.

Contacto actualizado

Inicia una automatización al actualizar un contacto.

Respuesta de WhatsApp Flow

Procesa los datos enviados al completar un WhatsApp Flow.

Reintentos e idempotencia

Evita efectos duplicados al llamar servicios externos.

Datos disponibles

Antes de ejecutar el primer paso, la plataforma guarda los datos del evento en trigger.body. Cada tipo de trigger entrega una estructura diferente:

Trigger	Ruta principal
Webhook	`{{trigger.body}}`
Programación	`{{trigger.body.firedAt}}`
Registro creado/actualizado	`{{trigger.body.record}}`
Contacto creado/actualizado	`{{trigger.body.contact}}`
Respuesta de WhatsApp Flow	`{{trigger.body.submission.data}}`

Los triggers de programación, registros y contactos usan timestamps Unix en milisegundos. La respuesta de WhatsApp Flow usa una fecha ISO 8601 en occurredAt. Para pasar estos valores a un paso, consulta Variables y contexto.

​Orden recomendado

​Tipos disponibles

​Elige un trigger