--- title: "Шаблоны WhatsApp Flows JSON и предпросмотр" description: "Бесплатные примеры WhatsApp Flows JSON на шести языках, включая английский и арабский: заявки, бронирование, опросы, opt-in. Просмотр, проверка и копирование JSON." canonical: "https://omnichannels.ai/ru/tools/whatsapp-flows-templates/" language: "ru" updated: "2026-10-10" publisher: "BroadNet Technologies" brand: "OmniChannels.ai" --- # Шаблоны WhatsApp Flows JSON и предпросмотр Canonical: https://omnichannels.ai/ru/tools/whatsapp-flows-templates/ Language: ru Publisher: OmniChannels.ai by BroadNet Technologies WhatsApp Flow — это набор экранов внутри чата, описанных в Flow JSON. Простейший корректный Flow содержит версию, например 7.3, и массив screens. У каждого экрана есть id из букв и подчёркиваний, макет SingleColumnLayout с компонентами и одна кнопка Footer. Между экранами переходят с помощью действий navigate, а последний экран помечается как terminal и выполняет complete, который отправляет ответы на ваш вебхук. ## Как использовать шаблон WhatsApp Flow 1. **Выберите шаблон:** Выберите сценарий, например сбор заявок, бронирование столика или обращение в поддержку, и переключайтесь между языковыми версиями. 2. **Просмотрите экраны:** Нажимайте кнопку в предпросмотре телефона и переходите по экранам точно в том порядке, в котором их увидит клиент. 3. **Скопируйте или скачайте JSON:** Вставьте Flow JSON в редактор Flow в WhatsApp Manager или загрузите его через Flows API, затем опубликуйте. 4. **Проверьте свои правки:** Вставьте изменённый JSON в валидатор, чтобы найти неработающие маршруты, пропущенные поля и подписи, превышающие лимиты Meta по количеству символов. ## Из чего состоит файл WhatsApp Flow JSON В Flow JSON два обязательных свойства: version и screens. У каждого экрана есть id, необязательный title, который отображается в верхней панели, и макет типа SingleColumnLayout, дочерние элементы которого — компоненты: текст, поля ввода, списки выбора, выбор даты, opt-in и одна кнопка Footer. Навигация задаётся в действиях. Footer с navigate открывает следующий экран. На последнем экране, помеченном как terminal, Footer с complete закрывает Flow и отправляет данные вашей компании вместе с flow token. Начиная с Flow JSON 4.0 любой экран может читать поля предыдущего экрана через ${screen.SCREEN_ID.form.field}, поэтому в шаблонах payload в navigate остаётся пустым, а все ответы собираются в итоговом payload действия complete. - version: версия Flow JSON, во всех шаблонах это "7.3". - screens: упорядоченный список экранов; первый экран без входящего маршрута считается стартовым. - routing_model и data_api_version: нужны только Flow, которые обращаются к вашему эндпоинту данных. - terminal и success: отмечают последний экран и то, считается ли завершение на нём успешным. ## Flow с эндпоинтом данных и без него Все двенадцать шаблонов работают без эндпоинта. Им не нужен сервер: варианты ответов записаны прямо в JSON, Meta сама формирует модель маршрутизации, а ответы вы получаете на вебхук, когда клиент завершает Flow. Meta рекомендует Flow без эндпоинта во всех случаях, когда не нужны актуальные данные: такие Flow открываются быстрее и создаются быстрее. Добавляйте эндпоинт данных, если экран зависит от актуальных данных: свободных слотов для записи, меняющейся цены, остатков на складе или проверки по аккаунту клиента. Тогда экраны используют data_exchange, Flow требует data_api_version и routing_model, а ваш эндпоинт должен расшифровывать каждый запрос и отвечать в пределах тайм-аута Meta. Эту часть мы разрабатываем и размещаем для клиентов. ## Лимиты символов и правила компонентов, которые нужно соблюдать Большинство отклонённых Flow не проходят из-за мелких правил. Подписи короткие: 20 символов для текстового поля, текстовой области или выпадающего списка, 30 для группы радиокнопок или флажков, 40 для выбора даты и 35 для кнопки Footer. Названия вариантов ограничены 30 символами, описания — 300. Заголовки могут занимать 80 символов, основной текст — 4 096. На одном экране можно использовать до 50 компонентов, один Footer, две встроенные ссылки, три изображения и пять opt-in. Id экрана может содержать только буквы и подчёркивания, а SUCCESS зарезервирован. В арабских подписях считаются символы, а не байты, поэтому арабская подпись из 20 символов допустима. Валидатор проверяет все эти правила и указывает, какой экран нужно исправить. ## Арабские Flow и RTL для клиентов в странах Персидского залива (GCC) У каждого шаблона есть версия на арабском языке с теми же экранами и названиями полей, поэтому код вашего вебхука обрабатывает оба языка без изменений. На телефоне клиента WhatsApp выводит арабские Flow справа налево; предпросмотр показывает то же направление. В библиотеке есть сценарии, важные для стран Персидского залива: регистрация на предложения к Рамадану и Ид со временем отправки сообщения после ифтара, бронирование столика в ресторане, запросы на просмотр недвижимости и чек-лист документов KYC, в котором клиентов просят не присылать фото удостоверений личности в чат. ## Как отправить Flow клиентам После публикации Flow отправьте его как интерактивное сообщение flow, указав Flow ID, сгенерированный вами flow token, короткий текст кнопки и первый экран. Для каждого шаблона библиотека даёт payload сообщения. Интерактивные сообщения работают только в течение 24-часового окна обслуживания клиента; чтобы написать клиентам первыми, прикрепите Flow к одобренному шаблону сообщения с кнопкой Flow. Когда клиент завершает Flow, WhatsApp показывает ему сводку ответов, а вы получаете полный payload на свой вебхук. Ответьте сообщением с подтверждением, где сказано, что будет дальше и как изменить или отменить запись. ## WhatsApp Flows JSON: частые вопросы ### Какую версию Flow JSON использовать? Используйте 7.3 — именно эту версию Meta рекомендовала для публикации новых Flow, когда мы проверяли её журнал изменений. Старые версии, например 5.0, заморожены: Flow на них можно отправлять, но нельзя публиковать. ### Нужен ли для этих шаблонов сервер или эндпоинт данных? Нет. Все шаблоны работают без эндпоинта. Варианты ответов записаны в JSON, а ответы приходят на ваш вебхук, когда клиент нажимает последнюю кнопку. Эндпоинт нужен только для актуальных данных, например свободных слотов или цен. ### Как использовать шаблон в WhatsApp Manager? Создайте Flow в WhatsApp Manager, откройте редактор JSON, замените его содержимое шаблоном, проверьте предпросмотр и опубликуйте. Создать и опубликовать Flow можно и через Flows API. ### Можно ли редактировать подписи и варианты ответов? Да. Меняйте любой текст, добавляйте или удаляйте варианты и поля, затем вставьте JSON в валидатор. Он предупредит, если подпись превышает лимит символов или маршрут ведёт на несуществующий экран. ### Почему мой Flow не публикуется? Частые причины: подпись длиннее лимита, id экрана с цифрами или дефисами, экран terminal без Footer, действие complete на экране, который не является terminal, и data_exchange без data_api_version и модели маршрутизации. ### Арабские шаблоны отображаются справа налево? Да. Они написаны на арабском, и WhatsApp показывает их справа налево. Названия полей и id вариантов остаются на английском, поэтому один и тот же код вебхука работает для обоих языков. ### Можно ли собирать через Flow документы, удостоверяющие личность? В Flow есть компоненты выбора фото и документов, но чувствительные загрузки требуют аккуратной обработки. Шаблон KYC только уточняет, какие документы есть у клиента, и записывает его на безопасную передачу, поэтому изображения удостоверений не попадают в чат. ### Этот валидатор — то же самое, что валидатор Meta? Нет. Он выполняет базовые статические проверки по ошибкам, описанным в документации Meta. Валидатор Meta в WhatsApp Manager дополнительно проверяет выражения и модели данных, поэтому публикуйте Flow только после того, как он не покажет ошибок.