В App Platform вы можете развернуть Telegram-бота на Telebot для Go. Бот может получать сообщения с помощью long polling или вебхуков.
Сборка приложения
При сборке используется Go. Версию можно выбрать при создании приложения.
Сборка выполняется в корне репозитория или в директории, которую вы укажете в поле «Путь до директории проекта».
Убедитесь, что в файле go.mod указан Telebot и остальные зависимости проекта. Зависимости загружаются через Go Modules.
В расширенных настройках проверьте команды сборки и запуска. Для сборки по умолчанию используется команда:
go build -o main .
Команда создаст исполняемый файл main. Для запуска по умолчанию используется команда:
./main
Если ваш проект собирается или запускается по-другому, скорректируйте команды.
Переменные
При выборе Telebot App Platform по умолчанию добавит переменную BOT_TOKEN. Укажите в ней токен вашего бота, полученный у @BotFather.
Если в вашем проекте переменная для токена называется иначе, создайте ее вручную в блоке «Переменные» и укажите значение.
Деплой приложения
После настройки приложения нажмите «Запустить деплой». Ход сборки и запуска можно отслеживать на вкладке «Деплой».
Когда бот запустится, отправьте ему команду, для которой в проекте настроен обработчик, и проверьте ответ в Telegram.
Настройка вебхуков
Вы можете использовать вебхуки для получения сообщений от Telegram. Для этого подойдет бесплатный технический домен App Platform или собственный домен, привязанный к приложению.
Получить технический домен или привязать собственный можно только после первого деплоя. Поэтому пока для настройки вебхуков нужно выполнить первый деплой с незаполненным доменом в переменной. Деплой завершится ошибкой. После этого укажите домен в переменной и запустите деплой повторно:
-
Настройте проект так, чтобы он считывал домен вебхука из переменной окружения — например,
WEBHOOK_DOMAIN. Секрет для проверки запросов можно передавать черезWEBHOOK_SECRET. Добавьте эти переменные в панели управления при создании приложения. Названия должны совпадать с теми, которые используются в коде. -
Нажмите «Запустить деплой». Дождитесь его завершения с ошибкой из-за незаполненного домена.
-
Откройте вкладку «Дашборд» приложения и скопируйте выданный технический домен. Если хотите использовать собственный домен, сначала подключите его к приложению по инструкции.
-
На вкладке «Настройки» откройте редактирование настроек деплоя и для переменной
WEBHOOK_DOMAINукажите домен, установленный для приложения. -
Сохраните изменения. Запустится повторный деплой приложения. С заполненным доменом Telebot сможет зарегистрировать вебхук и запустить бота.
Если бот использует long polling, он сам запрашивает новые сообщения у Telegram. В этом случае настраивать вебхуки и домен не требуется.
Устранение неполадок
Не удается выполнить развертывание
В первую очередь проверьте лог деплоя. Убедитесь, что все зависимости указаны в go.mod, а в директории сборки находится пакет main с функцией main(). Проверьте, что после сборки создается исполняемый файл с тем же именем, которое указано в команде запуска.
Бот не отвечает на сообщения
Проверьте, что токен указан в переменной с тем же названием, которое используется в коде, а в приложении зарегистрирован обработчик отправленной команды.
При long polling убедитесь, что с тем же токеном не запущена другая копия бота — например, на вашем компьютере. Telegram не позволяет одновременно получать обновления через long polling и вебхук.
Если используются вебхуки, проверьте значение WEBHOOK_DOMAIN и секрет. Убедитесь, что HTTP-сервер слушает 0.0.0.0, а не 127.0.0.1, иначе внешние подключения работать не будут. Если после первого неуспешного деплоя домен еще не указан, укажите его и запустите повторный деплой, как описано в разделе «Настройка вебхуков».