Бот бодро отвечал на сообщения весь вечер. Утром ноутбук закрыли, сели в метро — и бот замолчал. Пользователи пишут, бот не реагирует, а к вечеру часть их вопросов уже никто не увидит.

Это не сбой Telegram. Бот — это программа, которая работает на чьём-то компьютере, а Telegram лишь передаёт ей сообщения. Пока программа запущена, бот жив. Поэтому «запустить бота 24/7» означает ответить на три вопроса: где живёт процесс, кто поднимет его после сбоя и где лежит токен.

24 часа
Столько Telegram хранит обновления, которые бот ещё не получил.
4 порта
Поддерживаются для webhook: 443, 80, 88 и 8443.
1 экземпляр
Столько копий бота должно получать обновления по одному токену.

Как это устроено

Почему бот засыпает

Telegram не запускает код ботов. Он принимает сообщения пользователей и держит их для вашей программы, а программа их забирает и отвечает. Если программа не работает, сообщения копятся на стороне Telegram, но не дольше 24 часов. То, что бот не забрал за сутки, пропадает.

Отсюда простое правило: боту нужен компьютер, который не выключается, и программа, которая сама поднимется после сбоя.

Как бот получает сообщения

Polling или webhook


Long polling (getUpdates)

Webhook (setWebhook)

Кто начинает

Бот сам спрашивает Telegram, нет ли новых сообщений

Telegram сам присылает сообщения на ваш адрес

Что нужно

Любой компьютер с выходом в интернет

Публичный адрес HTTPS на порту 443, 80, 88 или 8443

Плюсы

Просто: не нужен домен и сертификат

Не нужно держать постоянное соединение, удобно для платформ, которые будят код по запросу

Минусы

Процесс должен работать всё время

Нужны HTTPS, домен и проверка, что запрос пришёл от Telegram

Способы взаимоисключающие: пока у бота настроен webhook, getUpdates не работает. Чтобы вернуться к опросу, webhook удаляют методом deleteWebhook. Бот из статьи «Как создать бота в Telegram: BotFather, первый код на Python и одно правило про токен» работает через long polling — его и перенесём на сервер.

Сверху бот запрашивает сообщения; снизу Telegram отправляет их серверу бота.
Схема сверху вниз. Слева бот, справа Telegram. Polling начинает бот; webhook начинает Telegram. Это альтернативные режимы.

Варианты

Где разместить

Вариант

Подходящий режим

Плюсы

Минусы

Свой компьютер

Polling

Бесплатно и просто

Работает, только пока компьютер включён и не спит

Виртуальный сервер (VPS)

Polling или webhook

Работает круглосуточно, полный контроль

Нужно настроить систему, обновления и автозапуск

Платформа приложений или бессерверные функции

Webhook

Не нужно администрировать сервер

Свои ограничения платформы, нужен HTTPS

Для первого бота с long polling удобен небольшой виртуальный сервер с Linux. Дальше — как сделать так, чтобы бот работал на нём без вас.

Пошагово на VPS

Служба systemd: автоперезапуск

  1. Скопируйте bot.py на сервер, например в /opt/bot, и запускайте его от отдельного пользователя без прав администратора.
  2. Положите токен в файл /etc/bot/token.env одной строкой TELEGRAM_BOT_TOKEN=ваш_токен и закройте доступ к нему командой chmod 600: читать его сможет только владелец.
  3. Опишите службу в файле /etc/systemd/system/bot.service.
[Unit]
Description=Telegram bot
After=network-online.target
Wants=network-online.target

[Service]
User=botuser
WorkingDirectory=/opt/bot
EnvironmentFile=/etc/bot/token.env
ExecStart=/usr/bin/python3 /opt/bot/bot.py
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target
  1. Включите службу и посмотрите журнал.
sudo systemctl daemon-reload
sudo systemctl enable --now bot
journalctl -u bot -f

Restart=always перезапускает бота после любой остановки, RestartSec=5 даёт паузу в пять секунд между попытками, а enable запускает службу при каждой загрузке сервера. Токен при этом не попадает ни в код, ни в историю команд.

Второй режим

Webhook: когда нужен адрес

Для webhook ваш сервер или платформа принимает запросы Telegram по HTTPS. При настройке методом setWebhook передают адрес и секрет. Тогда каждый запрос Telegram придёт с заголовком X-Telegram-Bot-Api-Secret-Token, и всё, что пришло без него, отбрасывают.

import hmac
import os

WEBHOOK_SECRET = os.environ["WEBHOOK_SECRET"]


def setup_webhook(call, url):
    # call — функция обращения к Bot API из статьи о создании бота
    call("setWebhook", url=url, secret_token=WEBHOOK_SECRET, allowed_updates=["message"])


def is_from_telegram(headers):
    received = headers.get("X-Telegram-Bot-Api-Secret-Token", "")
    return hmac.compare_digest(received, WEBHOOK_SECRET)

Секрет храните так же, как токен: в переменной окружения, а не в коде.

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

Токен: ключ от бота

Токен из BotFather — это полный доступ к боту: с ним кто угодно может управлять ботом, получать то, что ему пишут, и отвечать от его имени. Поэтому он живёт только на сервере, в файле с ограниченными правами, и не попадает в репозиторий, логи и скриншоты.

Если токен всё-таки утёк, откройте BotFather и выпустите новый командой /token, затем замените его в файле на сервере и перезапустите службу. Подробно о действиях при утечке — в разделе «Если токен утёк» статьи «Как создать бота в Telegram: BotFather, первый код на Python и одно правило про токен».

Чек-лист

Перед запуском

Вопросы

Можно ли держать бота на домашнем компьютере?

Можно, если компьютер включён круглосуточно и не уходит в сон. Но любое отключение света или интернета останавливает бота, а сообщения старше 24 часов пропадут. Для постоянной работы надёжнее сервер.

Что будет с сообщениями, пока бот не работал?

Telegram держит их до 24 часов. Когда бот снова запустится, он получит накопившиеся обновления и ответит на них. Всё, что старше суток, бот уже не увидит.

Почему две копии бота мешают друг другу?

При long polling обновления может забирать только одна программа. Если запустить вторую копию с тем же токеном, они начнут конфликтовать, и часть сообщений получит не та копия. Для тестов создайте в BotFather отдельного бота со своим токеном.


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

Служба systemd с автоперезапуском и токен в закрытом файле решают обе задачи на обычном виртуальном сервере. Webhook пригодится позже, когда бот переедет на платформу, которая сама будит код по запросу.