> 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/otpravka-whatsapp-flow.md).
# Отправка WhatsApp Flow
В системе поддерживается запуск сценариев WhatsApp Flows через исходящие сообщения.\
Flow позволяет собрать данные пользователя (регистрация, запись на курс, заявка, анкета и т.д.) прямо внутри WhatsApp без перехода на внешний сайт.
В системе поддерживаются два типа исходящих сообщений:
1. [Запуск Flow через шаблонное сообщение](#zapusk-flow-cherez-shablonnoe-soobshenie)
2. [Запуск Flow через Сервисное (бесплатное) сообщение.](#zapusk-flow-cherez-servisnoe-besplatnoe-soobshenie)
{% hint style="info" %}
Важно**:** для отправки сценария Flow он должен быть **опубликован (published).**
Подробнее о создании сценария и публикации [здесь](/docs/russkii/api-1msg/whatsapp-flow/sozdanie-whatsapp-flows.md).
{% endhint %}
***
## Запуск Flow через шаблонное сообщение
Когда используется:
* Пользователь ещё не писал (нет 24-часового окна);
* Нужно инициировать диалог;
* Нужно отправить форму регистрации / заявку / анкету;
* Нужно запустить лидогенерацию.
{% stepper %}
{% step %}
#### Создание шаблона c кнопкой Flow
Создание шаблона через addTemplate. Посмотреть метод и пример создания — [в API документации](https://1msg-docs.web.app/ru#tag/Shablony/operation/addTemplate).
{% endstep %}
{% step %}
#### Отправка шаблона с кнопкой Flow
Ожидайте одобрения созданного шаблона от WhatsApp. После одобрения отправьте шаблон через sendTemplate. Посмотреть метод и пример отправки — [в API документации](https://1msg-docs.web.app/ru#tag/Shablony/operation/sendTemplate).
Отправка шаблона с кнопкой типа FLOW
**Пример отправки шаблона с кнопкой типа `flow` :**
```postman_json
{
"type": "button",
"sub_type": "flow",
"index": "0"
}
```
**Пример отправки шаблона с кнопкой типом `flow` с передачей `flow_token` и `flow_action_data`.**
Используйте `flow_action_data` , чтобы передать во flow начальные входные данные.
```postman_json
{
"type": "button",
"sub_type": "flow",
"index": "0",
"parameters": [
{
"type": "action",
"action": {
"flow_token": "flow_demo_00001",
"flow_action_data": {
"fname": "Anna",
"lname": "Stakina",
"age": "30"
}
}
}
]
}
```
| Parameter | Description |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------- |
| flow\_token | Необязательный параметр
Токен flow, генерируемый компанией и служащий в качестве идентификатора.
|
| flow\_action\_data | Необязательный параметр
JSON-объект с данными для первого экрана
|
{% endstep %}
{% step %}
#### Получите сообщение об успешном заполнении Flow
Как только клиент завершит заполнение формы и отправит данные — вы получите уведомление через webhook. Если у вас включена опция сохранения сообщений — данное входящее сообщение с сохраненными параметрами от Flow будет сохранено в методе messages.
{% hint style="info" %}
Ответ клиента открывает 24-часовое окно для дальнейшей коммуникации либо его продлевает.
{% endhint %}
{% endstep %}
{% endstepper %}
***
## Запуск Flow через Сервисное (бесплатное) сообщение
Если пользователь уже написал и окно активно:
* Flow можно отправить как интерактивное сообщение
* Не требуется шаблон
* Не требуется предварительная модерация текста
{% stepper %}
{% step %}
#### Отправка сообщения с кнопкой Flow
Отправляйте сценарий Flow через sendFlow без предварительного одобрения от WhatsApp. Посмотреть метод и пример отправки — [в API документации.](https://1msg-docs.web.app/ru#tag/Obmen-soobsheniyami/operation/sendFlow)
Отправка сообщения с кнопкой FLOW
**Пример кнопки `flow` :**
```postman_json
{
"body": "Please complete the flow.",
"flowId": "25999010459692480",
"flowToken": "flow_demo_25999010459692480",
"flowCta": "Open flow"
}
```
**Пример кнопки `flow` c передачей `flowActionPayload`.** Используйте `flowActionPayload`, чтобы передать во flow первичные входные данные.
```postman_json
{
"phone": "{{phone}}",
"header": "Header",
"body": "Please complete the flow.",
"footer": "Footer",
"flowId": "{{flow_id}}",
"flowToken": "flow_demo_1234",
"flowMessageVersion": "3",
"flowCta": "Button GO!",
"flowAction": "navigate",
"flowActionPayload": {
"screen": "JOIN_NOW",
"data": {
"fname": "Anna",
"lname": "Stakina",
"age": "30"
}
}
}
```
{% endstep %}
{% step %}
#### Получите сообщение об успешном заполнении Flow
Как только клиент завершит заполнение формы и отправит данные — вы получите уведомление через webhook. Если у вас включена опция сохранения сообщений данное входящее сообщение с сохраненными параметрами от Flow будет сохранено в методе messages.
{% endstep %}
{% endstepper %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## 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, and the optional `goal` query parameter:
```
GET https://help.1msg.io/docs/russkii/api-1msg/whatsapp-flow/otpravka-whatsapp-flow.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.