Listar etiquetas

Muestra el catálogo de etiquetas activas del workspace con su ID y color. Necesitas el ID (mot_...) para etiquetar un contacto con contacts update --add-tag. También funciona como plazbot tag list.

bash

01plazbot tags list [options]

Parámetros

Parámetro	Flag	Requerido	Descripción
Workspace	`-w, --workspace <id>`	No	Workspace a consultar. Por defecto, el activo.
Zona	`-z, --zone <zone>`	No	`LA` o `EU`. Por defecto, la zona activa.
JSON	`--json`	No	Imprime `{ "data": [...], "nextCursor": null }`.

Las etiquetas eliminadas no aparecen. Para verlas usa plazbot workspace show tags --include-inactive (ver workspace).

Ejemplos

bash

01# Listar las etiquetas
02plazbot tags list
03 
04# Obtener el ID de una etiqueta por su nombre
05plazbot tags list --json | jq -r '.data[] | select(.name == "VIP") | .id'

Resultado

text

01  Tags (2)
02  ────────────────────────────────────────
03┌───────────────┬──────────────────┬─────────┐
04│ ID            │ Name             │ Color   │
05├───────────────┼──────────────────┼─────────┤
06│ mot_AbcDef123 │ VIP              │ #22c55e │
07├───────────────┼──────────────────┼─────────┤
08│ mot_GhiJkl456 │ Conversar con IA │ #c084fc │
09└───────────────┴──────────────────┴─────────┘

Salida JSON

json

01{
02  "data": [
03    {
04      "id": "mot_AbcDef123",
05      "name": "VIP",
06      "color": "#22c55e",
07      "status": 1,
08      "userCreation": "usr_AbcDef123",
09      "creationDate": "2026-06-25T15:13:58.619Z"
10    }
11  ],
12  "nextCursor": null
13}

Errores comunes

Mensaje	Causa	Solución
`Workspace wok_... not found in zone ...`	El workspace no existe en esa zona	Revisa `-w` y `-z`
`You are not signed in.`	No hay sesión	Ejecuta `plazbot login`