Gestionar tu bot desde el panel de control

Introducción

El panel de administración de Telegram Bot App ofrece una interfaz web completa para configurar ajustes de moderación, supervisar la actividad de los grupos, analizar el comportamiento de los usuarios y gestionar suscripciones, todo desde un panel de control centralizado accesible desde cualquier dispositivo con un navegador web. Esta potente interfaz administrativa convierte la configuración compleja del bot en operaciones intuitivas de apuntar y hacer clic, al tiempo que proporciona análisis detallados y capacidades de supervisión en tiempo real que serían imposibles mediante la interfaz nativa de Telegram.

El panel es el lugar desde el que gestionas todas tus actividades de moderación, desde simples interruptores para activar sistemas de detección hasta análisis que muestran tendencias de infracciones, informes de inteligencia de usuarios con puntuaciones de riesgo conductual y feeds de sanciones en tiempo real que muestran las acciones de moderación a medida que ocurren. Tanto si gestionas una única comunidad pequeña como si moderas decenas de grupos grandes, se utiliza la misma interfaz.

Resumen del panel

Acceder al panel

Para acceder al panel de administración:

1. Visita el sitio web de Telegram Bot App
2. Haz clic en "Iniciar sesión con Telegram" o "Acceder al panel"
3. Completa la autenticación de Telegram (se te redirigirá a Telegram para autorizar)
4. Vuelve al panel: verás todos los grupos en los que eres administrador y donde el bot está presente

Importante: Debes añadir el bot a al menos un grupo antes de poder acceder al panel. El sistema de autenticación verifica tu relación como administrador con los grupos supervisados por el bot; sin esta verificación, el inicio de sesión no funcionará.

Navegación principal

El panel utiliza una interfaz limpia y moderna, con la navegación principal en el encabezado:

• Inicio: Página de inicio con estadísticas rápidas y actividad reciente
• Panel: Interfaz principal de gestión de grupos (tu espacio de trabajo principal)
• Inteligencia de usuarios: Herramientas de análisis de comportamiento y detección de spam
• Precios: Planes de suscripción y comparación de funciones
• Funciones: Lista completa de funciones y capacidades
• Centro de aprendizaje: Documentación y tutoriales (¡estás leyendo uno ahora!)
• Soporte: Información de contacto y recursos de ayuda

La sección Panel contiene la mayoría de las actividades administrativas del día a día, mientras que Inteligencia de usuarios ofrece análisis avanzados para investigar usuarios concretos o supervisar la actividad de moderación en todo el sistema.

Vista del panel de control

La página Panel muestra todos los grupos en los que eres administrador y donde el bot está activo. Cada grupo aparece como una tarjeta que muestra:

• Nombre del grupo y avatar
• Identificador del grupo (@groupname)
• Número de miembros
• Insignia de estado de suscripción (Free, Gold, Platinum, Ultimate)
• Indicador de estado (si el grupo está "permitido", es decir, activado para moderación)
• Botones de acción rápida para gestionar el grupo

Usa la barra de búsqueda de la parte superior para filtrar grupos por nombre o identificador; es especialmente útil si administras muchas comunidades. Los grupos se muestran en una lista virtualizada que gestiona de forma eficiente incluso cantidades muy grandes de grupos (20+) sin pérdida de rendimiento.

Interfaz de gestión de grupos

Al hacer clic en un grupo concreto, se abre la interfaz completa de gestión, organizada en tres pestañas principales:

Pestaña Información:

• Estado de la suscripción y opciones de mejora
• Lista de administradores del grupo (haz clic en cualquier administrador para ver su informe de inteligencia)
• Metadatos del grupo (identificador de Telegram, enlace de invitación, última actividad)
• Enlaces rápidos para abrir el grupo en Telegram

Pestaña Estadísticas:

• Estadísticas del grupo: métricas generales, estadísticas de actividad, eficiencia de moderación, desglose de infracciones
• Estadísticas de usuarios: 50 miembros más activos, con búsqueda por nombre/identificador/ID/biografía

