# Estado de un contacto en una automatización

> plazbot automations state: en qué flujo y en qué nodo está un contacto ahora, con su pausa y reintentos.

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

### Estado de un contacto en una automatización

Muestra si un contacto está dentro de un flujo en este momento: la automatización, el nodo donde está, desde cuándo, hasta cuándo dura la espera y cuántos reintentos lleva. Es el primer paso cuando un cliente dice que "el bot no responde".

```bash
plazbot automations state <contactId> [options]
```

### Parámetros

| Parámetro | Flag | Requerido | Descripción |
|-----------|------|-----------|-------------|
| Contacto | `<contactId>` | Sí | ID del contacto (`con_...`). Lo puedes buscar con [`plazbot contacts search`](https://developers.plazbot.com/cli/contacts/search). |
| 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
# ¿Este contacto está atascado en un flujo?
plazbot automations state con_AbcDef123

# Solo el nodo actual
plazbot automations state con_AbcDef123 --json | jq -r '.nodeTitle'
```

### Resultado

```text
Automation state of con_AbcDef123
────────────────────────────────────────
{
  "status": "reply",
  "automationId": "aut_AbcDef123",
  "automationTitle": "Bienvenida",
  "nodeId": "node-549369194-677972053",
  "nodeTitle": "Pedir documento",
  "startedAt": "2026-08-29T01:18:50.426Z",
  "endsAt": "2026-08-29T01:21:50.426Z",
  "retries": 0,
  "lastAction": "..."
}
```

`status` indica qué espera el flujo, por ejemplo `reply` (espera la respuesta del contacto). Si el contacto no está en ningún flujo, el resultado es `null`.

### Salida JSON

El mismo objeto, sin el título:

```json
{
"status": "reply",
"automationId": "aut_AbcDef123",
"automationTitle": "Bienvenida",
"nodeId": "node-549369194-677972053",
"nodeTitle": "Pedir documento",
"startedAt": "2026-08-29T01:18:50.426Z",
"endsAt": "2026-08-29T01:21:50.426Z",
"retries": 0
}
```

Para ver qué pasó antes, revisa el historial con [`plazbot automations logs`](https://developers.plazbot.com/cli/automations/logs) filtrando por el contacto.

### Errores comunes

| Mensaje | Causa | Solución |
|---------|-------|----------|
| `You are not signed in.` | No hay sesión. | Ejecuta [`plazbot login`](https://developers.plazbot.com/cli/login). |
