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

Обзор

Подключите ваш Telegram-канал к Gapex, чтобы автоматически получать комментарии из группы обсуждений канала, генерировать ответы с помощью ИИ и управлять взаимодействием с аудиторией — всё в одном месте.

Как работает интеграция с Telegram

Telegram-каналы не предоставляют прямого API для чтения комментариев. Вместо этого Gapex использует специального бота, которого вы добавляете как администратора в ваш канал и связанную группу обсуждений. После настройки бот получает все новые сообщения в режиме реального времени через вебхук.

Требования перед подключением:

• Telegram-канал, которым вы владеете или которым управляете
• Группа обсуждений, связанная с каналом (Настройки → Обсуждения в Telegram)

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

Шаг 1: Откройте раздел Accounts

В панели управления Gapex найдите раздел Accounts на левой боковой панели. Нажмите кнопку + Add account.

Шаг 2: Выберите Telegram

Из списка поддерживаемых платформ выберите Telegram.

Шаг 3: Откройте бота в Telegram

Gapex отобразит кнопку Open in Telegram, которая откроет диплинк на бота Gapex. Нажмите её — ваше приложение Telegram откроется и начнёт чат с ботом.

Шаг 4: Добавьте бота в ваш канал

Бот предложит добавить его в качестве администратора вашего канала. Нажмите кнопку Add me to your channel и предоставьте следующие права:

• Публикация сообщений
• Удаление сообщений
• Ограничение участников

Шаг 5: Добавьте бота в группу обсуждений

После добавления в канал бот определит связанную группу обсуждений и попросит добавить его туда тоже. Нажмите Add me to [название группы] и предоставьте права:

• Удаление сообщений
• Ограничение участников

Шаг 6: Выберите канал

Как только бот станет администратором в обоих местах, он отобразит список готовых каналов. Нажмите на канал, который хотите подключить. Gapex завершит подключение, и аккаунт появится в панели управления.

Что происходит после подключения

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

1. Комментарии в реальном времени — Каждый новый комментарий в группе обсуждений мгновенно передаётся в Gapex через вебхук.
2. Предложения ответов ИИ — Gapex генерирует варианты ответов для каждого комментария на основе контекста вашего канала.
3. Синхронизация постов — Новые публикации канала автоматически отслеживаются, чтобы комментарии были привязаны к нужному посту.

Ручная настройка

Если автоматический процесс через бота не сработал или вы предпочитаете настроить всё самостоятельно, вы можете вручную добавить бота Gapex как администратора и связать группу обсуждений через настройки канала.

Часть 1 — Добавьте бота как администратора канала

Шаг 1. Откройте ваш канал в Telegram и нажмите Manage.

Шаг 2. В экране редактирования канала нажмите Administrators.

Шаг 3. Нажмите Add Administrator.

Шаг 4. Найдите бота Gapex по имени пользователя и выберите его.

Шаг 5. Telegram предложит добавить бота в канал. Нажмите OK.

Шаг 6. Предоставьте необходимые права и нажмите Save.

Бот теперь появится в списке администраторов.

Часть 2 — Привяжите группу обсуждений к каналу

Шаг 7. В редактировании канала нажмите Discussion → Add a group.

Шаг 8. Выберите существующую группу или нажмите Create a new group.

Шаг 9. Дайте группе название и нажмите Create.

Шаг 10. В редактировании канала группа обсуждений теперь привязана. Нажмите Save.

Часть 3 — Добавьте бота как администратора группы обсуждений

Шаг 11. Откройте группу обсуждений и перейдите в Manage → Administrators.

Шаг 12. Нажмите Add Administrator и найдите бота Gapex.

Шаг 13. Выберите бота Gapex из результатов поиска.

Шаг 14. Подтвердите добавление бота в группу. Нажмите OK.

Шаг 15. Предоставьте необходимые права и нажмите Save.

Шаг 16. Сохраните настройки группы.

Бот теперь является администратором группы обсуждений.

После выполнения обоих шагов бот Gapex автоматически обнаружит подключение и завершит настройку.

Решение проблем

«Please start from the web app Connect button first»

Проблема: Вы открыли бота напрямую, не заходя через Gapex. Решение: Вернитесь в панель управления Gapex, нажмите + Add account, выберите Telegram и воспользуйтесь предоставленной ссылкой.

«This channel has no linked discussion group»

Проблема: У вашего Telegram-канала нет связанной группы обсуждений. Решение: В Telegram откройте ваш канал → Редактировать → Обсуждения → свяжите существующую группу или создайте новую. Затем нажмите «Проверить снова» в боте.

«That link has expired»

Проблема: Ссылка для подключения действительна ограниченное время. Решение: Вернитесь в Gapex, снова нажмите + Add account и начните новый процесс подключения.

Комментарии не появляются

Проблема: Бот мог потерять права администратора. Решение: Убедитесь, что бот Gapex по-прежнему является администратором как в канале, так и в группе обсуждений с необходимыми правами.

Ограничения

• Только вебхук — Gapex захватывает только комментарии, полученные после подключения. Исторические комментарии не импортируются.
• Нет лайков — Bot API Telegram не поддерживает лайки сообщений.
• Нет скрытия — Сообщения можно только удалять, но не скрывать.
• Максимальная длина ответа — 4 096 символов (ограничение Telegram).
• Требуется группа обсуждений — Каналы без связанной группы обсуждений не могут быть подключены.

Конфиденциальность и безопасность

• Без паролей — Gapex использует общего бота; вам нужно только предоставить права администратора.
• Минимальные права — Бот запрашивает только права на удаление и ограничение участников — он никогда не читает личные сообщения за пределами вашей группы обсуждений.
• Отзывается в любой момент — Удалите бота из канала и группы обсуждений в любое время, чтобы отключиться.

Частые вопросы

В: Можно ли подключить несколько Telegram-каналов? О: Да. Повторите процесс «Add account» для каждого канала.

В: У меня закрытый канал — можно ли его подключить? О: Да. В боте нажмите «My channel is private — how to add?» для получения инструкций по ручному добавлению бота через настройки администраторов канала.

В: Нужно ли создавать токен бота? О: Нет. Gapex использует общего бота для всех пользователей — вы просто приглашаете его в свой канал.