Pestaña Configuración:

• Protección básica: CAPTCHA, restricciones de medios, gestión de usuarios
• Moderación con AI: detección de NSFW, análisis de sentimiento, detección de spam, aplicación de idioma
• Configuración de idioma: selección de idioma y opciones de aplicación
• Mensajes y saludos: mensajes de bienvenida, reglas del grupo, comportamiento del bot
• Configuración avanzada: filtro de malas palabras, controles de estado del grupo

Esta organización en tres pestañas separa la consulta de información (Información y Estadísticas) de la configuración (Configuración), reduce el desorden y facilita encontrar las tareas habituales.

Configuración de los ajustes de moderación

Pestaña de protección básica

Los ajustes de protección básica ofrecen controles fundamentales de gestión de grupos disponibles para todos los niveles de suscripción:

Gestión de usuarios:

• Activar CAPTCHA para nuevos miembros (con tiempo de espera configurable y opciones de expulsión en caso de fallo)
• Prohibir otros bots automáticamente
• Limitar usuarios anónimos

Restricciones de contenido:

• Bloquear vídeos, GIFs, audio, archivos y mensajes de texto (interruptores individuales)
• Bloquear reenvíos
• Bloquear enlaces de invitación

Cada interruptor incluye una etiqueta descriptiva que explica su función. Los cambios se guardan automáticamente: solo tienes que activar o desactivar el interruptor y el ajuste se aplicará de inmediato a todos los mensajes nuevos.

Pestaña de moderación AI

Los ajustes de moderación AI controlan sistemas avanzados de detección, con algunas funciones restringidas a los planes premium:

Detección de contenido NSFW (Premium - usa cuota de escaneo de imágenes):

• Detectar contenido pornográfico
• Detectar contenido provocativo o sugerente
• Detectar contenido falsificado
• Modo estricto (combina pornografía + contenido provocativo)
• Control deslizante del umbral de detección de imágenes (0-100%)

Escaneo de medios (Premium para algunos):

• Escanear imágenes (Premium)
• Escanear GIFs (Premium)
• Escanear stickers (Premium)
• Escanear fotos de perfil de usuarios (Gratis)
• Escanear texto del perfil de usuarios (Gratis)

Detección de spam (Gratis):

• Activar buscador de spam (basado en patrones)
• Control deslizante del umbral de detección de spam (0-100%)
• Activar detección de spam con AI (análisis de comportamiento, expulsión automática a partir de 0.75)

Análisis de toxicidad y sentimiento (Premium):

• Bloquear blasfemias (castigo de 1 min)
• Bloquear insultos (castigo de 1 min)
• Bloquear amenazas (castigo de 5 min)
• Control deslizante del umbral de detección de sentimiento (0-100%)

Las funciones exclusivas de Premium muestran una insignia que indica el requisito de suscripción y ofrecen botones de mejora para usuarios del plan gratuito.

Controles deslizantes de umbral

Tres controles deslizantes de umbral críticos regulan la sensibilidad de detección:

Umbral de detección de imágenes:

• Rango: 0-100% (0.0-1.0 internamente)
• Predeterminado: 70%
• Más bajo = más sensible (detecta contenido límite, más falsos positivos)
• Más alto = menos sensible (solo detecta infracciones evidentes, menos falsos positivos)

Umbral de detección de sentimiento:

• Rango: 0-100%
• Predeterminado: 70%
• Controla la sensibilidad de detección de toxicidad, blasfemias, insultos y amenazas

Umbral de detección de spam:

• Rango: 0-100%
• Predeterminado: 75%
• Controla la sensibilidad de detección de patrones de spam

Ajustar estos controles deslizantes afecta de inmediato al análisis de mensajes futuros: no hay retrasos ni hace falta pulsar ningún botón de guardar. Experimenta con distintos valores y supervisa las estadísticas de infracciones para encontrar la configuración óptima para tu comunidad.

