Skip to main content
WhatsApp Flows позволяют клиентам выполнять структурированные задачи прямо в WhatsApp, например выбирать время записи, отправлять заявки или проходить короткие опросы.
Пример экранов WhatsApp Flow от Meta: от кнопки в сообщении через выбор параметров продукта до последующего сообщения.

Meta example: a message opens a multi-screen Flow for product preferences and selection. This illustrates the customer experience, not YCloud's Flow editor.

Источник: официальный пример Meta.

​
Основные компоненты

Flow принадлежит WABA. Его определение описывает экраны, поля ввода, навигацию и поведение при завершении. Некоторые Flows используют данные, переданные при отправке сообщения. Другим требуется эндпоинт данных для получения актуальной информации или обработки выбора во время взаимодействия. Например, Flow для записи на прием может собирать информацию об услуге, желаемой дате и контактных данных. Если необходимо отображать доступность в реальном времени, эндпоинт и ваша система бронирования должны согласовывать эти данные. Meta предоставляет руководства по Flows по проектированию экранов, интеграции эндпоинтов, шифрованию, тестированию и мониторингу работоспособности.

​
Разделение Flow и приглашения к нему

Вы отправляете сообщение, открывающее Flow:
  • Используйте поддерживаемое интерактивное сообщение Flow в пределах открытого сервисного окна.
  • Используйте одобренный шаблон с кнопкой Flow, когда требуется шаблон.
Назначение Flow не определяет категорию шаблона автоматически. Рекламное приглашение и уведомление о записи могут открывать одну и ту же форму, но требовать разной категории шаблона. См. Компоненты и форматы шаблонов и Сервисные сообщения.

​
Создание, тестирование и запуск

В руководстве по Flows API от YCloud описаны создание, получение, обновление, предварительный просмотр, публикация и вывод из эксплуатации Flows. Сохраняйте Flow в статусе черновика во время проверки структуры и тестирования клиентского пути. Публикация — это рубеж жизненного цикла; планируйте создание новой версии при изменении работающего Flow и проверяйте текущие правила API перед попыткой внести изменения на месте. Проверьте:
  • Обязательные поля и некорректный ввод.
  • Переход назад и прерывание процесса.
  • Ошибки эндпоинта или недоступные слоты для записи.
  • Повторные отправки форм.
  • Сообщения о завершении и последующее бизнес-действие.
Завершенный Flow не означает автоматического подтверждения бронирования, оплаты заказа или одобрения заявки. Ваша бизнес-система должна проверить и завершить это действие.

​
Пример: заявка на запись

Удобная первая версия состоит из трех экранов: Используйте статический Flow, если вы просто собираете желаемое время, которое оператор подтвердит позже. Используйте Flow с эндпоинтом, если доступные варианты должны динамически обновляться в зависимости от расписания. Не отображайте статический список как гарантированно доступные слоты. Текст финального экрана должен соответствовать результату. «Заявка получена» подходит, если оператору еще требуется подтвердить запись; «Запись подтверждена» требует успешного резервирования в вашей системе бронирования.

​
Разделение идентификаторов

  • Flow ID идентифицирует повторно используемую форму.
  • ID сообщения идентифицирует конкретное приглашение и его доставку.
  • Токен Flow, если он передан вашей интеграцией, связывает взаимодействие с вашим бизнес-контекстом.
  • Ваш ID бронирования или заявки идентифицирует результирующую бизнес-запись.
Токен должен быть непрозрачной ссылкой, а не паролем или персональными данными клиента. Проверяйте отправленные значения на своем сервере, даже если форма ограничивает доступные варианты.

​
Диагностика на правильном этапе

Эти проверки позволяют не путать проблемы с доставкой с проблемами формы или системы бронирования.

​
Осознанная работа с данными

Собирайте только необходимую информацию. Объясняйте цель её использования и предоставляйте соответствующие сведения о конфиденциальности. Для Flows с использованием эндпоинтов соблюдайте требования Meta к шифрованию и эндпоинтам. Не храните секретные данные в JSON структуры Flow и публичных предпросмотрах. Используйте синтетические данные для тестирования. Сохраняйте и обрабатывайте отправленные данные в правильном контексте клиента. Настройте обработку дубликатов так, чтобы повторная отправка формы не приводила к созданию двух бронирований или списаний.

​
Продолжить работу в YCloud

Отслеживайте доставку Flow, отправку формы и бизнес-результат как отдельные метрики.

​
Часто задаваемые вопросы

Нет. Статический Flow может собирать выбранные варианты или данные без получения динамических данных на каждом экране. Используйте эндпоинт, когда варианты выбора или валидация зависят от текущего состояния ваших систем, например от доступных слотов для записи. Вам также необходимо определить, куда будут поступать заполненные ответы и кто будет их обрабатывать.
Только если ваша система бронирования успешно зарезервировала слот. Заполненная форма может быть лишь запросом, а не подтверждённой записью. Используйте идентификатор запроса (request ID), проверяйте доступность слотов, обрабатывайте дубликаты и формулируйте текст подтверждения в точном соответствии с реальным результатом.
Сама форма и приглашение к её заполнению разделены. Используйте подходящее интерактивное сообщение Flow в рамках сервисного окна или одобренный шаблон с кнопкой Flow, если требуется шаблон. Категория определяется фактической целью приглашения; прикрепление формы не превращает рекламное сообщение в сервисное (utility).