# Historial de ejecución de una automatización

> plazbot automations logs: eventos de ejecución de un flujo (inicio, nodos, errores, fin), filtrables por texto y fecha.

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

### Historial de ejecución de una automatización

Muestra el historial de ejecución de una automatización, del evento más reciente al más antiguo: cuándo entró cada contacto, por qué nodos pasó, los errores y cuándo terminó.

```bash
plazbot automations logs <automationId> [options]
```

### Parámetros

| Parámetro | Flag | Requerido | Descripción |
|-----------|------|-----------|-------------|
| ID | `<automationId>` | Sí | ID de la automatización (`aut_...`). |
| Búsqueda | `-s, --search <text>` | No | Filtra por texto: ID o nombre del contacto, nodo o error. |
| Desde | `--from <date>` | No | Solo desde esta fecha (ISO, por ejemplo `2026-10-01`). |
| Límite | `--limit <n>` | No | Máximo de eventos. Por defecto `100`. |
| 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. |

### Ejemplos

```bash
# Últimos eventos de un flujo
plazbot automations logs aut_AbcDef123

# Lo que le pasó a un contacto en ese flujo
plazbot automations logs aut_AbcDef123 -s con_AbcDef123

# Eventos desde el 1 de octubre, en JSON
plazbot automations logs aut_AbcDef123 --from 2026-10-01 --limit 500 --json
```

### Resultado

```text
Automation logs (2)
────────────────────────────────────────
┌─────────────────────┬───────────┬──────────┬─────────────────┬────────────────────────────────┐
│ Date (UTC)          │ Contact   │ Node     │ Event           │ Detail                         │
├─────────────────────┼───────────┼──────────┼─────────────────┼────────────────────────────────┤
│ 2026-10-08 09:59:40 │ Ana Pérez │ —        │ execution_end   │ Ejecucion finalizada (3 nodos) │
├─────────────────────┼───────────┼──────────┼─────────────────┼────────────────────────────────┤
│ 2026-10-08 09:59:38 │ Ana Pérez │ message  │ node_executed   │ Saludo                         │
└─────────────────────┴───────────┴──────────┴─────────────────┴────────────────────────────────┘
```

| Columna | Descripción |
|---------|-------------|
| Date (UTC) | Fecha del evento. |
| Contact | Nombre del contacto (o su ID). |
| Node | Tipo de nodo del evento (vacío en eventos del flujo completo). |
| Event | Tipo de evento, por ejemplo `execution_end`. |
| Detail | Descripción del evento. Los eventos que no son `info` llevan el nivel delante, por ejemplo `[error]`. |

### Salida JSON

```json
{
"data": [
  {
    "timestamp": "2026-10-08 09:59:40",
    "automation_id": "aut_AbcDef123",
    "contact_id": "con_AbcDef123",
    "contact_name": "Ana Pérez",
    "session_id": "1787219978625-lfdyjd",
    "node_id": "",
    "node_type": "",
    "event_type": "execution_end",
    "event_title": "Ejecucion finalizada (3 nodos)",
    "event_data": "{\"nodesVisited\":3}",
    "duration_ms": 0,
    "level": "info"
  }
],
"nextCursor": null
}
```

### Errores comunes

| Mensaje | Causa | Solución |
|---------|-------|----------|
| `You are not signed in.` | No hay sesión. | Ejecuta [`plazbot login`](https://developers.plazbot.com/cli/login). |
| `Not Found` | El historial de esa automatización no está disponible. | Revisa el ID. Si el flujo existe, el servicio de historial puede no tener datos aún. |