Pestaña de ajustes de idioma

Configura la aplicación de idiomas con control preciso:

• Interruptor para activar el filtro de idioma
• Modo solo eliminar (eliminar sin castigo)
• Menú desplegable de selector de idioma con 43 idiomas compatibles, desde árabe hasta vietnamita

El selector de idioma utiliza menús desplegables para facilitar la selección. Elige el idioma que usa principalmente tu comunidad, activa el filtro de idioma y los mensajes en otros idiomas se eliminarán automáticamente (y los usuarios serán sancionados, a menos que el modo solo eliminar esté activado).

Pestaña de mensajes y saludos

Personaliza las funciones de interacción del grupo:

Mensaje de bienvenida:

• Interruptor para activar el saludo
• Texto de saludo personalizado (área de texto compatible con formato)

Reglas del grupo:

• Interruptor para activar las reglas del grupo
• Generar reglas automáticamente según los ajustes (casilla de verificación)
• Texto de reglas personalizado (área de texto)

Comportamiento del bot:

• Silenciar el bot (impedir todos los mensajes del bot)
• Eliminar mensajes del sistema (quitar notificaciones de entrada/salida)
• Activar el comando /link

Estos ajustes controlan funciones visibles para los usuarios que influyen en cómo los miembros experimentan tu grupo.

Pestaña de ajustes avanzados

Configura funciones especializadas:

Filtro de malas palabras:

• Interruptor para activar el filtro de malas palabras
• Aplicar castigo o solo eliminar
• Añadir malas palabras personalizadas (campo de entrada + botón de añadir)
• Ver y eliminar malas palabras existentes (lista con botones de eliminación)

Estado del grupo:

• Grupo permitido (si la moderación está activa)
• Ocultar de las estadísticas

La interfaz de malas palabras ofrece gestión con apuntar y hacer clic: escribe una palabra, haz clic en Añadir y se incorporará de inmediato a tu lista de filtros. Haz clic en la X junto a cualquier palabra para eliminarla.

Monitoreo y análisis

Panel de estadísticas del grupo

Accede a métricas completas a través de Estadísticas > Estadísticas del grupo:

Resumen:

• Estado (permitido/no permitido)
• Total de miembros
• Total de administradores
• Verificación de presencia del bot
• Estado de la foto de perfil y del enlace de invitación

Métricas de actividad:

• Total histórico de mensajes
• Total de infracciones detectadas
• Tiempo total de castigo aplicado (minutos)
• Relación entre mensajes y moderación

Eficiencia de la moderación:

• Tasa de castigos por cada 1.000 mensajes
• Duración media del castigo
• Promedio de mensajes por miembro (indicador de participación)

Actividad reciente:

• Castigos de los últimos 7 días
• Castigos de los últimos 30 días
• Análisis de tendencias

Desglose de infracciones principales:

• Infracciones por tipo (pornografía, lenguaje tóxico, spam, etc.)
• Recuentos exactos de cada categoría
• Representación visual de qué reglas se infringen con mayor frecuencia

Estas estadísticas se actualizan en tiempo real a medida que llegan nuevos datos, lo que garantiza que siempre veas métricas actualizadas.

Estadísticas de usuarios

Consulta y analiza la actividad de los miembros a través de Estadísticas > Estadísticas de usuarios:

• Barra de búsqueda para filtrar por nombre, nombre de usuario, ID o contenido de la biografía
• Los 50 usuarios más activos por número de mensajes
• Cada tarjeta de usuario muestra:
  • Avatar
  • Nombre y nombre de usuario
  • Número total de mensajes en este grupo
  • Marca de tiempo de la última actividad
• Haz clic en cualquier usuario para ver su informe de inteligencia completo

Usa esta función para identificar a los miembros más participativos de tu comunidad, detectar patrones de actividad inusuales (un número de mensajes extremadamente alto podría indicar bots de spam) o investigar usuarios concretos reportados por los miembros.

Gestión de la suscripción

