Перейти к содержанию
Noko

Установка

Следуйте этим шагам, чтобы правильно установить скрипт на вашем боте.

Этапы установки

Раздел с заголовком «Этапы установки»

  1. Скачайте модуль и распакуйте папку

    Получите папку модуля (обычно в формате .zip или .rar) с официального источника.
    Используйте инструмент вроде WinRAR или 7‑Zip, чтобы извлечь папку скрипта на ваш компьютер.

  2. Создание токена Bearer для Twitter

    • Вход на платформу разработчиков Twitter
      Перейдите на: Dashboard, чтобы войти или создать аккаунт для доступа к консоли разработчика.
      Если вы делаете это впервые, вам потребуется выбрать подписку или нажать Sign up for Free Account.
      Опишите цель использования API; например (на английском):

      Retrieving a user’s ID allows us to access their recent tweets, analyze updates in real time, and automatically share them on our Discord server. This keeps the community informed of the latest messages and activities. All while linking back to Twitter so they can comment on the messages.


      Отметьте необходимые чекбоксы и нажмите Submit.

    • Получение bearer‑токена для вашего приложения
      Перейдите на страницу: Projects and apps


      У вас должен быть создан проект (имя может быть автосгенерировано). Заметьте, что при бесплатной подписке у вас права только на одно приложение.


      На странице проекта нажмите шестерёнку App Settings, затем Keys and tokens.
      В разделе Authentication Tokens нажмите Generate для создания Bearer Token.
      Bearer‑токен будет показан — скопируйте его в файл .env.


    • ⚠️ Если вы не планируете платить, существует квота запросов на каждые 15 минут
      Через модуль можно добавить до 1 аккаунта Twitter. Для большего количества аккаунтов настройте квоты на странице Quotas.

  3. Настройте переменные окружения

    Откройте файл .env, поставляемый со скриптом, и добавьте/измените необходимые переменные окружения для корректной работы модуля.

    • twitterChannelID : ID канала, в который будут отправляться уведомления о твитах
    • twitterRoleID : ID роли пользователей, желающих получать уведомления (обычно роль «участник» или отдельная роль, которую пользователи могут выбрать)
    • twitterTokenBearer : Bearer‑токен Twitter API (см. шаг 2)
    • twitterChannelFollowerID : ID голосового канала, название которого будет обновляться в соответствии с числом подписчиков (настройка учётной записи происходит в коде, см. следующий шаг)

  4. Скопируйте/переместите файлы/код в ваш проект

    Скопируйте следующие файлы в соответствующие папки вашего проекта Discord‑бота:

    • commands/notification/notification-add.js : в папку команд
    • commands/notification/notification-list.js : в папку команд
    • commands/notification/notification-remove.js : в папку команд
    • utils/notification/twitter.js : в папку утилит
    • utils/utils.js : в папку утилит

    Также вставьте код инициализации модуля в ваш основной файл index.js.
    В нашем файле Prisma связан напрямую с объектом client — поместите этот код в свой проект или адаптируйте в соответствии с вашей интеграцией Prisma.

    ❗ При желании вы можете изменить константу PSEUDO_UPDATE_CHANNEL_STAT, чтобы обновлять статистический канал, либо закомментировать соответствующую строку.
    Псевдоним должен совпадать с тем, что хранится в базе данных.

    Изображение уведомления Twitter

  5. Обновите схему базы данных

    Добавьте модель данных для получения уведомлений Twitter в файл prisma/schema.prisma и выполните необходимые миграции для применения изменений в базе данных.
    Выполните команды:

    Окно терминала
    npx prisma generate
    

    npx prisma migrate dev --name add_twitter_notification

  6. Установите зависимости

    Убедитесь, что необходимые зависимости установлены, проверив package.json и выполнив:

    Окно терминала
    npm install

  7. Перезапустите бота

    Перезапустите бота, чтобы скрипт подхватился.


Советы

Раздел с заголовком «Советы»
  • Для команды /notification-add необходимо ввести имя аккаунта Twitter, как оно указано в URL страницы.
    Пример: https://x.com/JoycaOff
    => Имя, которое нужно ввести при использовании команды: JoycaOff (без @).