Cómo añadir verificación o captcha para nuevos miembros de Discord

Antes de empezar

• Activa el módulo Welcome incluido en Free en un bot online y un servidor de prueba. Usa una cuenta de personal con Manage Server para configurarlo mediante el comando welcome. Prepara una entrada controlada de un miembro nuevo para la prueba.
• Crea roles normales llamados, por ejemplo, Unverified y Verified, por debajo del rol más alto del bot, y dale Manage Roles al bot. Elige un canal de bienvenida que la persona nueva pueda ver y que el bot pueda ver y usar para enviar mensajes y embeds.
• Planifica los permisos para que @everyone y Unverified no accedan a canales solo para miembros y Verified conceda el acceso previsto. Revisa otros módulos, listas de autorroles y paneles para que no concedan ese acceso antes de la verificación.

1. Elige un canal de bienvenida visible

   En Welcome Settings, selecciona el servidor y el canal de bienvenida. En Discord, !welcome channel #welcome lo establece usando una mención de canal real; quien lo ejecuta necesita Manage Server. Sustituye ! por el prefijo del bot. El aviso es un mensaje del servidor, no un MD privado, así que debe ser accesible para las personas nuevas.

   Establece el canal explícitamente para evitar un destino inesperado. Sin un canal configurado utilizable, el módulo busca un canal de texto llamado welcome, welcome-goodbye o greetings, puede crear uno si está activada la creación automática y, si no, usa el canal de sistema del servidor. Si no puede encontrar un canal o enviar el aviso, la persona nueva no puede completar el desafío. Comprueba View Channel, Send Messages y Embed Links antes de activarlo.

2. Configura los roles y activa el desafío

   En Discord, usa !welcome captcha-role @Verified para elegir el rol de una respuesta correcta y !welcome unverified-role @Unverified para elegir el rol previo al desafío. Son subcomandos de welcome, requieren Manage Server y aceptan menciones reales de roles. El asistente interactivo !welcome setup también pregunta por captcha y los dos roles. El panel muestra Enable captcha verification; usa la configuración de Discord anterior para establecer los roles específicos.

   Cuando roles y permisos estén listos, activa Enable captcha verification en el panel y guarda. En Discord, !welcome captcha, también !welcome verify, alterna el estado actual: no es un comando idempotente para activar, así que lee el resultado antes de repetirlo. La verificación está desactivada de forma predeterminada y los dos ajustes de roles empiezan vacíos.

   Con captcha activado, Welcome omite la asignación inmediata de autorrol al entrar. Una respuesta correcta da el rol captcha configurado o, si no existe, usa como alternativa el ID de autorrol guardado, incluso si el interruptor normal de autorrol está apagado. Elige el rol verificado explícitamente. Esto solo controla las asignaciones de Welcome; otro módulo puede conceder un rol de forma independiente.

3. Entiende lo que ve la persona nueva

   Cuando entra un miembro que no es bot, el módulo guarda un desafío pendiente y añade el rol sin verificar configurado, si existe. Publica una mención de esa persona, un embed Verification Required, una pregunta de suma y botones numéricos. Cada sumando va de 1 a 10. El desafío no pide escribir un código, leer una imagen ni visitar una web.

   Solo puede responder la persona nombrada por ese desafío. Una elección errónea obtiene una respuesta privada “Wrong answer! Please try again.” Cuando hay un canal de revisión de personal, los errores están limitados a tres intentos por defecto; tras el último, el miembro queda sin verificar y se envía el mismo aviso de revisión. Una respuesta correcta borra el desafío pendiente, intenta quitar Unverified y añadir el rol verificado o alternativo, y sustituye el aviso por un mensaje de éxito sin embed ni botones.

4. Configura opcionalmente revisión por antigüedad de cuenta

   En Welcome Automation, activa “Hold young accounts for staff review”, elige 1, 3, 7, 14 o 30 días e introduce el ID de un canal de revisión. Cuando entra una cuenta más joven, Welcome la mantiene sin verificar si configuraste Unverified y publica su antigüedad y hora de entrada para el personal. El personal con Manage Server puede elegir Approve, que concede el rol verificado, o Kick si el bot tiene Kick Members. Sin ese permiso, la revisión muestra Approve y explica que no puede expulsar.

   Es un flujo limitado de retener y revisar. La edad de la cuenta y los desafíos fallidos no demuestran que una cuenta sea alternativa, humana, segura o maliciosa. Free admite un canal de revisión. Pro añade varios canales de revisión y una lista de IDs de roles que omite solo la retención por antigüedad.

5. Planifica el límite de cinco minutos y los cambios de rol fallidos

   Tras publicar correctamente un aviso, un temporizador de cinco minutos intenta borrar el mensaje y elimina el desafío pendiente. No expulsa ni banea al miembro, no concede el rol verificado, no quita el rol sin verificar ni crea otro aviso. Quien no responda conserva Unverified si se asignó. Organiza una vía de ayuda para el personal: el módulo no registra un comando para reenviar un desafío caducado.

   Las respuestas pendientes se guardan en memoria, así que un reinicio del bot las pierde. Si el miembro abandona el servidor, también se borra su entrada pendiente. Las adiciones y eliminaciones de roles tras una respuesta correcta capturan errores de Discord sin detener el mensaje de éxito. Por eso “has been verified” no prueba que los roles ni el acceso hayan cambiado: inspecciona ambos, sobre todo si el bot no tiene Manage Roles o su rol queda por debajo de alguno de los roles objetivo.

6. Prueba una entrada real y mantén claros los planes

   Usa una cuenta de prueba controlada por el personal que entre al servidor. Confirma que recibe Unverified, ve el aviso de bienvenida y no ve los canales protegidos. Pulsa una respuesta errónea y después la correcta; inspecciona sus roles y acceso. En otra entrada controlada, deja el aviso sin responder cinco minutos y confirma el comportamiento esperado. !testwelcome solo envía una muestra de bienvenida; no inicia un desafío de verificación.

   Welcome es Free: su desafío matemático, intentos limitados y un canal de revisión no tienen una comprobación Pro independiente. La salida de bienvenida de Free es texto o embed. Pro añade tarjetas de bienvenida con imagen, varios canales de revisión y una lista de roles para antigüedad de cuentas, no captchas de imagen ni detección de cuentas alternativas. Ambos planes usan la misma caducidad de cinco minutos y pierden desafíos pendientes al reiniciar.