Supervisa y gestiona tu suscripción a través de varias interfaces:

Página de estado de la suscripción (accesible desde la pestaña de información del grupo):

• Detalles del plan actual (nombre, precio, funciones)
• Período de facturación (fecha de inicio, fecha de finalización)
• Cuotas de funciones (análisis de imágenes, análisis de sentimiento, etc.)
• Medidores de uso con actualizaciones en tiempo real (impulsados por WebSocket)
• Interruptor de exceso de uso (activar/desactivar pago por uso)
• Grupos cubiertos por esta suscripción
• Indicador del estado de la conexión

Página de historial de facturación:

• Resumen del período de facturación actual
• Los 12 períodos de factura más recientes
• Cada factura muestra: número de período, fechas, cargos por exceso de uso, estado del pago
• Gestión del método de pago (redirige al portal de Stripe)

Los medidores de uso ofrecen actualizaciones en vivo a medida que se consume la cuota, con barras de progreso visuales que muestran el porcentaje utilizado y los recuentos exactos (por ejemplo, "450 / 500 análisis de imágenes usados"). Esta visibilidad en tiempo real te ayuda a entender si tu plan actual cubre tus necesidades o si te convendría una mejora.

Funciones de inteligencia de usuarios

Informes de inteligencia individuales

Accede a un análisis profundo del comportamiento de cualquier usuario:

1. Ve a Inteligencia de usuarios desde el menú principal
2. Busca por nombre, handle o ID de Telegram
3. Consulta un informe completo que incluye:
   • Calificación de spam (0.0-1.0 con indicador de nivel de riesgo)
   • Estadísticas de infracciones (media de confianza, mediana, percentil 95, tasa de alta confianza)
   • Actividad en grupos (mensajes enviados, grupos a los que se unió)
   • Historial completo de infracciones (lista cronológica con marcas de tiempo, tipos, confianza y motivos)

La calificación de spam es la misma puntuación que usa AI Spam Intelligence para determinar expulsiones automáticas: las puntuaciones de 0.75 o más activan la eliminación cuando la detección de spam con AI está habilitada. Usa los informes de inteligencia para investigar usuarios sospechosos, verificar decisiones de aplicación de normas o evaluar si los usuarios en el límite merecen una segunda oportunidad.

Feed de castigos en vivo

Supervisa en tiempo real la actividad de moderación de todo el sistema:

1. Ve a Inteligencia de usuarios > pestaña Castigos en vivo
2. Observa el flujo de infracciones recientes en todos los grupos supervisados
3. Cada entrada muestra:
   • Avatar y nombre del usuario
   • Tipo de infracción y motivo detallado
   • Puntuación de confianza
   • Marca de tiempo relativa
   • Estado de conexión (salud de WebSocket)
4. Haz clic en cualquier castigo para ver el informe de inteligencia completo del infractor

El feed en vivo se actualiza en tiempo real a medida que ocurren infracciones en tus grupos, para que puedas ver qué infracciones están ocurriendo ahora. Presta atención a patrones como múltiples infracciones similares de distintos usuarios (campañas coordinadas de spam) o tipos de infracciones inusuales que puedan indicar nuevas tácticas de spam.

Documentación de la API pública

Accede a datos de inteligencia de forma programática:

1. Ve a Inteligencia de usuarios > pestaña Documentación de la API
2. Revisa el endpoint y el formato de la REST API
3. Copia ejemplos de código en tu lenguaje preferido:
   • cURL (línea de comandos)
   • JavaScript (fetch API)
   • Python (biblioteca requests)
4. Sustituye el ID de usuario de ejemplo por el ID que quieras consultar
5. Ejecuta la solicitud para recibir un JSON con la calificación de spam y el nivel de riesgo

La API pública permite la integración con herramientas externas, lo que habilita flujos de trabajo sofisticados más allá de la interfaz web.

Patrones de uso en el mundo real

Rutina diaria de moderación

Un flujo de trabajo diario típico de moderación usando el panel:

