Skip to main content
GET
Listar etiquetas
Auth: TokenAccount o TokenInstanceRate-limit: Global (100/min) • Idempotente:

Descripción

Devuelve todas las etiquetas conocidas por la instancia, incluyendo las creadas vía API y las importadas desde el app state de WhatsApp. Cada etiqueta lleva un id, name, color (paleta nativa de WhatsApp), type y bandera deleted.
color es un entero entre 0 y 10 que mapea a los colores oficiales de WhatsApp Business. Las etiquetas marcadas con deleted=true siguen apareciendo en la lista hasta que la sincronización las elimine definitivamente.

Ejemplo

Respuesta exitosa

tags es el array de etiquetas conocidas por la cuenta de WhatsApp Business; total repite el tamaño. Cada entrada lleva id (úsalo en tags-assign/tags-unassign/tags-delete), name, color (0–10) y type. Las etiquetas marcadas con deleted: true representan eliminaciones pendientes de propagación.
200 OK

Parámetros de ruta

string
requerido
Nombre de la instancia.

Cabeceras

Respuestas de error

Error 401

Relacionados

Crear etiqueta

POST /api/chat/tag/:instance

Asignar a un chat

POST /api/chat/assignTag/:instance