Instalación

Sigue estos pasos para instalar correctamente el script en tu bot.

Precaución

Estas instrucciones suponen que ya tienes un bot de Discord funcional y que sabes cómo agregar scripts a tu bot.

Pasos de instalación

1. Descarga el módulo y descomprime la carpeta

   Obtén la carpeta del módulo (a menudo en formato .zip o .rar) desde la fuente oficial. Utiliza una herramienta como WinRAR o 7-Zip para extraer la carpeta del script en tu computadora.

2. Creación de tus claves API de YouTube

   • Iniciar sesión en la plataforma de desarrolladores de Google
     Ve a: Dashboard para iniciar sesión o crear una cuenta para acceder al dashboard.
   
   
   • Crear un proyecto
     Haz clic en Crear proyecto, luego ingresa el nombre de tu proyecto y confirma la creación.
   
   
   • Activación de la API de YouTube en tu cuenta de Google
     Ve a: API de YouTube para activar la API de Google.
   
   

   • Creación de tu aplicación
     Haz clic en Credenciales o ve a este enlace: Credenciales

     
     

     Haz clic en Crear credenciales, luego elige Claves API

     
     

     Completa los siguientes campos:

     • Nombre (el nombre de tu aplicación, por ejemplo: BotYoutube)
     • Restricciones de la aplicación => Direcciones IP y escribe la dirección IP de tu VPS/tu máquina
     • En la parte de restricciones de API, selecciona YouTube Data API v3

     Luego confirma la creación. Una clave se mostrará para que puedas ponerla en el archivo .env.

   
   
   • ⚠️ Si no deseas pagar, tienes un límite de cuotas por día
     A través del módulo puedes agregar hasta 5 cuentas de YouTube. Si deseas más, tendrás que ajustarlo en la página Cuotas
   
   

   Precauciones!

   ¡Mantén esta información segura! 🔒
   ¡Nunca compartas tu clave con nadie!
   Este identificador se utiliza para autenticar tu aplicación con YouTube y obtener respuestas a tus solicitudes.

3. Configura las variables de entorno

   Abre el archivo .env proporcionado con el script y agrega y modifica las variables de entorno necesarias para el correcto funcionamiento del módulo.

   • youtubeChannelID : ID del canal donde se enviarán las notificaciones de YouTube
   • youtubeRoleID : ID del rol de las personas que desean recibir las notificaciones (Generalmente el rol de miembro para notificar a todo el servidor o un rol creado por ti para que los miembros elijan este rol para ser avisados de un nuevo video)
   • youtubeAPIKey : La clave de la API de YouTube (Ver paso 2)
   • youtubeChannelFollowerID : ID del canal de voz que se actualizará respecto al número de seguidores (Configura la cuenta en el código, ver el siguiente paso)

4. Copia/mueve los archivos/códigos a tu proyecto

   Copia los siguientes archivos en las carpetas apropiadas de tu proyecto de bot de Discord:

   • commands/notification/notification-add.js : en la carpeta de tus comandos
   • commands/notification/notification-list.js : en la carpeta de tus comandos
   • commands/notification/notification-remove.js : en la carpeta de tus comandos
   • utils/notification/youtube.js : en la carpeta de tus utilidades
   • utils/utils.js : en la carpeta de tus utilidades

   También copia el código de indexación del módulo en tu archivo index.js principal. En este archivo, hemos agregado prisma directamente relacionado con el objeto “client”, coloca este código en el tuyo o ajústalo según tu forma de usar prisma.

   ❗ Si lo deseas, puedes modificar PSEUDO_UPDATE_CHANNEL_STAT para actualizar el canal de estadísticas o comentar esta línea. El seudónimo debe ser el mismo que el registrado en la base de datos.

   

5. Actualiza el esquema de la base de datos

   Agrega el modelo de datos para la recuperación de notificaciones de nuevos videos de YouTube en tu archivo prisma/schema.prisma y ejecuta las migraciones necesarias para aplicar los cambios a tu base de datos. Ejecuta el siguiente comando:

   npx prisma generate
   
   npx prisma migrate dev --name add_youtube_notification

6. Instala las dependencias

   Asegúrate de que las dependencias necesarias estén instaladas verificando tu package.json y ejecutando:

   npm install

7. Reinicia el bot

   Reinicia tu bot para que el script sea tomado en cuenta.

Modificar los permisos de los comandos

Accede a tu servidor, luego ve a Configuración del servidor > Integraciones. En la sección Bots y aplicaciones, haz clic en tu bot.

En la pestaña Comandos, puedes agregar excepciones para gestionar los permisos de los diferentes comandos añadidos por nuestro módulo.

Si no configuras estos permisos, todos los miembros de tu servidor tendrán acceso a los comandos del módulo.

Consejos

• Para el comando /notification-add, debes ingresar el nombre del canal de YouTube que se indica en la URL del canal. Ejemplo: https://www.youtube.com/@Joyca => El nombre a ingresar al usar el comando es Joyca (sin el @).