1. Revisión matutina (5 minutos):

   • Abrir el panel y revisar el estado de todas las tarjetas de grupo
   • Comprobar los medidores de uso de la suscripción para ver el consumo de la cuota
   • Revisar si hay grupos con indicadores de infracciones elevados

2. Análisis semanal en profundidad (30 minutos):

   • Revisar las estadísticas de grupo de cada grupo importante
   • Examinar el desglose de infracciones principales para identificar tendencias
   • Comprobar las estadísticas de usuarios para detectar nuevos miembros muy activos
   • Revisar User Intelligence para usuarios con valoraciones de spam elevadas (0.50+)

3. Revisión estratégica mensual (60 minutos):

   • Comparar las estadísticas mes a mes
   • Ajustar los umbrales según los patrones de infracciones
   • Revisar el uso de la suscripción para determinar si se necesitan cambios de plan
   • Actualizar los mensajes de bienvenida o las reglas según la evolución de la comunidad

Este ritmo equilibra la supervisión proactiva con la eficiencia administrativa.

Gestión de varios grupos

Para administradores que gestionan muchas comunidades:

1. Organización del panel:

   • Usar la búsqueda para localizar rápidamente grupos concretos
   • Marcar con estrella o guardar en favoritos del navegador los grupos a los que se accede con frecuencia
   • Organizar las pestañas del navegador con una por cada grupo importante

2. Estrategia de ajustes compartidos:

   • Desarrollar «perfiles» para tipos de grupos similares (por ejemplo, «perfil de moderación estricta» para grupos profesionales, «perfil relajado» para grupos sociales)
   • Aplicar ajustes de umbral coherentes en grupos del mismo tipo
   • Usar notas para documentar por qué se eligieron ajustes específicos

3. Inteligencia centralizada:

   • Usar User Intelligence para identificar usuarios que causan problemas en varios grupos
   • Cruzar patrones de infracciones entre comunidades
   • Coordinar acciones de cumplimiento para usuarios en varios grupos relacionados

El diseño del panel permite escalar desde la gestión de un solo grupo hasta la coordinación de la moderación en decenas de comunidades.

Experimentación con ajustes

Al calibrar los ajustes de moderación:

1. Establecer una base de referencia:

   • Anotar las estadísticas actuales (tasa de sanciones, desglose de infracciones)
   • Documentar los ajustes de umbral actuales

2. Hacer un solo cambio:

   • Ajustar solo un umbral a la vez
   • Documentar qué cambió y cuándo

3. Supervisar el impacto (3-7 días):

   • Observar las estadísticas de grupo para detectar cambios en los patrones de infracciones
   • Revisar infracciones concretas para verificar la calidad

4. Evaluar e iterar:

   • Si hay mejora, mantener el cambio
   • Si el impacto es negativo, revertirlo y probar otro ajuste
   • Si no está claro, esperar más antes de valorar

Este enfoque metódico evita confusiones sobre qué cambios provocaron qué efectos.

Mejores prácticas

Guarda vistas importantes

Aunque el panel no tiene marcadores integrados, puedes guardar páginas específicas en los marcadores de tu navegador:

• Marca la vista principal de tu Panel para acceder rápidamente
• Marca páginas específicas de gestión de grupos para las comunidades que revisas con frecuencia
• Marca el Live Punishment Feed si lo supervisas con regularidad

Los marcadores del navegador proporcionan acceso rápido sin tener que navegar por varios menús.

Usa la búsqueda de forma eficaz

Las funciones de búsqueda (grupos, usuarios) admiten coincidencias parciales y no distinguen entre mayúsculas y minúsculas:

• Busca grupos por nombre parcial: "cryp" encuentra "Cryptocurrency Discussion"
• Busca usuarios por nombre de usuario sin @: "john" encuentra "@johnsmith"
• Busca usuarios por palabras clave en la bio para encontrar cuentas relacionadas

Usar la búsqueda de forma eficaz acelera drásticamente la navegación en instalaciones grandes.

