Primeros pasos

Configura tu primer bot personalizado, conecta un servidor de Discord y empieza a verificar miembros en menos de 10 minutos. Esta guía te guía a través de cada paso desde cero hasta un enlace de verificación funcional.

Requisitos previos

Antes de empezar, asegúrate de tener lo siguiente: una cuenta de Discord, permisos de propietario o administrador en el servidor de Discord que quieres proteger y una cuenta de RestoreHub (regístrate en restorehub.net con Discord, Google, GitHub, Apple o correo electrónico/contraseña).

Restore Hub funciona con un modelo de bot personalizado. En lugar de añadir un bot compartido que usan miles de servidores, tú creas tu propia aplicación de Discord y le das las credenciales a Restore Hub. Esto significa que tus miembros verán tu nombre de bot y tu avatar, no los nuestros.

Consejo: Puedes empezar por completo con el plan Gratuito. Las cuentas gratuitas incluyen 1 bot personalizado, 2 servidores, 3 copias de seguridad y verificación del núcleo. Las funciones premium como la detección VPN, la detección alt y el cortafuegos requieren una actualización.

Paso 1 - Crear una aplicación Discord

Cada bot de Restore Hub comienza como una aplicación estándar de Discord. Lo crearás en el Portal del Desarrollador de Discord y luego entregarás las credenciales a Restore Hub.

1. Abrir el portal para desarrolladores - Navega hasta https://discord.com/developers/applications en tu navegador. Inicia sesión con tu cuenta de Discord si se te solicita.
2. Crear una nueva aplicación - Haz clic en el botón "Nueva aplicación" en la esquina superior derecha. Dale un nombre (este será el nombre para mostrar del bot en tu servidor) y acepta las Condiciones de servicio para desarrolladores de Discord.
3. Copie el ID de la aplicación (cliente) - En la página "Información general", busque el campo ID de aplicación. Haz clic en "Copiar" y guárdalo en algún sitio; lo pegarás en Restore Hub en breve.
4. Copiar la clave pública - Todavía en "Información General", copia la Clave Pública. Restore Hub la utiliza para verificar que las cargas útiles de interacción entrantes proceden realmente de Discord.
5. Generar el secreto de cliente - Vaya a la sección "OAuth2" en la barra lateral izquierda. En "Información del cliente", haz clic en "Restablecer secreto" y confirma. Copia el secreto inmediatamente - Discord solo lo muestra una vez.
6. Crear el usuario Bot y copiar el Token - Vaya a "Bot" en la barra lateral izquierda. Haz clic en "Restablecer token" y confirma. Copia el token del bot y guárdalo de forma segura. Este token da el control total del bot, así que nunca lo compartas públicamente.
7. Activar intenciones privilegiadas - Desplácese hacia abajo en la página Bot hasta "Privileged Gateway Intents". Activa Server Members Intent (necesario para la extracción y las copias de seguridad de los miembros) y Message Content Intent (necesario para las copias de seguridad de los mensajes). Haga clic en "Guardar cambios".

Advertencia: Tu bot token y secreto de cliente son credenciales sensibles. Nunca las pegues en mensajes de Discord, repos públicos o capturas de pantalla. Restore Hub las encripta con AES-256 en reposo y nunca las muestra después de la configuración inicial.

Paso 2 - Establezca el URI de redireccionamiento de OAuth2

Discord requiere que pongas en la lista blanca la URL exacta a la que los usuarios son redirigidos después de autorizarse con OAuth2. Restore Hub necesita esta configuración para que funcione la verificación.

1. Ir a Redirecciones OAuth2 - En el Portal del desarrollador, vaya a OAuth2 → General. Desplácese hasta "Redirecciones".
2. Añada la URL de devolución de llamada de Restore Hub - Haz clic en "Añadir redirección" e introduce: https://restorehub.net/api/callback. Si tiene previsto utilizar un dominio personalizado (por ejemplo, verify.sudominio.com), añada también https://verify.yourdomain.com/api/callback. Haz clic en "Guardar cambios".

https://restorehub.net/api/callback

Consejo: Puede añadir varios URI de redirección. Añada tanto la devolución de llamada de restorehub.net como las devoluciones de llamada de dominios personalizados que tenga previsto utilizar.

Paso 3 - Añade tu bot a Restore Hub

Ahora que ya tienes configurada tu aplicación Discord, introduce las credenciales en Restore Hub utilizando el asistente de configuración del bot en 5 pasos.

