> For the complete documentation index, see [llms.txt](https://help.1msg.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.1msg.io/docs/russkii/api-1msg/whatsapp-flow.md).
# WhatsApp Flow
## Что такое WhatsApp Flow
**WhatsApp Flow** — это интерактивная многошаговая форма внутри чата WhatsApp, позволяющая пользователю выполнять действия без перехода на внешний сайт.
Вы можете **записываться на прием, просматривать товары, собирать отзывы клиентов, получать новые потенциальные клиенты** или делать что-либо еще, где структурированное общение более естественно или комфортно для ваших клиентов.
{% columns %}
{% column %}
{% endcolumn %}
{% column %}
WhatsApp Flow работает как единый интерфейс с экранами, а не как последовательность отдельных сообщений в отличие от обычного бота в ленте сообщений.
**Преимущества:**
* Цельный интерфейс вместо «простыни» сообщений;
* Высокая конверсия;
* Улучшенный UX;
* Структурированные данные;
* Работа с реальными данными с вашего backend-сервера.
{% endcolumn %}
{% endcolumns %}
***
## Преимущества Flow в сравнении с обычным ботом
#### — **Цельный интерфейс вместо «простыни» сообщений**
{% columns %}
{% column %}
Обычный бот:
❌ Длинная переписка, неудобно.
{% endcolumn %}
{% column %}
WhatsApp Flow:
✅ Меньше хаоса в переписке.
{% endcolumn %}
{% endcolumns %}
***
#### — **Структурированные данные**
{% columns %}
{% column %}
Обычный бот:
❌ пользователь может написать текст в свободной форме, данные некорректны
{% endcolumn %}
{% column %}
WhatsApp Flow:
✅ поля валидируются, данные приходят структурированными, меньше ошибок
{% endcolumn %}
{% endcolumns %}
***
#### — **Возможность динамики**
WhatsApp Flow может заменить полноценное веб-приложение.
{% columns %}
{% column width="50%" %}
❌Обычный бот в ленте чаще всего не обновляет данные в реальном времени
{% endcolumn %}
{% column width="50%" %}
✅ WhatsApp Flow может обновлять данные в реальном времени (проверять остатки, подтягивать слоты записи и тп).
{% endcolumn %}
{% endcolumns %}
***
А еще:
{% columns %}
{% column width="50%" %}
#### **Более высокая конверсия**
Пользователь проходит сценарий быстрее и реже «теряется».
✔️ удерживает внимание в одном интерфейсе
✔️ не требует прокрутки чата
✔️ не разбивает процесс на 10 сообщений
{% endcolumn %}
{% column width="50%" %}
#### **Улучшенный UX**
Снижает трение и увеличивает завершение сценария.
✔️ выглядит как встроенное приложение
✔️ не требует перехода на сайт
✔️ не открывает браузер
✔️ работает прямо внутри WhatsApp
{% endcolumn %}
{% endcolumns %}
***
## Типы WhatsApp Flow
Существует два типа WhatsApp Flow: **статические** и **динамические**.
#### Статические WhatsApp Flow (**Static flow)**
Статические Flow — это простые формы, предназначенные для сбора структурированных данных (например, сбор лидов, контактов, записи на услугу, регистрация на мероприятие или интерес к продукту).
Особенности статических Flow:
* **Предопределённая структура**: все шаги (экраны, действия, переходы) фиксированы заранее; не требуют подключения backend-сервера;
* **Путь пользователя ограничен**: нельзя динамически менять следующий экран или логику перехода на основе данных, полученных в процессе.
* **Данные отправляются в конце** (например, результат формы), но между экранами их передача ограничена.
* **Используется для**: простых анкет, опросов, инструкций с фиксированными шагами.
* **Поддерживают** все компоненты (формы, выборы, кнопки), кроме изображений.
Пример:
1. Экран A → Экран B → Экран C
2. Результаты собираются в конце и отправляются на сервер.
Между A и B вы не можете изменить следующий экран на основе введённых данных — маршрут заранее фиксирован.
#### Динамические WhatsApp Flow (Dynamic flow)
Динамические Flow подходят для более сложных сценариев, таких как запись на приём, создание заказа сразу в CRM, резервирование товара, показ персональных предложений, проверка статуса заказа и многое другое.
Особенности диначеских Flow:
* **Гибкая структура**: путь пользователя может меняться на лету в зависимости от данных, которые вводит, или событий с сервера. Взаимодействие в реальном времени;\
обмен данными с backend-сервером.
* **Передача данных между экранами**: полноценная, можно использовать промежуточные значения для вычислений и определения следующих шагов.
**Используется для**: персонализированных сценариев, сложных логик, например:
* Если пользователь выбрал “Да” → следующий экран X
* Если “Нет” → следующий экран Y
* **Данные могут отправляться в любой момент**, не только в конце, и на их основе строятся новые ветки потока.
* **Поддерживают** все компоненты (формы, выборы, кнопки), в том числе и изображения.
Пример**:**
1. Экран A → пользователь вводит число
2. Экран B → если число > 10 → Экран C, иначе → Экран D
3. Экран C/D → результат отправляется на сервер
***
## **Примеры WhatsApp Flow**
{% tabs %}
{% tab title="Регистрация" %}
**Регистрация**
{% endtab %}
{% tab title="Бронирование" %}
**Бронирование**
{% endtab %}
{% tab title="Сбор отзыва" %}
**Сбор отзыва**
{% endtab %}
{% tab title="Опрос" %}
**Опрос**
{% endtab %}
{% tab title="Ответ клиента" %}
Пользователь всегда имеет доступ к своим выбранным ответам и введённым данным непосредственно в истории диалога с вами.
{% endtab %}
{% endtabs %}
***
## Ограничения
{% hint style="warning" %}
WhatsApp Flow не поддерживается в WhatsApp Web и в WhatsApp Desktop (Windows / Mac)
{% endhint %}
Ограничения Flow:
* До 8 экранов на один WhatsApp Flow
* До 30 компонентов на экран.
***
## Как начать работу с WhatsApp Flow
{% stepper %}
{% step %}
### Создание WhatsApp Flow
Создается структура экранов и настраиваются поля и логика переходов.
Можно создать WhatsApp Flow через интерфейс Meta либо через API 1MSG.
Подробнее в статье:
{% content-ref url="/pages/Totaj4dtT0YnBol99hXp" %}
[Создание WhatsApp Flows](/docs/russkii/api-1msg/whatsapp-flow/sozdanie-whatsapp-flows.md)
{% endcontent-ref %}
{% endstep %}
{% step %}
### Публикация WhatsApp Flow
WhatsApp Flow проходит публикацию и становится доступным для использования.
{% endstep %}
{% step %}
### Привязка к шаблону
WhatsApp Flow прикрепляется к шаблонному сообщению, через которое он будет запускаться пользователю.
Вы также можете отправить его **как сервисное (бесплатное) сообщение.**
Подробнее в статье - Отправка WhatsApp Flow сообщения
{% endstep %}
{% step %}
### Отправка клиенту
WhatsApp Flow отправляется через API 1MSG.
{% content-ref url="/pages/6VsKsvtwcof55Sst6SLn" %}
[Отправка WhatsApp Flow](/docs/russkii/api-1msg/whatsapp-flow/otpravka-whatsapp-flow.md)
{% endcontent-ref %}
{% endstep %}
{% step %}
### Получение данных
После завершения:
* данные передаются через webhook
* либо обрабатываются backend-сервером (для динамических Flow)
{% endstep %}
{% endstepper %}