# 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 %}
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://help.1msg.io/docs/russkii/api-1msg/whatsapp-flow.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.