Bots personalizados

Tu bot, tu marca. Los miembros ven tu nombre y tu avatar, no los nuestros. Descubre cómo funcionan los bots personalizados, qué permisos necesitan, los límites del plan y la seguridad.

Visión general

Todas las implantaciones de Restore Hub funcionan con un bot personalizado que tú creas y del que eres propietario. A diferencia de los bots de verificación compartidos, en los que todos los servidores muestran la misma marca, tu bot personalizado muestra el nombre que tú elijas, un avatar y (en Premium+) un estado personalizado en la lista de miembros.

Este enfoque le da el control total de la marca y elimina la preocupación de confianza de "este bot está en 50.000 servidores" que los miembros suelen tener con los bots compartidos. Tu bot es único para ti.

Lo que necesita

Para añadir un bot personalizado, necesitas cinco datos del Portal del Desarrollador de Discord (https://discord.com/developers/applications):

• ID de cliente - Se encuentra en la página de Información General. Es el identificador único de la aplicación/bot.
• Secreto de cliente - Se encuentra en OAuth2 → General. Haz clic en "Restablecer secreto" para generar uno nuevo. Solo se puede ver una vez.
• Bot Token - Se encuentra en Bot → Restablecer token. Esta es la credencial que autoriza todas las llamadas a la API.
• Clave pública - Se encuentra en Información General. Se utiliza para verificar las cargas útiles de interacción de Discord.
• Redirigir URI - La URL de devolución de llamada de OAuth2 (por ejemplo, https://restorehub.net/api/callback). Debe añadirse a la lista de redirecciones de OAuth2 en el portal para desarrolladores.

Atención: El Client Secret y el Bot Token se muestran sólo una vez cuando se generan. Si los pierdes, debes restablecerlos y generar unos nuevos. Restore Hub los encripta con AES-256 en reposo y nunca los muestra en el dashboard tras su creación.

Cómo funcionan las interacciones HTTP

Restore Hub utiliza el Interactions Endpoint de Discord en lugar del tradicional WebSocket Gateway. Cuando configuras un bot, Restore Hub te da una URL de endpoint única como:

https://restorehub.net/api/interactions/{botId}

Interacciones HTTP vs. Pasarela - Principales diferencias

Pega esta URL en el Portal del desarrollador de Discord en Información general → Interacciones URL de punto final. Discord lo verifica con un ping y, una vez confirmado, enruta todas las invocaciones de comandos de barra y clics de botón a este punto final como solicitudes HTTP POST.

Como no hay conexión Gateway, el bot no mantiene un WebSocket persistente. Esto tiene varias implicaciones:

• Sin punto de estado - El bot aparece en la lista de miembros sin el círculo verde/amarillo/rojo. Esto es intencional y se ve más limpio.
• No hay eventos de puerta de enlace en tiempo real desde el propio bot - El bot no recibe eventos en bruto como MESSAGE_CREATE o GUILD_MEMBER_ADD a través de su propio Gateway. Los eventos anti-nuke y anti-raid se reciben a través de una conexión Gateway separada a nivel de sistema.
• Menor consumo de recursos - Sin latidos WebSocket, sin lógica de reanudación/reconexión. Una petición HTTP por interacción.
• Mejor escalado - Restore Hub puede servir a miles de bots sin mantener miles de conexiones Gateway.
• Todas las operaciones de la API REST siguen funcionando - La asignación de roles, el kicking de miembros, la creación de canales, la obtención de copias de seguridad y la extracción utilizan la API REST de Discord, que no requiere una conexión Gateway.

Consejo: En los planes Premium+, puedes configurar una presencia de bot personalizada (texto de estado y actividad como "Jugando a la verificación" o "Vigilando a 5.000 miembros") incluso sin conexión a Gateway. Restore Hub lo gestiona mediante llamadas periódicas a la API REST.

Permisos de discordia necesarios

Al invitar a tu bot a un servidor de Discord, el enlace de invitación incluye un entero de permisos OAuth2. Restore Hub solicita los siguientes permisos:

| Permiso Necesario | Utilizado para
|---|---|---|
| Gestionar roles Necesario Asignar y eliminar el rol verificado (y otros roles durante pulls con asignación de roles)
| Expulsar miembros Recomendado Acciones de respuesta anti-nuke/anti-raid, comando /delunauthed, expulsiones de seguridad
| Prohibir miembros: Opcional: Acciones de respuesta anti-nuke, aplicación de /blacklist
| Ver canales | Obligatorio | Lectura de la estructura de canales para copias de seguridad | Lectura del historial de mensajes | Obligatorio
| Leer Historial de Mensajes | Requerido | Hacer copia de seguridad de mensajes en canales de texto | Gestionar Canales | Opcional
| Gestionar Canales | Opcional | Restaurar canales desde copias de seguridad (crear/eliminar canales) | Gestionar Gremio | Opcional
| Gestionar Guild | Opcional | Restaurar la configuración del servidor desde copias de seguridad | Gestionar Expresiones Guild | Opcional
| Gestionar Expresiones del Gremio | Opcional | Restaurar emojis y stickers desde copias de seguridad | Enviar Mensajes | Opcional | Restaurar canales desde copias de seguridad (crear / eliminar)
| Enviar mensajes | Opcional | Envío de mensajes de registro al canal de registro configurado | Crear invitación instantánea | Opcional
| Crear invitación instantánea | Opcional | Generar enlaces de invitación para la auto-tirada de alertas | Crear invitación instantánea | Opcional | Generar enlaces de invitación para la auto-tirada de alertas

Atención: El rol más alto del bot debe estar situado por encima del rol verificado en la jerarquía de roles del servidor. La discordia impide que los bots asignen roles superiores a su propio rol más alto.

Bots múltiples y límites de planes

Puede crear varios bots personalizados bajo una misma cuenta de Restore Hub. Cada bot puede ser asignado a diferentes servidores. Esto resulta útil si gestionas varias comunidades con diferentes marcas.

| Plan | Max Bots | Max Servers |
|---|---|---|
| Gratis 1 2
| Premium 5 10
| Business 25 50
| Enterprise Ilimitado Ilimitado

Consejo: Un único bot puede utilizarse en varios servidores. No necesitas un bot distinto para cada servidor a menos que quieras una marca diferente para cada comunidad.

Presencia y actividad de los robots

En Premium y superior, puedes configurar una presencia personalizada para tu bot. Esto controla el texto de estado y actividad que aparece en la lista de miembros.

| Configuración | Opciones |
|---|---|
| Estado: En línea, inactivo, No molestar, Invisible
| Tipo de actividad: Reproducir, Ver, Escuchar, Competir
| Texto de actividad Cualquier cadena (por ejemplo, "restorehub.net" o "Protegiendo a 10.000 miembros")

Cifrado y seguridad de tokens de bots

Todas las credenciales sensibles (token del bot, secreto del cliente) se cifran en reposo utilizando AES-256 con una clave de cifrado maestra almacenada en variables de entorno, nunca en la base de datos. Cuando Restore Hub necesita realizar una llamada a la API en nombre de tu bot, descifra el token en memoria, lo utiliza y descarta el texto sin formato.

Los tokens son de sólo escritura en el panel de control. Tras la configuración inicial, puede ver el ID de cliente y el URI de redirección (que no son sensibles), pero el token de bot y el secreto de cliente nunca se muestran. Si necesitas actualizarlos, debes introducir nuevos valores.

Lo que no pueden hacer los robots personalizados

Dado que Restore Hub utiliza interacciones HTTP en lugar del Gateway, hay algunas cosas que el bot no puede hacer por sí solo:

• No puede escuchar eventos de mensajes sin procesar - El bot no ve los mensajes tal y como se envían. Las copias de seguridad de los mensajes se obtienen a través de la API REST bajo demanda.
• No puede mostrar indicadores de escritura en tiempo real ni responder automáticamente a los mensajes - No Gateway significa que no hay eventos MESSAGE_CREATE.
• No se puede detectar la actividad del canal de voz - Las actualizaciones del estado de voz requieren una conexión a la pasarela.
• No puede ejecutarse continuamente en segundo plano: el bot sólo se "despierta" cuando un usuario activa una interacción o cuando Restore Hub realiza una llamada a la API REST.

Consejo: Estas limitaciones no afectan a la funcionalidad principal. La verificación, la asignación de roles, la extracción, las copias de seguridad y todas las funciones de seguridad funcionan perfectamente a través de la API REST y el punto final de interacciones.

Comandos Slash (Premium+)

En Premium y superior, tu bot soporta comandos de barra que los administradores de servidor pueden usar directamente en Discord. Restore Hub registra estos comandos globalmente en tu bot. Comandos disponibles:

| Comando | Descripción |
|---|---|
| /setup | Configurar el bot en el servidor actual (establecer rol verificado, canal de registro, etc.) | | /verify-embed | Publicar un botón de verificación incrustado en el canal actual
| /verify-embed | Publicar un botón de verificación incrustado en el canal actual | /pull | Iniciar la verificación en el canal actual
| /pull | Iniciar un pull de miembros desde este servidor a un servidor de destino | /backup | Crear una copia de seguridad del bot
| /backup | Crear una copia de seguridad manual del servidor actual | /restore | Restaurar el canal actual
| Restaurar una copia de seguridad del servidor actual
| /usercount | Mostrar cuántos miembros verificados y pullables hay en este servidor | /info | Mostrar la lista de miembros verificados y pullables en este servidor
| /info | Mostrar información del bot, tiempo de actividad y detalles del plan | /blacklist | Mostrar información del bot, tiempo de actividad y detalles del plan
| /blacklist | Poner en la lista negra a un usuario de Discord para que no pueda verificarse en todos tus servidores | /unblacklist | Mostrar el número de usuarios verificados en este servidor
| Eliminar un usuario de la lista negra
| /whitelist | Añadir una regla de lista blanca para saltarse las comprobaciones de seguridad | /massrole | Añadir un usuario a la lista blanca para saltarse las comprobaciones de seguridad
| Asignar un rol a todos los miembros verificados
| /unrole | Eliminar un rol de todos los miembros verificados | /unrole | Eliminar un rol de todos los miembros verificados
| /delunauthed | Dar de baja a todos los miembros que no se han verificado | /unrole | Eliminar un rol de todos los miembros verificados
| /deluser | Eliminar a un miembro verificado específico y revocar su rol | | /stats | Mostrar las estadísticas de los miembros verificados
| /stats | Mostrar estadísticas de verificación del servidor y datos del embudo | /alerts | Configurar alertas
| /alerts | Configurar alertas nuke/raid/borrado con notificaciones por correo electrónico y webhook | /firewall | Gestionar el cortafuegos
| /firewall | Gestionar reglas de cortafuegos (añadir/eliminar IP, país, ASN, etc.) |