Мультиязычные боты: один бот, много языков

Бот может говорить на нескольких языках. Вы пишете текст один раз — на исходном языке. Для остальных языков добавляете переводы. FlowCastle сам отправляет каждому человеку текст на его языке — и подписи на кнопках тоже. Это работает во всех сценариях и в рассылках.

Откройте Настройки → Общие → Языки. Укажите исходный язык — тот, на котором уже написаны ваши сценарии. Добавьте любые дополнительные языки — подойдёт любой язык, список не ограничен.

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

Под каждым добавленным языком — строка со статусом: сколько текстов ещё не переведено, сколько устарело, и ссылка, которая сразу открывает редактор на этом языке.

Быстрее всего перевести бота — просто попросить. В редакторе сценария нажмите ✨ Перевести всё рядом с переключателем языка. Или откройте AI-чат и напишите что-то вроде «переведи бота на русский».

Перед началом чат покажет карточку со стоимостью: 0,2 кредита за блок за язык. Блоки, которые уже переведены и не устарели, ничего не стоят. Подтвердите — и чат переведёт всё, что отсутствует или устарело. По завершении появятся кнопки Опубликовать и Отменить, как после обычной сборки.

Формулировка не важна. «переведи бота на испанский» сработает так же, как и «translate the bot to Spanish». Если хотите просто узнать, как это работает, спросите в режиме вопросов: «как перевести моего бота?»

Откройте сценарий. Если в приложении есть дополнительные языки, вверху холста появится переключатель языка: 🇬🇧 EN · исходный, 🇷🇺 RU и так далее. Выберите язык — и весь холст покажет текст на нём.

Блоки без перевода получают маленькую метку: RU ○ — перевода нет, RU ◐ — перевод устарел. Рядом с переключателем — счётчик: «RU: 3 без перевода · 2 устарело».

Откройте блок «Сообщение» при выбранном RU — вы редактируете русский текст и подписи русских кнопок. Английский исходник остаётся виден над каждым полем, серым цветом, только для справки. Добавлять и убирать кнопки, менять медиа и настройки здесь нельзя — эта структура общая для всех языков. Чтобы изменить её, переключитесь на исходный язык.

Некоторые боты дают человеку выбрать язык самому, а не угадывают его. Сама кнопка язык не меняет. Каждая кнопка ведёт в блок «Действие», и уже он переключает язык:

1. Добавьте блок Сообщение, например «Выберите язык», с кнопкой на каждый язык.
2. Потяните выход каждой кнопки к новому блоку Действие.
3. В этом блоке нажмите Добавить действие и выберите Установить язык.
4. Оставьте вариант Выбрать язык и укажите язык в поле Язык.
5. Соедините блок «Действие» со следующим шагом, например с главным меню.

Как только человек нажмёт кнопку, FlowCastle запомнит выбор и будет использовать его дальше.

Для каждого сообщения FlowCastle выбирает язык в таком порядке:

1. Человек уже выбрал язык через действие Установить язык? Используется он.
2. Автоопределение включено, и Telegram сообщает язык человека? Используется он.
3. Иначе — используется исходный язык.

Если язык человека не входит в добавленные, он получает исходный язык — так же, как если бы ничего не было выбрано.

Если вы позже измените исходный текст, все его переводы становятся устаревшими — они не пропадают и не удаляются. FlowCastle продолжает отправлять устаревший перевод, пока вы его не обновите: старый перевод лучше, чем никакого.

Запустите «Перевести всё» ещё раз — и оно переделает всё отсутствующее и устаревшее. Переводы, которые вы написали вручную, сохраняются: «Перевести всё» перезапишет их только если вы явно выберете переделать всё, а не только недостающее и устаревшее.

Кое-что намеренно не переводится:

• Нет перевода → бот отправляет исходный текст. Пустое сообщение не уйдёт никогда.
• Подписи динамических кнопок — тех, чей текст берётся из переменной, — не переводятся. Этот текст и так под вашим контролем.
• Текст, который собирает ваш собственный код или формула, тоже не переводится.
• Рассылки используют те же переводы, что и обычные сценарии — настраивать отдельно не нужно.
• Перевод сам по себе ничего не публикует. После перевода нажмите Опубликовать, чтобы новый текст попал к пользователям.

Две системные переменные позволяют использовать язык в сценариях. Обе есть в окне выбора переменных в разделе Системные → User Fields (названия полей внутри пока на английском):

• Language ({{sysvar|language}}) — язык, который FlowCastle реально выбрал по трём правилам выше. Используйте его в блоке «Условие», чтобы разветвить сценарий по языку.
• Language Code ({{sysvar|languageCode}}) — язык, который прислал Telegram, до применения этих правил.

«Формула» в ограничениях выше — это CEL-выражение: короткое вычисление, которое некоторые поля принимают вместо обычного текста.

Переводы доходят до людей только после публикации. Проверьте бота на каждом языке и опубликуйте его: Тест и публикация бота.