Iniciar una automatización

Inicia una automatización publicada para un contacto. Hace lo mismo que el botón "Iniciar automatización" del chat en la app: el contacto entra al flujo desde el principio y el flujo puede enviarle mensajes.

El flujo puede enviar mensajes reales al contacto. El comando pide confirmación; en scripts y agentes de IA necesita --yes.

bash

01plazbot automations start <automationId> -c <contactId> [options]

Parámetros

Parámetro	Flag	Requerido	Descripción
Automatización	`<automationId>`	Sí	ID de la automatización (`aut_...`). Tiene que estar publicada.
Contacto	`-c, --contact <contactId>`	Sí	Contacto que entra al flujo (`con_...`).
Confirmar	`-y, --yes`	No	Omite la confirmación (para scripts y CI).
Workspace	`-w, --workspace <id>`	No	Workspace donde se ejecuta. Por defecto, el activo.
Zona	`-z, --zone <zone>`	No	`LA` o `EU`. Por defecto, la zona de la sesión.
JSON	`--json`	No	Imprime el resultado como JSON.

Antes de iniciarla, revisa con plazbot automations state si el contacto ya está dentro de otro flujo.

Ejemplos

bash

01# Iniciar un flujo para un contacto (pide confirmación)
02plazbot automations start aut_AbcDef123 -c con_AbcDef123
03 
04# Desde un script
05plazbot automations start aut_AbcDef123 -c con_AbcDef123 --yes --json
06 
07# Seguir al contacto dentro del flujo
08plazbot automations state con_AbcDef123

Resultado

text

01? Start automation aut_AbcDef123 for contact con_AbcDef123? The flow may send messages. Yes
02 
03  Automation aut_AbcDef123 started for con_AbcDef123
04  Follow it with: plazbot automations state con_AbcDef123

Salida JSON

Con --json imprime la respuesta de la API (POST /api/automation/start-automation):

json

01{
02  "success": true,
03  "code": 200,
04  "message": "..."
05}

Errores comunes

Mensaje	Causa	Solución
`You are not signed in.`	No hay sesión.	Ejecuta `plazbot login`.
`Missing --contact.`	No pasaste el contacto.	Agrega `-c con_...`.
`this automation is not published.`	La automatización está en borrador.	Publícala en la app antes de iniciarla.
`No automation founded.`	El ID de la automatización no existe.	Revisa el ID con `plazbot automations list`.
`Contact not founded.`	El contacto no existe en el workspace del flujo.	Revisa el ID con `plazbot contacts search`.
`This action needs confirmation and there is no interactive terminal.`	Se ejecutó sin terminal y sin `--yes`.	Agrega `--yes`.