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
01plazbot 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. |
| 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
01# ¿Este contacto está atascado en un flujo?02plazbot automations state con_AbcDef1230304# Solo el nodo actual05plazbot automations state con_AbcDef123 --json | jq -r '.nodeTitle'
Resultado
text
01 Automation state of con_AbcDef12302 ────────────────────────────────────────03 {04 "status": "reply",05 "automationId": "aut_AbcDef123",06 "automationTitle": "Bienvenida",07 "nodeId": "node-549369194-677972053",08 "nodeTitle": "Pedir documento",09 "startedAt": "2026-08-29T01:18:50.426Z",10 "endsAt": "2026-08-29T01:21:50.426Z",11 "retries": 0,12 "lastAction": "..."13 }
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
01{02 "status": "reply",03 "automationId": "aut_AbcDef123",04 "automationTitle": "Bienvenida",05 "nodeId": "node-549369194-677972053",06 "nodeTitle": "Pedir documento",07 "startedAt": "2026-08-29T01:18:50.426Z",08 "endsAt": "2026-08-29T01:21:50.426Z",09 "retries": 010}
Para ver qué pasó antes, revisa el historial con plazbot automations logs filtrando por el contacto.
Errores comunes
| Mensaje | Causa | Solución |
|---|---|---|
You are not signed in. | No hay sesión. | Ejecuta plazbot login. |