curl -X GET https://api.whaapy.com/contacts/v1/tags \
-H "Authorization: Bearer wha_TU_API_KEY"
const response = await fetch('https://api.whaapy.com/contacts/v1/tags', {
headers: { 'Authorization': 'Bearer wha_TU_API_KEY' }
});
const data = await response.json();
console.log(data.tags);
import requests
response = requests.get(
'https://api.whaapy.com/contacts/v1/tags',
headers={'Authorization': 'Bearer wha_TU_API_KEY'}
)
print(response.json())
$ch = curl_init('https://api.whaapy.com/contacts/v1/tags');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Authorization: Bearer wha_TU_API_KEY'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
echo $response;
{
"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
}
Contactos
Listar Tags
Obtiene todos los tags únicos usados en tus contactos
GET
/
contacts
/
v1
/
tags
curl -X GET https://api.whaapy.com/contacts/v1/tags \
-H "Authorization: Bearer wha_TU_API_KEY"
const response = await fetch('https://api.whaapy.com/contacts/v1/tags', {
headers: { 'Authorization': 'Bearer wha_TU_API_KEY' }
});
const data = await response.json();
console.log(data.tags);
import requests
response = requests.get(
'https://api.whaapy.com/contacts/v1/tags',
headers={'Authorization': 'Bearer wha_TU_API_KEY'}
)
print(response.json())
$ch = curl_init('https://api.whaapy.com/contacts/v1/tags');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Authorization: Bearer wha_TU_API_KEY'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
echo $response;
{
"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"
const response = await fetch('https://api.whaapy.com/contacts/v1/tags', {
headers: { 'Authorization': 'Bearer wha_TU_API_KEY' }
});
const data = await response.json();
console.log(data.tags);
import requests
response = requests.get(
'https://api.whaapy.com/contacts/v1/tags',
headers={'Authorization': 'Bearer wha_TU_API_KEY'}
)
print(response.json())
$ch = curl_init('https://api.whaapy.com/contacts/v1/tags');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Authorization: Bearer wha_TU_API_KEY'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
echo $response;
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
| Campo | Tipo | Descripción |
|---|---|---|
tags | array | Array de objetos con nombre y conteo |
tags[].name | string | Nombre del tag |
tags[].count | number | Número de contactos con este tag |
total_tags | number | Total de tags únicos |
Casos de Uso
Autocompletado en UI
Autocompletado en UI
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);
Dashboard de segmentación
Dashboard de segmentación
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
}));
Validación de tags
Validación de tags
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
Was this page helpful?