Nightbot Regulars: Qué Son y Cómo Gestionarlos

En el vibrante mundo del streaming, construir una comunidad sólida es tan importante como el contenido que creas. Tus espectadores son el alma de tu canal, y reconocer a aquellos que te apoyan día tras día es fundamental para fomentar la lealtad y un ambiente positivo. Herramientas como Nightbot son esenciales para la moderación y la interacción, pero ¿sabías que ofrece una función específica para premiar a tus seguidores más fieles? Hablamos del nivel de usuario 'Regular'. Este artículo es una guía completa para que entiendas qué son los Regulars, por qué deberías usarlos y cómo puedes gestionarlos a través de la API de Nightbot para llevar tu canal al siguiente nivel.

¿Qué es Exactamente un 'Regular' de Nightbot?

Dentro del ecosistema de permisos de Nightbot, un 'Regular' es un nivel de usuario especial que se sitúa por encima de un espectador normal ('everyone') y un suscriptor de pago, pero por debajo de un moderador. Es una etiqueta que, como dueño del canal, puedes otorgar manualmente a los miembros de tu comunidad que consideres más valiosos, leales y participativos.

Piensa en ellos como los veteranos de tu chat, esas personas que siempre están ahí, que contribuyen positivamente a la conversación y que ayudan a los nuevos espectadores. Otorgarles el estatus de 'Regular' no solo es un reconocimiento simbólico, sino que también les concede privilegios especiales que mejoran su experiencia en tu canal.

La Jerarquía de Poder: Niveles de Usuario en Nightbot

Para entender mejor dónde se ubican los Regulars, es útil visualizar la jerarquía completa de niveles de usuario que maneja Nightbot. Los permisos fluyen de arriba hacia abajo, lo que significa que un nivel superior hereda todos los permisos de los niveles inferiores.

Aquí tienes una tabla comparativa para que quede más claro:

Como puedes ver, el nivel 'Regular' es un escalón importante que te permite diferenciar y premiar a miembros clave de tu audiencia sin necesidad de darles los poderes completos de un moderador.

Beneficios de Usar el Nivel de Usuario 'Regular'

Implementar un sistema de Regulars en tu canal puede traer consigo múltiples ventajas:

• Permisos Exclusivos: Puedes configurar comandos personalizados para que solo puedan ser ejecutados por Regulars o niveles superiores. Esto es perfecto para crear comandos divertidos o útiles que se sientan como una recompensa.
• Inmunidad al Spam: Los Regulars pueden ser eximidos de ciertos filtros de protección contra spam. Por ejemplo, puedes permitirles publicar enlaces o usar más mayúsculas sin ser sancionados por Nightbot, confiando en su buen juicio.
• Fomento de la Lealtad: Al reconocer públicamente a un espectador como 'Regular', validas su contribución y le haces sentir una parte más importante de la comunidad. Esto incentiva la participación continua y la lealtad a largo plazo.
• Mejora del Ambiente del Chat: Los Regulars a menudo actúan como ejemplos positivos para el resto del chat. Su comportamiento puede influir en los demás espectadores, ayudando a mantener un ambiente amigable y acogedor.

Guía Técnica: Gestión de Regulars con la API de Nightbot

Si bien puedes gestionar tus Regulars desde el panel de control de Nightbot, la verdadera potencia para integraciones y automatización reside en su API (Interfaz de Programación de Aplicaciones). La API permite que diferentes aplicaciones se comuniquen con Nightbot para ver, añadir o eliminar Regulars de forma programática. A continuación, desglosamos los endpoints específicos para esta tarea.

Nota: Para usar la API, necesitarás autenticarte usando el flujo OAuth 2 y solicitar el 'scope' o permiso llamado `regulars`. Esto garantiza que solo tú (o las aplicaciones a las que des permiso) puedas modificar tu lista de Regulars.

1. Obtener la Lista Completa de tus Regulars

Para ver todos los usuarios que has designado como Regulars, puedes hacer una petición al siguiente endpoint.