1. Abra la página de robots personalizados - Inicie sesión en restorehub.net. En la barra lateral del panel de control, haz clic en "Bots personalizados" y, a continuación, en "Añadir bot".
2. Pegue sus credenciales (Asistente Paso 1 de 5) - Introduzca el bot token, el ID de cliente, el secreto de cliente, la clave pública y el URI de redirección. Restore Hub valida cada campo en tiempo real.
3. Configurar el punto final de interacciones (Asistente, paso 2 de 5) - RestoreHub genera una URL de punto final de interacciones única para su bot (por ejemplo, https://restorehub.net/api/interactions/{botId}). El asistente le proporciona esta URL y le indica que la pegue en el portal del desarrollador de Discord, en Información general → URL del punto final de interacciones. Discord envía un ping de verificación - RestoreHub responde automáticamente. Una vez que Discord muestre una marca de verificación verde, continúe.
4. Establezca su URL de verificación (Asistente Paso 3 de 5) - Elija entre una URL basada en slug (restorehub.net/s/su-comunidad) o un dominio personalizado (verify.sudominio.com). Los slugs son instantáneos; los dominios personalizados requieren un registro CNAME (tratado en el documento Dominios personalizados).
5. Invitar a un servidor (Asistente Paso 4 de 5) - El asistente genera un enlace de invitación OAuth2 con los permisos correctos (Gestionar Roles, Echar Miembros, Ver Canales, Leer Historial de Mensajes). Haz clic en "Invitar al servidor", selecciona tu servidor de Discord en el menú desplegable y autorízalo.
6. Configurar los ajustes del servidor (Asistente Paso 5 de 5) - Seleccione el rol Verificado que los miembros reciben después de pasar la verificación. Si lo desea, establezca un canal de registro para los eventos de verificación, active el captcha, establezca la edad mínima de la cuenta y active las funciones de seguridad.

Paso 4 - Compartir el enlace de verificación

Tu bot ya está activo. Comparte la URL de verificación con tus miembros. Puedes publicarla en un canal, ponerla en la descripción de tu servidor o utilizar el comando /verify-embed para crear un botón incrustado en cualquier canal.

Cuando un miembro hace clic en el enlace, se le dirige a tu página de verificación personalizada. Hacen clic en "Verificar", se autorizan con Discord OAuth2 (otorgando ámbitos de identificación, correo electrónico, gremios y gremios.join) y se les asigna automáticamente el rol verificado en tu servidor.

Consejo: Utiliza el comando /verify-embed (Premium+) para publicar una verificación limpia incrustada con un botón directamente en un canal de Discord. Los miembros hacen clic en el botón y son redirigidos a la página de verificación.

Lo que ocurre entre bastidores

Los bots de Restore Hub utilizan el punto final de interacciones basado en HTTP de Discord, no la pasarela WebSocket tradicional. Esta es una distinción arquitectónica importante que afecta a cómo se comporta el bot.

Con el enfoque Gateway, un bot mantiene una conexión WebSocket persistente con Discord y recibe todos los eventos en tiempo real (mensajes, reacciones, uniones de miembros, etc.). Esto requiere una infraestructura siempre activa y muestra un punto de estado verde/amarillo/rojo junto al bot en la lista de miembros.

Con el enfoque de punto final de interacciones (que utiliza Restore Hub), Discord envía solicitudes HTTP POST a la URL del punto final de tu bot sólo cuando un usuario activa un comando de barra o una interacción de botón. No hay conexión persistente. El bot aparece en la lista de miembros sin un punto de estado: limpio y profesional.

Todas las demás operaciones (asignación de roles, extracción de miembros, creación de copias de seguridad, expulsión de miembros) se realizan a través de la API REST de Discord utilizando el token del bot. Esto significa que Restore Hub puede escalar a miles de bots sin mantener miles de conexiones WebSocket.

Resumen de los límites del plan

| Característica | Gratuito | Premium | Negocios | Empresa
|---|---|---|---|---|
| Servidores 2 10 50 ilimitados
| Bots personalizados 1 5 25 Ilimitado
| Copias de seguridad 3 10 30 50
| Mensajes/Copia de seguridad: 50, 200, 500, 2.000
| Enfriamiento 6 horas 1 hora 15 min Ninguno
| Detección de VPN: No, Sí, Sí
| Detección Alt No Sí Sí Sí Sí
| Cortafuegos No Sí Sí Sí Sí
| Anti-Nuke No No Sí Sí Sí
| Anti-Raid No No Sí Sí Sí
| Dominio personalizado No No Sí Sí Sí
| Copias de seguridad programadas No Sí Sí Sí Sí
| Comandos de barra oblicua No Sí Sí Sí Sí
| Gestión de equipos No No Sí Sí Sí
| Límite de velocidad de la API 20/10s 50/10s 100/10s 200/10s

Próximos pasos

• Lee la documentación sobre bots personalizados para entender cómo funcionan las interacciones HTTP y qué permisos necesita tu bot.
• Lea el documento Verificación para conocer todas las comprobaciones de seguridad del flujo de verificación.
• Lee el documento de Seguridad para activar la detección VPN, detección alt, reglas de firewall, anti-nuke y anti-raid.
• Lea el documento Copias de seguridad para configurar las instantáneas del servidor y las copias de seguridad programadas.
• Lea el documento "Extracción de miembros" para saber cómo mover miembros verificados entre servidores.
• Lee la documentación de Dominios Personalizados si quieres verificar.tudominio.com en lugar de una URL slug.
• Lea la documentación de la API REST si desea integrar Restore Hub con sus propias herramientas o cuadros de mando.