# Iniciar una automatización

> plazbot automations start: mete a un contacto en un flujo publicado, igual que el botón del chat.

Fuente: https://developers.plazbot.com/cli/automations/start/

### 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.

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

```bash
plazbot 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`](https://developers.plazbot.com/cli/automations/state) si el contacto ya está dentro de otro flujo.

### Ejemplos

```bash
# Iniciar un flujo para un contacto (pide confirmación)
plazbot automations start aut_AbcDef123 -c con_AbcDef123

# Desde un script
plazbot automations start aut_AbcDef123 -c con_AbcDef123 --yes --json

# Seguir al contacto dentro del flujo
plazbot automations state con_AbcDef123
```

### Resultado

```text
? Start automation aut_AbcDef123 for contact con_AbcDef123? The flow may send messages. Yes

Automation aut_AbcDef123 started for con_AbcDef123
Follow it with: plazbot automations state con_AbcDef123
```

### Salida JSON

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

```json
{
"success": true,
"code": 200,
"message": "..."
}
```

### Errores comunes

| Mensaje | Causa | Solución |
|---------|-------|----------|
| `You are not signed in.` | No hay sesión. | Ejecuta [`plazbot login`](https://developers.plazbot.com/cli/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`](https://developers.plazbot.com/cli/automations/list). |
| `Contact not founded.` | El contacto no existe en el workspace del flujo. | Revisa el ID con [`plazbot contacts search`](https://developers.plazbot.com/cli/contacts/search). |
| `This action needs confirmation and there is no interactive terminal.` | Se ejecutó sin terminal y sin `--yes`. | Agrega `--yes`. |