Monitoreo y Admin

Endpoints para consultar estadísticas y gestionar la cola de mensajes de tus instancias.

Estadísticas globales

json

GET /admin/stats

// Respuesta 200
{
  "instances": 2,
  "totals": { "queued": 5, "sent": 1250, "failed": 3 },
  "perInstance": [
    {
      "instanceName": "acme__soporte__main",
      "queue":    { "urgent": 0, "normal": 5, "bulk": 2, "total": 7 },
      "messages": { "sent": 450, "failed": 1, "pending": 7 }
    }
  ]
}

Vaciar cola de una instancia

Elimina todos los mensajes pendientes de la cola. Útil para emergencias o resets.

json

DELETE /admin/queue/acme__soporte__main

// Respuesta 200
{ "instanceName": "acme__soporte__main", "flushed": 12 }

Health check

No requiere autenticación. Útil para monitores externos y load balancers.

json

GET /health  (no requiere apikey)

// Respuesta 200
{
  "status": "ok",
  "uptime": 3600
}

Códigos de error

Status	Significado	Acción
`400`	Body inválido	Ver campo `issues` en respuesta
`401`	API key faltante o inválida	Verificar header `apikey`
`403`	Sin acceso al recurso	`instanceName` debe empezar con tu `tenantId`
`404`	Instancia o mensaje no existe	Verificar nombre o ID
`409`	Instancia ya existe	Usar la existente o elegir otro nombre
`502`	Error en servicio WhatsApp	Verificar sesión; reintentar
`500`	Error interno	Reportar a soporte

json

// Error 400 — validación
{
  "error": "Validation error",
  "issues": [
    { "path": ["instanceName"], "message": "Must follow {tenant}__{client}__{label} format" }
  ]
}

// Otros errores
{ "error": "Instance not found" }