Многоязычный Telegram-бот должен сохранять понятный путь при любом состоянии: первом запуске, ошибке, старой кнопке и передаче оператору. Перевод приветствия и меню недостаточен, если после неподходящего файла приложение возвращает техническое сообщение на другом языке. Пользователь сталкивается с локализацией именно в момент, когда ему нужна помощь.
Поэтому языковую поддержку проектируют как часть состояния приложения. Нужно определить начальный язык, ручной выбор, резервную версию и связь переводов с одним сценарием. Telegram предоставляет языковые сведения и средства настройки отдельных элементов, но полноту ответа и согласованность формы обеспечивает разработчик.
Начальный язык и явный выбор
Доступное языковое поле пользователя может помочь выбрать первую версию, однако не должно быть единственным способом управления. Человек может пользоваться интерфейсом Telegram на одном языке, а поддержку предпочитать на другом. Предложите понятный ручной выбор и сохраняйте его в профиле приложения по установленным правилам.
Обработайте отсутствие или неподдерживаемое значение. Не все входящие случаи обязаны содержать ожидаемую локаль. Выберите базовый язык заранее и сделайте переход к выбору доступным из справки либо меню. Ошибка определения языка не должна блокировать запуск формы.
Не определяйте часовой пояс или страну только по языку. Один язык используется в разных регионах, а человек может находиться в поездке. Дата, валюта и правила услуги требуют своих подтверждённых данных. Локализация текста не заменяет модель региональных параметров.
Стабильные идентификаторы и переведённые подписи
Внутреннее состояние должно опираться на устойчивые значения, а не на текст кнопки. Если пользователь сменил язык, прежний выбор категории не должен исчезнуть из-за другой подписи. Сохраняйте идентификатор действия и отдельно отображайте нужное название.
Это особенно важно для свободно отправляемого текста и reply-клавиатуры. Обработчик должен понимать допустимый ввод текущего шага, не путая перевод с новой бизнес-сущностью. Если поддерживается ручной текстовый ответ, предусмотрите проверку, а не только точное совпадение одной локализованной строки.
Для inline-действий проверяйте состояние независимо от языка старого сообщения. Человек может нажать кнопку, показанную до переключения. Сервер должен найти правильную операцию и ответить согласно актуальной настройке, а не выполнить другое действие из-за совпавшего текста.
Что переводить вместе со сценарием
Составьте перечень видимых текстов: вопросы, пояснения, сводки, ошибки, состояния ожидания, подтверждения и сообщения передачи человеку. Добавьте меню команд и описания там, где используется поддерживаемая языковая настройка Telegram. Один полный перечень помогает не забыть редкие пути.
Переводите ссылки по назначению. Если справка доступна на нужном языке, используйте её реальный адрес. Если нет, обозначьте язык материала до перехода. Нельзя считать локализацию полной, когда английская кнопка неожиданно открывает длинную русскую инструкцию без предупреждения.
Внешние документы также имеют версии. Изменение условия услуги должно пересматриваться во всех переводах. Дата редактирования базовой версии не подтверждает обновление остальных. Назначьте владельца, который отмечает готовность каждого языка после содержательной проверки.
Условный пример: смена языка в середине анкеты
Предположим, клиент начал форму на английском, выбрал тему и добавил описание. Затем переключил интерфейс на русский. Приложение сохраняет ответы и показывает следующий шаг на выбранном языке. Внутренний идентификатор темы остаётся тем же, поэтому оператор получает корректную категорию.
Пользователь возвращается к старой английской кнопке изменения. Сервер проверяет экземпляр формы и актуальное состояние. Если действие допустимо, продолжает редактирование на текущем языке. Если устарело, объясняет это и открывает действующую сводку. Повторного заполнения всей формы не требуется.
Пример условный: Telegram сам не переносит состояние вашей анкеты между переводами. Нужно реализовать стабильные идентификаторы, словарь и правила продолжения. Проверка одного первого запуска на каждом языке не выявит ошибку смены локали в незавершённом разговоре.
Резервная версия без смешения
Определите, что происходит при отсутствии отдельной строки. Возможен резервный язык, но случайная смесь фраз усложняет понимание. Для важных экранов лучше проверять полноту заранее, а не обнаруживать пропущенный перевод в рабочем обращении. Технический ключ из словаря никогда не должен становиться нормальным клиентским сообщением.
Если резерв действительно используется, сделайте его выбор последовательным и доступным для исправления. Не меняйте язык автоматически после каждой реплики, основываясь на распознавании текста. Клиент может вставить английское сообщение об ошибке, продолжая общаться по-русски. Цитата не должна переопределять его настройку.
Не включайте неготовый язык только ради наличия пункта в меню. Лучше ясно обозначить доступные версии и возможность помощи, чем открыть форму, которая ломается на первом редком шаге. Число языков полезно только вместе с завершённым рабочим путём.
Длинные строки и направление текста
Перевод часто меняет длину подписи. Проверьте кнопки на телефоне и с увеличенным шрифтом. Не сокращайте смысл важного действия до непонятной аббревиатуры ради одинакового размера. Если выборов много, пересмотрите структуру шага, а не только уменьшайте текст.
Для языков с письмом справа налево проверьте порядок текста, чисел и встроенных идентификаторов в доступном клиенте. В обычных сообщениях часть отображения контролирует Telegram, а содержание остаётся вашей ответственностью. В Mini App добавляется собственная вёрстка и её отдельная проверка.
Времена и даты форматируйте по понятным правилам, сохраняя однозначность. Перевод месяца помогает чтению, но не определяет часовой пояс встречи. В сводке должны оставаться все условия, необходимые для правильного действия, независимо от выбранной языковой формы.
Работа операторов с разными языками
Передача человеку должна сохранять исходный текст клиента. Если используется перевод для сотрудника, помечайте его как вспомогательный и сохраняйте возможность проверить оригинал. Ошибка перевода может изменить смысл технического параметра или согласия, поэтому важные условия требуют особого внимания.
Не обещайте обслуживание на языке, для которого доступен только интерфейс бота. Если операторская поддержка ограничена, объясните это в подходящем месте. Пользователь должен понимать, кто продолжит сложный вопрос и какие варианты общения действительно доступны.
Внутренние категории можно отображать сотруднику на его языке, сохраняя общий идентификатор. Это помогает маршрутизации и поиску. Однако свободное описание клиента нельзя заменять только названием категории: контекст вопроса остаётся важным при любом языке интерфейса.
Проверка перед выпуском
Пройдите каждый язык от начала до результата, включая неверный ввод, отмену, повтор и передачу человеку. Затем смените язык на незавершённой форме и нажмите старую кнопку. Проверьте сохранность данных, правильность ссылок и отсутствие технических ключей вместо текста.
Отдельно испытайте неизвестную локаль и отсутствующий перевод в тестовой конфигурации. Резервный путь должен быть предсказуемым. Многоязычный бот готов, когда пользователь способен завершить задачу и исправить ошибку на выбранном языке, а команда понимает, какие части обслуживания действительно локализованы.
Числа и составные сообщения
Не собирайте предложение простым склеиванием переведённых слов, если языки имеют разный порядок и согласование. Сообщение о нескольких заявках или выбранных файлах должно оставаться естественным и точным. Для таких случаев используйте поддерживаемый механизм форматирования переводов и проверяйте итоговые варианты с разными значениями.
Особенно внимательно проверяйте ноль, один объект и несколько объектов. Подпись, которая корректна только в одном демонстрационном примере, быстро ломается в рабочем сценарии. Не забывайте параметры времени и названия услуг: они могут приходить из отдельного источника и оставаться непереведёнными. Приёмка должна смотреть на итоговое сообщение целиком, а не только на наличие всех ключей в файле словаря.
Источники
Языковые возможности представлены в Telegram Bot Features, настройка команд — в Bot API: setMyCommands. Полнота словаря и состояние многоязычного сценария являются частью вашего приложения.