> 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/sozdanie-whatsapp-flows.md).

# Создание WhatsApp Flows

Вы можете создавать **WhatsApp Flows** с помощью конструктора Meta Flow Builder или использовать API от 1MSG для программного управления.

* [Создание Flow с помощью Meta's Flow Builder](#sozdanie-flow-cherez-flow-builder-v-whatsapp-manager)
* [Создание сценария Flow с помощью API 1MSG](#sozdanie-scenariya-flow-s-pomoshyu-api-1msg)

***

## Создание Flow через Flow Builder в WhatsApp Manager

### Создание сценария Flow

{% hint style="warning" %}
Для создания цепочек сообщений с помощью интерфейса **Flow Builder от Meta** вам необходим доступ к вашему WhatsApp Manager.
{% endhint %}

Это один из самых простых и быстрых способов создания WhatsApp Flow.

Используйте интерфейс **Flow Builder в WhatsApp Manager** для создания, редактирования сценариев (Flow).

{% stepper %}
{% step %}
Перейдите в ваш **WhatsApp Manager** и выберите  **Инструменты управления > Сценарии.**

<figure><img src="/files/8RxALEsBsCShK8SZvLxd" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Выберите **"Начать"** либо, если уже Flow есть, нажать "Создать сценарий" (как в нашем скрине выше).
{% endstep %}

{% step %}
Заполните **Название** и **Категорию** Flow, и выберите тип шаблона: статичный или динамический Flow. Нажмите "Создать".

***Примечание**: Уже сейчас вы можете создать статичные и динамические Flow. Для динамических Flow требуется генерация encryption key pair и настройка Setup Data Channel для обеспечения безопасной передачи данных. Функциональность генерации Setup Data Channel сейчас в разработке. По уточнению сроков реализации — просьба обратиться в поддержку.*
{% endstep %}

{% step %}
После создания Flow откроется **редактор JSON-файлов** с предварительным просмотром в реальном времени справа.&#x20;

* Определите экраны и компоненты для вашего потока.&#x20;
* Выберите «Выполнить», чтобы просмотреть любые изменения, такие как обновление заголовков или других параметров.

<figure><img src="/files/IoT66SnM4vAZcyfMhQzE" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Когда вы убедитесь, что всё настроено правильно, **нажмите «Сохранить»**
{% endstep %}
{% endstepper %}

### Playground — быстрый способ настройки JSON-файла

Бизнес может сформировать сценарий **без знания программирования** и работы непосредственно с JSON-файлом. Для этого используйте [Playground](https://developers.facebook.com/docs/whatsapp/flows/playground).

В разделе Playground можно:

* быстро создать базовый сценарий через приятный визуальный редактор.&#x20;
* протестировать логику.
* собрать структуру экранов.
* проверить корректность через превью.

{% hint style="success" %}
Playground удобен для первичной сборки сценария без глубокой разработки.

**Не требует программирования.**
{% endhint %}

<figure><img src="/files/W4PXM3u9Y13dw5fodTHU" alt=""><figcaption></figcaption></figure>

Когда базовая логика настроена, можно скопировать JSON-файл:

* **Вставка сразу в Flow Builder** – чтобы сразу создать Flow в WhatsApp Manager и протестировать работу сценария.
* **Передача разработчикам** – если нужен более сложный или кастомизированный Flow, они смогут доработать JSON (например, добавить условия, интеграции, динамические данные).

<details>

<summary>Когда требуется доработка разработчиком?</summary>

Разработчик подключается, если нужно:

* добавить условную логику
* интегрировать endpoint
* настроить динамические данные
* оптимизировать структуру JSON
* исправить ошибки валидации
* кастомизировать названия полей и т.д.&#x20;

</details>

### Публикация сценария Flow <a href="#publish-a-flow-build-a-flow-using-the-flow-builder" id="publish-a-flow-build-a-flow-using-the-flow-builder"></a>

При создании или редактировании и сохранении измененного JSON-содержимого потока он остается в состоянии «Черновик». Черновые Flow доступны только для тестирования. Если вы хотите отправить свой поток более широкой аудитории, вам необходимо его опубликовать.

Чтобы опубликовать flow:

* Устраните все ошибки валидации и [проверки публикации.](https://developers.facebook.com/docs/whatsapp/flows/guides/healthmonitoring#publishing-checks)
* Убедитесь, что сценарий соответствует [принципам проектирования сценариев](https://developers.facebook.com/docs/whatsapp/flows/guides/bestpractices) WhatsApp.&#x20;
* Убедитесь, что процесс соответствует [Политике обмена сообщениями WhatsApp Business](https://business.whatsapp.com/policy).
* Когда все будет готово, зайдите внутрь Flow и выберите «**Опубликовать**».

***

## Создание сценария Flow с помощью API 1MSG

Раздел **Flows** содержит методы для управления сценариями WhatsApp Flows.\
Все методы работают через API и позволяют создавать, редактировать, получать превью и публиковать сценарии.

Ссылка на документацию:

{% embed url="<https://docs.1msg.io/#tag/Groups>" %}

Кратко по методам:

**Create a Flow:** создаёт новый сценарий. Возвращает идентификатор созданного flow и его основные метаданные

**Get Flows List:** возвращает список всех созданных сценариев на текущем канале с их статусами.

**Get Flow Details:** получает подробную информацию о конкретном сценарии по его идентификатору.

**Update Flow Metadata:** обновляет существующий сценарий (например, название, описание)

**Update Flow JSON:** обновляет JSON-структуру экранов или настройки.

**Delete Flow:** удаляет сценарий. Возможно только для flow в статусе draft.

**Get Flow Preview:** возвращает превью сценария для тестирования перед публикацией.

**Publish Flow:** публикует сценарий и переводит его в статус published, делая доступным для использования в шаблонах и сообщениях.

**Deprecate Flow:** переводит опубликованный сценарий в неактивный статус, чтобы он больше не использовался в новых сообщениях.

***

## Полезные материалы

1. [Playground](https://developers.facebook.com/docs/whatsapp/flows/playground) - быстрый способ настройки JSON-файла без программирования.
2. [Советы ](https://developers.facebook.com/docs/whatsapp/flows/guides/bestpractices)по настройке Flow для бизнеса (Best Practices).
3. [Описание](https://developers.facebook.com/docs/whatsapp/flows/reference/flowjson) структуры JSON-файла.

Use Case от Meta:

1. [Руководство №1](https://developers.facebook.com/docs/whatsapp/flows/gettingstarted/purchase-intent): Сбор информации о заинтересованности в покупке.
2. [Руководство №2](https://developers.facebook.com/docs/whatsapp/flows/gettingstarted/pre-approved-loan): Получение потенциальных клиентов для предварительного одобрения кредита/кредитной карты.
3. [Руководство №3](https://developers.facebook.com/docs/whatsapp/flows/gettingstarted/personalised-offer): Привлечение внимания к персонализированному предложению.
4. [Руководство №4](https://developers.facebook.com/docs/whatsapp/flows/gettingstarted/health-insurance): Страховое предложение.

***

## Отправка WhatsApp Flow

{% content-ref url="/pages/6VsKsvtwcof55Sst6SLn" %}
[Отправка WhatsApp Flow](/docs/russkii/api-1msg/whatsapp-flow/otpravka-whatsapp-flow.md)
{% endcontent-ref %}


---

# 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/sozdanie-whatsapp-flows.md?ask=<question>&goal=<endgoal>
```

`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.
