Создать бота на русском значит локализовать видимые элементы: имя, описание, меню команд, кнопки, ответы, ошибки и справку. Сам код и команды вида /start могут оставаться латиницей. Для результата сначала регистрируют бота у BotFather, затем задают русские тексты и проверяют отдельный сценарий от первого сообщения до завершения задачи.
Что именно нужно перевести
Telegram-бот состоит не только из ответов. Человек видит профиль, приветствие, список команд, кнопки, уведомления об ошибках и сообщения после действия. Если один слой остаётся на другом языке, интерфейс выглядит незавершённым.
- Отображаемое имя и краткое описание.
- Полное описание в профиле.
- Меню команд и пояснения к ним.
- Текст
/startи/help. - Кнопки, подсказки и подтверждения.
- Ошибки, пустые состояния и сообщения о недоступности.
- Политика конфиденциальности и контакты поддержки, если они нужны.
Не переводите техническую команду каждый раз по-разному. Команда должна быть стабильной, а её русское описание объясняет результат.
Зарегистрируйте основу у BotFather
Официальный учебник Telegram предлагает открыть @BotFather, выполнить /newbot и получить токен. Telegram отдельно предупреждает относиться к токену как к паролю. Полный начальный путь описан в руководстве Telegram.
- Откройте официальный
@BotFatherв Telegram. - Выполните
/newbotи задайте отображаемое имя. - Выберите свободное имя пользователя по требованиям Telegram.
- Сохраните токен вне переписки и исходного кода.
- Откройте созданного бота и отправьте
/start. - Подключите токен к своему конструктору или серверному приложению.
Подробные шаги регистрации уже есть в отдельной инструкции по BotFather. Здесь следующий этап: сделать весь пользовательский путь русскоязычным.
Представьте бота, который каждое утро сам готовит дайджест новостей и зачитывает его голосом. Такого ИИ-агента в Telegram показывают завтра в 12:00 МСК на бесплатном мастер-классе.
Записаться бесплатноНастройте русское меню команд
Bot API поддерживает метод setMyCommands. Для набора команд можно передать двухбуквенный language_code; если код пустой, набор становится запасным для пользователей без отдельной локализации. Текущие поля и ограничения опубликованы в Telegram Bot API.
Для русской локализации используйте код ru. Сами команды состоят из латинских букв, цифр и подчёркивания по формату Bot API, а описания пишутся по-русски. В BotFather тот же результат можно задать через раздел редактирования команд.
start - Начать работу
help - Показать справку
status - Проверить статус
cancel - Отменить действие
Не делайте много синонимичных команд. Оставьте минимальный набор, а ветвление перенесите в кнопки. Для отдельной логики обработчиков пригодится гайд по созданию команд боту.
По теме: Как включить русский язык в Claude: интерфейс и ответы в 2026
Напишите первый сценарий по-русски
Выберите одну задачу, например приём заявки. Каждое сообщение должно отвечать на один вопрос и давать следующий понятный шаг. Кнопки лучше формулировать глаголом: «Выбрать услугу», «Отправить заявку», «Изменить телефон».
- Приветствие объясняет, что бот умеет и какие данные потребуются.
- Бот просит одно поле за раз.
- После ввода показывает полученное значение или понятную ошибку.
- Перед отправкой выводит сводку и кнопки подтверждения или изменения.
- После подтверждения сообщает, что произошло и когда ждать ответ.
- Команда
/cancelбезопасно завершает сценарий и очищает временные данные.
Безопасный пример ошибки: «Не удалось распознать номер. Введите его в формате, который показан в подсказке, или нажмите “Отмена”». Сообщение описывает исправление, а не обвиняет человека.
Контент-завод канала, дайджест новостей голосом, бот-транскрибатор: всё это делает один ИИ-агент в Telegram. На бесплатном мастер-классе завтра в 12:00 МСК Яков Юдин показывает, как он устроен и что ему можно поручить без страха. Досмотревшим 30 идей с промптами.
Хочу на мастер-классЕсли нужны два языка
Сделайте один запасной набор команд и отдельный русский набор с language_code="ru". Язык интерфейса Telegram можно использовать как подсказку, но оставьте ручной выбор в /settings: системный язык не всегда совпадает с предпочтением для бота.
- Храните тексты по стабильным ключам, а не внутри обработчиков.
- Для каждого ключа задайте русский и запасной вариант.
- Не смешивайте язык данных пользователя с языком интерфейса.
- При отсутствии перевода показывайте запасной текст, а не пустое сообщение.
- После ручного выбора сохраняйте его для конкретного пользователя.
По теме: Как сделать приветствие в боте Telegram в 2026
Приёмочная проверка русской версии
Проверьте бота с чистого аккаунта или после сброса состояния. Пройдите меню команд, обычный сценарий, ошибку и отмену. Затем измените язык Telegram, чтобы увидеть, какой набор команд становится запасным.
- В профиле нет случайного английского описания.
- Команда
/startотвечает по-русски. - Все кнопки помещаются на экране телефона.
- Ошибки предлагают конкретное исправление.
- После отмены старая заявка не продолжается.
- Русские имена и сообщения сохраняются без искажений.
- Список команд соответствует реально работающим обработчикам.
- Токен и служебные данные не появляются в ответах.
Частые сбои и диагностика
Если меню осталось на другом языке, проверьте language_code, область действия команд и запасной набор. Если кнопка русская, а ответ английский, текст зашит в обработчике или приходит от внешнего сервиса без локализации. Если русские символы искажены, проверьте кодировку файлов, базы и HTTP-ответов.
- Команда видна, но не работает: название в меню не совпало с обработчиком.
- Новый текст не появился: клиент Telegram использует кэш, перезапустите диалог и проверьте набор через API.
- После ошибки бот молчит: для исключения нет пользовательского сообщения и возврата в безопасное состояние.
- Русский текст обрезан: сократите кнопку, а подробность перенесите в сообщение.
- Разные ответы используют разные термины: заведите короткий словарь интерфейса.
По теме: Как создать команду боту в Telegram в 2026: меню и обработчик
Когда локализации недостаточно
Русские подписи не исправят плохой сценарий. Если бот задаёт лишние вопросы, не показывает итог или теряет заявку, сначала чините логику и хранение состояния. Для поддержки нескольких стран также потребуется проверить форматы телефона, даты, время, валюту и правила обработки данных.
Если задача шире языка и вы только выбираете способ разработки, начните с сравнения способов создать Telegram-бота.
Частые вопросы
Можно ли писать команды кириллицей?
Технические имена команд оставляйте в допустимом формате Bot API, а русское значение объясняйте в описании и кнопках.
Почему Telegram показывает английское меню?
Проверьте отдельный набор для ru и запасной набор без кода языка. Также убедитесь, что команды заданы для нужной области.
Нужен ли русский язык в коде?
Нет. Язык программирования не определяет язык интерфейса. Главное, чтобы файлы и данные корректно хранили Unicode-текст.
Как дать человеку сменить язык?
Добавьте команду настроек или кнопку выбора и сохраняйте предпочтение пользователя отдельно от языка приложения Telegram.
Бот говорит по-русски, меню на месте. Завтра в 12:00 МСК на бесплатном мастер-классе агенту диктуют задачу голосом на русском, и Codex сам собирает данные и сводит их в таблицу. Без английского и без кода.
Хочу на мастер-класс