• Método HTTP:GET
• Endpoint:https://api.nightbot.tv/1/regulars

Esta petición te devolverá una lista con todos tus usuarios regulares. Además, puedes usar parámetros adicionales para filtrar o paginar los resultados:

• limit: Un número entre 1 y 100 para definir cuántos regulars quieres ver por página.
• offset: El número de regulars que quieres saltar, útil para la paginación.
• q: Un término de búsqueda para encontrar a un regular por su nombre de usuario (displayName).

La respuesta incluirá información valiosa de cada regular, como su _id único, su nombre (name y displayName), la plataforma (provider) y la fecha en que fue añadido.

2. Añadir un Nuevo Regular

Para nombrar a un nuevo usuario como Regular, debes enviar una petición con el nombre del usuario.

• Método HTTP:POST
• Endpoint:https://api.nightbot.tv/1/regulars

El cuerpo de la petición debe incluir un único parámetro requerido:

• name: El nombre de usuario de la persona que quieres añadir. En el caso de YouTube, sería la URL de su canal.

Si la operación es exitosa, la API te devolverá los datos del regular recién creado, incluyendo su _id, que será crucial si más adelante quieres consultarlo o eliminarlo.

3. Consultar un Regular Específico por su ID

Si ya conoces el ID de un regular (obtenido al añadirlo o al listar todos), puedes obtener su información específica.

• Método HTTP:GET
• Endpoint:https://api.nightbot.tv/1/regulars/:id

Debes reemplazar :id con el ID alfanumérico del regular que deseas consultar. Esto es útil para verificar los datos de un usuario en particular.

4. Eliminar un Regular

Si necesitas revocar el estatus de Regular a un usuario, puedes hacerlo fácilmente usando su ID.

• Método HTTP:DELETE
• Endpoint:https://api.nightbot.tv/1/regulars/:id

Al igual que en la consulta, reemplaza :id con el ID del regular que quieres eliminar. Una vez hecho, ese usuario volverá a tener los permisos de un espectador normal (o de suscriptor, si lo es).

Preguntas Frecuentes (FAQ)

¿Puedo añadir Regulars masivamente a través de la API?

La API está diseñada para añadir usuarios uno por uno a través del endpoint POST /1/regulars. Si necesitas añadir muchos, tendrías que crear un script que realice una petición por cada usuario que desees agregar.

¿Cómo obtengo el ID de un Regular para eliminarlo?

El _id de un regular se obtiene de dos maneras: es devuelto en la respuesta de la API cuando añades un nuevo regular, o puedes obtenerlo consultando la lista completa de tus regulars con el endpoint GET /1/regulars.

¿Un 'Regular' tiene más permisos que un suscriptor de Twitch/YouTube?

Sí. Según la jerarquía oficial de Nightbot, el nivel 'regular' está por encima del nivel 'subscriber'. Esto significa que si configuras un comando para que sea accesible solo para 'regulars', un suscriptor que no sea también 'regular' no podrá usarlo.

¿Necesito ser programador para usar estos endpoints de la API?

Si bien la API está pensada para desarrolladores, no es estrictamente necesario ser uno para realizar peticiones básicas. Herramientas como Postman, Insomnia o incluso la línea de comandos con cURL te permiten interactuar con la API siguiendo guías como esta. Sin embargo, un conocimiento básico de cómo funcionan las peticiones HTTP es muy recomendable.

Conclusión

El sistema de Regulars de Nightbot es una herramienta increíblemente útil y a menudo subestimada para la gestión de comunidades de streaming. No solo te permite mantener un chat más ordenado y seguro, sino que también te ofrece una forma tangible de reconocer y recompensar a los pilares de tu audiencia. Ya sea que los gestiones a través del panel de control o aproveches la flexibilidad de la API para crear herramientas personalizadas, integrar a los Regulars en tu estrategia de comunidad es un paso seguro hacia la construcción de un canal más fuerte, leal y comprometido. ¡Empieza a reconocer a tus veteranos hoy mismo!