Crear una etiqueta

Agrega una etiqueta al catálogo del workspace. Antes de crearla comprueba que no exista otra activa con el mismo nombre (sin distinguir mayúsculas). Pide confirmación salvo que pases --yes.

bash

01plazbot tags create <name> [options]

Parámetros

Parámetro	Flag	Requerido	Descripción
Nombre	`<name>`	Sí	Nombre de la etiqueta. Usa comillas si tiene espacios.
Color	`--color <hex>`	No	Color en formato `#RRGGBB`. Por defecto `#71717a` (gris).
Confirmar	`-y, --yes`	No	No pide confirmación (scripts, CI y agentes de IA).
Workspace	`-w, --workspace <id>`	No	Workspace donde crearla. Por defecto, el activo.
Zona	`-z, --zone <zone>`	No	`LA` o `EU`. Por defecto, la zona activa.
JSON	`--json`	No	Imprime la respuesta de la API en JSON.

Sin terminal interactiva (scripts, CI, agentes de IA) el comando falla con confirmation_required si no pasas --yes.

Ejemplos

bash

01# Crear una etiqueta (pide confirmación)
02plazbot tags create VIP --color "#22c55e"
03 
04# Desde un script
05plazbot tags create "Cliente recurrente" --color "#3b82f6" --yes --json

Para etiquetar un contacto usa contacts update --add-tag con el ID que devuelve tags list.

Resultado

text

01? Create tag "VIP" in workspace Mi Empresa? Yes
02 
03  Tag "VIP" created

Salida JSON

La respuesta de la API ({ "success": true, "message": "...", "data": ... }).

Errores comunes

Mensaje	Causa	Solución
`A tag named "..." already exists (mot_...).`	Ya hay una etiqueta activa con ese nombre	Usa la existente (el ID sale en el mensaje)
`Invalid color "..."`	El color no es `#RRGGBB`	Ejemplo: `--color "#22c55e"`
`This action needs confirmation and there is no interactive terminal.`	Sin terminal y sin `--yes`	Agrega `--yes`
`This session is read-only: it cannot change data.`	La sesión se creó con `plazbot login --read-only`	Inicia sesión sin `--read-only`