curl https://api.whaapy.com/segments/7c9e6679-7425-40de-944b-e07fc1f90ae7/usage \
-H "Authorization: Bearer wha_TU_API_KEY"
const response = await fetch(
'https://api.whaapy.com/segments/7c9e6679-7425-40de-944b-e07fc1f90ae7/usage',
{ headers: { 'Authorization': 'Bearer wha_TU_API_KEY' } }
);
const { data } = await response.json();
console.log(data.broadcasts.length, data.subagents.length);
{
"data": {
"broadcasts": [
{
"id": "0b8f3c0e-8c1a-4a77-9b0e-6f1f4f0a1111",
"name": "Promo de octubre",
"status": "scheduled",
"scheduledAt": "2026-10-20T15:00:00.000Z"
}
],
"subagents": [
{
"id": "5d2c9a52-3b1e-4f6a-8d7c-2a9e4c0b2222",
"name": "Ventas VIP",
"isActive": true
}
]
}
}
Segmentos
Uso de un Segmento
Consulta qué campañas y subagentes usan un segmento
GET
/
segments
/
{id}
/
usage
curl https://api.whaapy.com/segments/7c9e6679-7425-40de-944b-e07fc1f90ae7/usage \
-H "Authorization: Bearer wha_TU_API_KEY"
const response = await fetch(
'https://api.whaapy.com/segments/7c9e6679-7425-40de-944b-e07fc1f90ae7/usage',
{ headers: { 'Authorization': 'Bearer wha_TU_API_KEY' } }
);
const { data } = await response.json();
console.log(data.broadcasts.length, data.subagents.length);
{
"data": {
"broadcasts": [
{
"id": "0b8f3c0e-8c1a-4a77-9b0e-6f1f4f0a1111",
"name": "Promo de octubre",
"status": "scheduled",
"scheduledAt": "2026-10-20T15:00:00.000Z"
}
],
"subagents": [
{
"id": "5d2c9a52-3b1e-4f6a-8d7c-2a9e4c0b2222",
"name": "Ventas VIP",
"isActive": true
}
]
}
}
Devuelve dónde se usa un segmento: las campañas que todavía pueden enviar a su audiencia y los subagentes cuya activación depende de él. Es útil para revisar el impacto antes de editar o eliminar un segmento.
Cambiar las reglas de un segmento dinámico, o quitar miembros de uno estático, afecta de inmediato a las campañas y subagentes que aparecen aquí.
Path Parameters
string
required
UUID del segmento
Respuesta
array
Campañas vivas que usan el segmento como origen de destinatarios. Solo se incluyen las que están en estado
draft, scheduled, sending o paused; las terminadas o fallidas no cuentan. Más recientes primero.array
{
"data": {
"broadcasts": [
{
"id": "0b8f3c0e-8c1a-4a77-9b0e-6f1f4f0a1111",
"name": "Promo de octubre",
"status": "scheduled",
"scheduledAt": "2026-10-20T15:00:00.000Z"
}
],
"subagents": [
{
"id": "5d2c9a52-3b1e-4f6a-8d7c-2a9e4c0b2222",
"name": "Ventas VIP",
"isActive": true
}
]
}
}
Errores
| Código | Causa |
|---|---|
404 | El id no es un UUID válido, o el segmento no existe o no es de tu negocio |
500 | Error interno al consultar el uso |
Ejemplo
curl https://api.whaapy.com/segments/7c9e6679-7425-40de-944b-e07fc1f90ae7/usage \
-H "Authorization: Bearer wha_TU_API_KEY"
const response = await fetch(
'https://api.whaapy.com/segments/7c9e6679-7425-40de-944b-e07fc1f90ae7/usage',
{ headers: { 'Authorization': 'Bearer wha_TU_API_KEY' } }
);
const { data } = await response.json();
console.log(data.broadcasts.length, data.subagents.length);
Was this page helpful?