Кабинет

Подключение Telegram-бота к сообществу

Вставьте токен бота из BotFather — платформа настроит webhook и права админа автоматически.

Что нужно

Прежде чем начать, проверьте:

  • Вы — владелец сообщества (создатель)
  • У вас есть Telegram

Как подключить бота

Шаг 1. Создать бота в BotFather

  1. Откройте в Telegram: @BotFather
  2. Нажмите /start или напишите /newbot
  3. Введите название бота (например, «ACME Bot» — видно участникам в чате)
  4. Введите username (адрес бота, например, acme_bot) — должен содержать слово «bot» и заканчиваться на него
  5. BotFather вернёт вам токен (строка вида 123456789:ABC-DEFghijklmnopqrstuvwxyz)
  6. Скопируйте токен — понадобится за 30 секунд

Шаг 2. Вставить токен в CatchClub

  1. Зайдите в кабинет сообщества → вкладка «Бот»
  2. Вставьте токен в поле «123456:ABC-DEF…»
  3. Нажмите «Подключить бота»
Если поле токена недоступно и вместо этого видна строка «Подключён: @username», значит бот уже подключен к вашему сообществу.

Шаг 3. CatchClub сделает это за вас

Платформа автоматически:

  • Проверит токен — убедится, что он валиден и принадлежит вам
  • Настроит webhook — бот начнёт получать события от Telegram на адрес https://connectli.app/api/tg/webhook/<сообщество>
  • Установит меню команд — участники смогут вводить /start и /help
  • Включит кнопку-лаунчер — синяя кнопка у поля ввода открывает мини-приложение в один тап (можно переименовать — см. ниже)

Требования к боту, которые CatchClub проверяет и устанавливает:

  • Права администратора в чате сообщества (требуется вручную — см. ниже)
  • Может отправлять обычные сообщения и инлайн-кнопки
  • Может редактировать сообщения (для обновления меню)
  • Может удалять сообщения других пользователей (опционально — для чистоты чата)

Как дать боту права админа в чате

Обязательно: добавьте бота администратором сообщества. Иначе он не сможет работать.

  1. Откройте чат сообщества в Telegram
  2. Нажмите на название группы (вверху)
  3. Перейдите в «Управление» → «Администраторы»
  4. Нажмите «Добавить администратора»
  5. Найдите вашего бота (по username из BotFather, например, @acme_bot)
  6. Подтвердите — дайте ему права:
  • ✅ Удалять сообщения (нужно)
  • ✅ Отправлять сообщения (нужно)
  • ✅ Закреплять сообщения (опционально)
  • ✅ Приглашать пользователей (опционально)

Остальные права можно отключить для безопасности.

Персонализация — тексты бота

После подключения бота откройте вкладку «Бот» → секция «Тексты бота».

Кнопка-лаунчер (синяя кнопка)

Измените текст кнопки, которая открывает мини-приложение:

  • Поле: «Кнопка-лаунчер»
  • Пусто (по умолчанию): «Войти»
  • Примеры: «Открыть клуб», «Войти в сообщество», «Запустить»

Кнопка обновится сразу для всех участников.

Приветствие при /start

Настройте текст, который видят участники при нажатии /start:

  • Поле: «Приветствие в /start»
  • Заголовок добавляется автоматически: «🚀 Добро пожаловать в <название>!»
  • Пусто: стандартный текст с описанием сообщества и списком возможностей
  • Поддерживает Markdown: **жирный**, _курсив_, ` код `

Приветствие обновится при следующем `/start`.

Совет: Используйте приветствие, чтобы кратко рассказать, что здесь, и куда идти дальше (например, ссылка на чат или меню команд).

Стилизация и дополнительные параметры

Меню команд — автоматически устанавливается:

  • /start — «Запустить бота»
  • /help — «Помощь»

Текст команд задан в коде и не редактируется в кабинете (требует перепрограммирования).

Прямая ссылка в мини-приложение — когда бот подключен, кнопка «Перейти в приложение» вверху кабинета открывает мини-приложение именно вашего сообщества (с правами администратора, если вы владелец).

Если возникли проблемы

Ошибка: «Невалидный токен бота»

  • Проверьте, правильно ли скопирован токен (без пробелов, весь целиком)
  • Убедитесь, что токен из BotFather, а не из другого источника
  • Попробуйте создать нового бота и повторите

Ошибка: «Не удалось установить webhook»

  • Проверьте интернет-соединение
  • Убедитесь, что бот всё ещё существует в BotFather
  • Если ошибка повторяется, напишите нам

Бот подключен, но не отвечает на сообщения

  • Добавьте бота в чат сообщества, если вы этого ещё не сделали
  • Дайте боту права администратора (см. выше)
  • Запустите бота командой /start в личном чате с ним

Можно ли переподключить другого бота?

Да, просто вставьте новый токен в кабинет. Старый бот отключится автоматически. Убедитесь, что новый бот добавлен администратором в чат сообщества.

Безопасность

  • Токен приватный — его хранит CatchClub в зашифрованном виде и никогда не показывает в кабинете
  • Webhook-секрет — платформа автоматически генерирует уникальный секрет для каждого сообщества, чтобы убедиться, что события действительно от Telegram
  • Права бота ограничены — администратор сообщества всегда может отозвать права или удалить бота

Что дальше?

После подключения бота:

  1. Настройте онбординг — роли участников и темы
  2. Включите модули — дайджесты, события, регистрация
  3. Приглашайте участников — они присоединятся через мини-приложение