Bridgero
В приложение

Инструкция

Как пользоваться Bridgero

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

1. Вход и пользователи

  1. Откройте главную страницу Bridgero и войдите в свой аккаунт.
  2. Если база пустая, первый посетитель создаёт первого администратора.
  3. После этого новые аккаунты создаются только администратором через кнопку Создать пользователя.

2. Подключение Telegram

  1. По умолчанию используется общий бот @Bridgero_Bot.
  2. Добавьте его в нужный чат или группу и выдайте права администратора.
  3. Если хотите своего бота: создайте бота в BotFather, откройте в Bridgero Мои ключи и вставьте Telegram bot token.
  4. При своём ключе добавляйте в чат уже вашего бота и тоже выдайте ему права администратора.
  5. Скопируйте либо числовой ID чата, либо ссылку вида https://t.me/c/1983972980/7.
  6. Если в конце ссылки есть число, оно будет использовано как thread для forum topic.

3. Подключение Discord

  1. По умолчанию используется общий Discord-бот Bridgero. Добавьте его на сервер по ссылке:

Добавить общий Discord-бот

  1. Если хотите своего бота: создайте приложение в Discord Developer Portal, включите Message Content Intent, скопируйте bot token в Мои ключи и пригласите уже своего бота на сервер.
  2. Убедитесь, что используемый бот имеет доступ к нужному текстовому каналу.
  3. Для канала дайте права как минимум View Channel, Read Message History, Send Messages, Attach Files.
  4. Скопируйте ID нужного текстового канала Discord.

Принеси свой ключ

  • Откройте Мои ключи в шапке после входа.
  • У каждой платформы есть статус: Ключ добавлен, Общий бот или Не добавлен.
  • Discord и Telegram: можно задать свой token или оставить пустым — тогда работает общий бот Bridgero.
  • MAX и VK: общий бот не предусмотрен. Нужны свои ключи до создания связи с этими платформами.
  • Для VK дополнительно укажите числовой group ID сообщества.
  • Чекбокс «Удалить свой ключ» сбрасывает сохранённый token.

4. MAX

  1. Создайте бота в кабинете MAX и скопируйте token.
  2. Сохраните token в Мои ключи.
  3. Добавьте бота в нужный чат MAX и сделайте его администратором — без этого входящие сообщения из группы не приходят.
  4. Скопируйте числовой chat_id (для групп он отрицательный).
  5. При создании связи выберите платформу MAX и вставьте этот ID.
  6. Bridgero использует long-poll: при старте бота активные webhook-подписки токена снимаются, иначе MAX не отдаёт updates.
  7. Для platform-api2.max.ru в образ встроены сертификаты Минцифры (Russian Trusted CA).

5. VK

  1. Создайте сообщество VK и ключ доступа сообщества с правами сообщений.
  2. В Bridgero укажите community token и group ID в Мои ключи.
  3. Включите Long Poll / Bots Long Poll API для сообщества.
  4. В связи укажите peer_id беседы или пользователя, куда нужно слать сообщения.

6. Создание связи

  1. На странице Мои связи нажмите Новая связь.
  2. Отметьте две или больше платформ и укажите ID чатов.
  3. Можно связать сразу Discord + Telegram + MAX + VK: сообщение из любой платформы уйдёт во все остальные.
  4. Для Telegram можно вставить ссылку t.me/c/....
  5. По желанию добавьте описание.
  6. При двух платформах можно выбрать одностороннее направление; при 3+ всегда «все ↔ все».
  7. Нажмите Создать связь.

7. Управление связями

  • Пауза — временно отключает пересылку.
  • Включить — включает связь обратно.
  • Удалить — удаляет связь полностью.
  • Если Telegram-ссылка содержала topic, в карточке связи будет показан thread.

8. Если сообщения не идут

  • Проверьте, что бот добавлен в нужный чат и имеет права на чтение/отправку.
  • Для MAX/VK убедитесь, что ключи сохранены и long-poll запущен (смотрите логи).
  • Сверьте ID чатов в карточке связи.
  • Проверьте логи сервиса: docker compose logs -f bridge.

Как редактировать эту инструкцию

Текст инструкции хранится в файле internal/httpapi/web/guide.html.

Ссылка в шапке приложения добавлена в файл internal/httpapi/web/index.html.

Общие стили страницы находятся в internal/httpapi/web/styles.css.

Куда добавлять картинки

Картинки для инструкции кладите в папку internal/httpapi/web/ рядом с HTML/CSS, либо в подпапку internal/httpapi/web/img/.

После этого вставляйте их в guide.html обычным тегом:

<img src="/assets/имя-файла.png" alt="Описание картинки">
<img src="/assets/img/screenshot.png" alt="Скриншот">

Если нужны новые локальные стили для картинок, добавляйте их в styles.css.