Как поменять владельца Telegram-бота

Осенью прошлого года случилось то, чего ждали многие — Telegram добавил в BotFather возможность смены владельца бота (а также другие изменения в Bot API).

Зачем и кому это нужно

Есть два самых частых сценария: передача бота заказчику от исполнителя и передача бота новому владельцу. Иногда этим пренебрегают, и случаются печальные ситуации: владелец перестает заходить в Телеграм и через год максимум его аккаунт удаляется вместе с ботом. Если повезет, то бот останется «сиротой»: работать продолжит, но как-либо отредактировать его не получится даже при помощи поддержки.

Как поступали раньше

Предыдущий владелец договаривался с новым о том, чтобы оперативно провернуть спецоперацию: удалить бота у себя в BotFather, чтобы новый владелец зарегистрировал такой же у себя. У такого подхода были два минуса: кто-то может охотиться за именем и успеть зарегистрировать его, пока он свободен; терялась база пользователей бота, а это допустимо только при передаче свежесделанного бота заказчику. Также можно было передавать бота вместе с телеграм-аккаунтом, но этот способ подходит далеко не всем.

Как теперь происходит передача

Должны выполняться следующие условия:
  • Новый владелец должен написать хотя бы одно сообщение своему будущему боту (а также, скорее всего, не останавливать его после этого).
  • У нового владельца должен быть свободный слот в BotFather (максимум разрешается иметь 20 ботов).
  • Если у старого владельца включена двухфакторная авторизация, под рукой должен быть пароль (впрочем, если она выключена, то мы настоятельно рекомендуем прямо сейчас отложить чтение и включить ее).
Если они выполняются, пишите BotFather команду /mybots, выбирайте бота и жмите Transfer Ownership, а потом Choose recipient. Дальше отправляйте юзернейм нового владельца (с собачкой) или его контакт (работает со смартфона, не работает на клиенте для Mac).
Мы проверили два важных момента: токен и привязанный вебхук сохраняются (а это значит, что перенастройка ПО, будь то конструктор или что-то самописное, не потребуется); аудитория бота никуда не пропадает, новый владелец может с ней общаться, и вообще для пользователей бота ничего не изменится.
Не теряйте своих ботов!