Revisa la experiencia en móviles

El panel es totalmente adaptable y funciona en dispositivos móviles, pero algunas funciones (especialmente las estadísticas con tablas) son más cómodas en pantallas grandes. Ten en cuenta lo siguiente:

• Usa el móvil para comprobaciones rápidas y cambios de activación/desactivación
• Usa ordenador/tablet para revisar estadísticas en profundidad y calibrar umbrales
• Usa el Live Punishment Feed en el móvil para supervisar sobre la marcha

Cada tipo de dispositivo destaca en distintas tareas administrativas.

Mantén la configuración documentada

Mantén un documento sencillo (hoja de cálculo, archivo de notas) donde registres:

• La configuración actual de umbrales para cada grupo
• El razonamiento detrás de configuraciones específicas
• Cuándo se cambiaron por última vez los ajustes
• Los resultados de los experimentos con umbrales

Esta documentación crea conocimiento institucional que perdura incluso si cambia la composición del equipo de moderación.

Solución de problemas

"No puedo ver mi grupo en el panel"

Causas: El bot no se ha añadido al grupo, no eres administrador, la autenticación no se ha actualizado

Solución: Verifica que el bot esté realmente en el grupo como miembro. Comprueba que tengas permisos de administrador en la configuración del grupo de Telegram. Prueba a cerrar sesión y volver a iniciarla para actualizar la autenticación.

"Los cambios no se guardan"

Causas: Problema de red, caché del navegador, cambios simultáneos

Solución: Actualiza la página para comprobar si el cambio se guardó realmente. Si no es así, prueba a activar o desactivar de nuevo la opción. Borra la caché del navegador si los problemas persisten. Asegúrate de tener una conexión a internet estable.

"Los medidores de uso muestran 'desconectado'"

Causas: Se perdió la conexión WebSocket, la pestaña del navegador estuvo inactiva demasiado tiempo

Solución: El panel debería reconectarse automáticamente en un plazo de 30 segundos. Si sigue desconectado, actualiza la página. Comprueba que el navegador no tenga activadas extensiones que bloqueen WebSocket.

"Las estadísticas parecen desactualizadas"

Causas: Retraso de la caché, los cambios recientes aún no se reflejan

Solución: Las estadísticas se actualizan casi en tiempo real, pero pueden tener retrasos de 30 a 60 segundos. Actualiza la página para asegurarte de estar viendo los datos más recientes. Si los datos tienen horas o días de antigüedad, esto indica un problema del sistema; informa al soporte.

"No puedo acceder al portal de facturación de Stripe"

Causas: No hay suscripción activa, el navegador bloquea la ventana emergente

Solución: La gestión del método de pago solo funciona con suscripciones de pago activas. Asegúrate de que tu navegador permita ventanas emergentes del dominio del panel. Prueba a usar el enlace directo desde la página del historial de facturación en lugar del botón.

Conclusión

El panel de administración de Telegram Bot App transforma la gestión de bots, pasando de complejas operaciones en la línea de comandos a flujos de trabajo intuitivos de apuntar y hacer clic, al tiempo que ofrece funciones avanzadas de análisis y supervisión que permiten una gestión de comunidades basada en datos. Ya sea que estés configurando reglas básicas de protección, calibrando umbrales de detección con AI, supervisando infracciones en tiempo real o analizando patrones de comportamiento de los usuarios, el panel te proporciona las herramientas que necesitas en una interfaz unificada y accesible.

Domina las funciones del panel para maximizar la eficacia de tu moderación y minimizar el tiempo invertido. La combinación de interruptores sencillos para tareas habituales y análisis detallados para decisiones estratégicas garantiza que administradores de todos los niveles puedan gestionar sus comunidades con éxito. Explora la interfaz, experimenta con la configuración mientras supervisas sus efectos mediante estadísticas y desarrolla flujos de trabajo administrativos que se ajusten a las necesidades únicas de tu comunidad.