Un bot de analítica para servidores de Discord convierte las entradas de miembros, las aperturas de tickets y los pagos de facturas en un informe que puedes leer de un vistazo, ya sea como un embed de Discord o en un panel web. Noxyr lo hace con dos comandos de barra, /status y /sales, una página de Resumen en el panel y una API de servidor de solo lectura que expone los mismos números en tu propio sitio. Esta guía explica qué muestra realmente cada uno.
/status: estadísticas de miembros, tickets y comunidad
/status es un comando solo para administradores con cinco vistas: all, invite, sales, tickets y community. Cada vista acepta una opción days (7, 14 o 30, por defecto 30) y devuelve un embed con un gráfico de líneas adjunto, así que sirve tanto para una comprobación rápida de números como para ver la tendencia.
- /status invite: entradas y salidas de hoy, de los últimos 7 días y del periodo elegido, mostradas como cambio neto con los recuentos brutos de altas y bajas debajo.
- /status tickets: tickets abiertos, tickets cerrados y cuántos hay abiertos en este momento. Es la analítica de tickets que más piden los administradores de Discord: si los tickets se acumulan o si el equipo va al ritmo.
- /status sales: número de facturas y valor total. El total es una suma simple, no una conversión de moneda, porque las facturas pueden emitirse en más de una moneda y convertirlas supondría adivinar un tipo de cambio.
- /status community: número de reseñas y volumen de mensajes, para tener una lectura de la actividad general y no del soporte o los ingresos.
- /status all: todos los campos anteriores en un solo embed, para un resumen del lunes por la mañana.
El gráfico se genera en el servidor y se adjunta como imagen. Si la generación del gráfico falla por cualquier motivo, el comando responde igualmente con los números en texto en lugar de fallar por completo. Los recuentos de miembros y mensajes solo empiezan a contar desde el día en que Noxyr se unió al servidor, así que un bot añadido el mes pasado no mostrará años de historial.
/sales: ingresos, mejores compradores y estilo del informe
/sales cubre las estadísticas de ventas que necesita un bot de Discord más allá de un único total. Tiene tres subcomandos, todos solo para administradores, y todos se pueden responder en privado o publicar en el canal con la opción post.
- /sales report: ingresos del periodo, número de pedidos pagados, unidades vendidas, número de facturas, un desglose por estado (Exitoso, Pendiente, Fallido) y por método de pago, además de los productos más vendidos. Los periodos disponibles son los últimos 7 días, los últimos 30 días, los últimos 90 días o todo el tiempo.
- /sales top: una clasificación de compradores, ordenada por número de pedidos o por importe gastado, filtrable por moneda, que muestra hasta 25 compradores.
- /sales style: define el color del embed, las imágenes de banner y miniatura, los títulos personalizados del informe y de la clasificación, el texto del pie, el tamaño predeterminado de la clasificación, si los nombres de los compradores aparecen junto a la mención, y qué estados de factura cuentan como ingresos. Desactivar los tres estados a la vez no está permitido, ya que un informe que nunca cuenta nada como ingreso no le sirve a nadie.
Ambos comandos comprueban antes de ejecutarse el permiso de Administrador o un rol de administrador configurado, la misma puerta de acceso que usa el panel.
Lo que muestra el Resumen del panel
La página de Resumen del panel no es el mismo informe que /status. Es la primera página que ves al entrar en un servidor, y resume la parte de tienda y soporte: número de categorías, productos y cupones activos, total de facturas, total de reseñas, las cinco facturas más recientes y las cinco reseñas más recientes, además de una lista de configuración pendiente para cualquier función que hayas activado pero no terminado de configurar. Mientras que /status y /sales son informes puntuales que pides cuando quieres en Discord, el Resumen es el panorama siempre actualizado que consultas desde el navegador sin tener que estar escribiendo en Discord en mitad de una conversación.
Leer los mismos números desde tu propia web: la API del servidor
Si quieres estadísticas de tu servidor de Discord en tu propio sitio, en una página de estado o en una hoja de cálculo, la API del servidor es el puente. Es de solo lectura, está limitada a un servidor y devuelve JSON con los mismos datos que ya registran /status y el panel:
- GET /api/v1/server: nombre, icono, número de miembros, número de conectados y mejoras (boosts).
- GET /api/v1/tickets: totales, recuentos de abiertos y cerrados, volumen de los últimos 7 y 30 días, y valoración media.
- GET /api/v1/activity?days=30: mensajes diarios, entradas y salidas, hasta 90 días atrás.
- GET /api/v1/invoices: número de facturas e ingresos por moneda y estado.
- GET /api/v1/reviews: valoración media, desglose por estrellas y las reseñas públicas más recientes.
- GET /api/v1/giveaways: recuentos de sorteos activos y finalizados, y número total de participaciones.
Genera una clave desde la página de API del servidor en el panel, envíala como token Bearer, y cada endpoint está protegido por su propio ámbito (scope), así que puedes compartir una clave que solo lea tickets, por ejemplo, sin exponer los datos de facturas. Las claves tienen un límite de 60 peticiones por minuto, más que suficiente, ya que los totales de tickets y ventas no necesitan consultarse más de una vez por minuto.
Preguntas frecuentes
¿Necesito la API para ver la analítica? No. /status y /sales funcionan sin ninguna configuración, y la página de Resumen del panel solo necesita un inicio de sesión. La API es para llevar los números a algo que esté fuera de Discord.
¿Tiene algún coste /status? No. Noxyr no tiene un nivel de pago, así que todas las vistas de /status y /sales están disponibles para todos los servidores.
¿Pueden los miembros ver estas estadísticas? Ambos comandos requieren el permiso de Administrador o un rol de administrador configurado, así que los miembros normales no pueden ejecutarlos.
¿Por qué el total de ventas no convierte monedas? Las facturas pueden emitirse en USD, INR, EUR o GBP, y el informe suma las monedas en las que realmente vendiste, en lugar de inventar un tipo de cambio.
Consulta la lista completa de comandos en /commands, o compara ejecutar cosas desde Discord frente al panel en Panel vs. comandos. Añade Noxyr gratis para tener analítica, tickets y una tienda funcionando en un solo bot.