Skip to main content
GET
/
contacts
/
v1
/
tags
curl -X GET https://api.whaapy.com/contacts/v1/tags \
  -H "Authorization: Bearer wha_TU_API_KEY"

{
  "tags": [
    { "name": "lead", "count": 320 },
    { "name": "cliente", "count": 150 },
    { "name": "newsletter", "count": 89 },
    { "name": "premium", "count": 45 },
    { "name": "vip", "count": 12 },
    { "name": "campaña-enero", "count": 8 }
  ],
  "total_tags": 6
}
Obtén una lista de todos los tags utilizados en tus contactos, ordenados por frecuencia de uso.
Usa este endpoint para poblar dropdowns, autocompletado de tags, o para análisis de segmentación.

​
Ejemplos

curl -X GET https://api.whaapy.com/contacts/v1/tags \
  -H "Authorization: Bearer wha_TU_API_KEY"

​
Respuesta Exitosa

{
  "tags": [
    { "name": "lead", "count": 320 },
    { "name": "cliente", "count": 150 },
    { "name": "newsletter", "count": 89 },
    { "name": "premium", "count": 45 },
    { "name": "vip", "count": 12 },
    { "name": "campaña-enero", "count": 8 }
  ],
  "total_tags": 6
}

​
Campos de la Respuesta

CampoTipoDescripción
tagsarrayArray de objetos con nombre y conteo
tags[].namestringNombre del tag
tags[].countnumberNúmero de contactos con este tag
total_tagsnumberTotal de tags únicos

​
Casos de Uso

Usa la lista de tags para sugerir opciones mientras el usuario escribe:
const { tags } = await api.get('/contacts/v1/tags');
const suggestions = tags
  .filter(t => t.name.includes(userInput))
  .map(t => t.name);
Muestra la distribución de contactos por tag:
const { tags, total_tags } = await api.get('/contacts/v1/tags');

// Crear gráfico de barras con tags y conteos
const chartData = tags.map(t => ({
  label: t.name,
  value: t.count
}));
Verifica que un tag existe antes de usarlo:
const { tags } = await api.get('/contacts/v1/tags');
const validTags = tags.map(t => t.name);

const isValid = userTags.every(t => validTags.includes(t));

​
Próximos Pasos

Búsqueda por Tags

Filtrar contactos por tags

Agregar Tags

Modificar tags de un contacto

Tags Masivos

Agregar/remover tags en lote

Campos Personalizados

Ver campos disponibles