Обзор

Форма в Пачке — модальное окно с полями, которые задаёт бот. В API форму называют представлением (view). Сотрудник заполняет и отправляет форму, а результат приходит на сервер бота.

Модальное окно

Модальное окно состоит из стандартных элементов - заголовка, кнопки закрытия (отмены), набора полей (подзаголовки, текст, ввод текста, выбор, списки и тд.) и кнопки отправки.

Модальное окно

Жизненный цикл модального окна

Всё начинается с того, что пользователь нажимает Data-кнопку в сообщении бота.

• В результате нажатия кнопки вашему приложению отправляется исходящий вебхук с уникальным trigger_id;
• Затем приложение формирует представление и отправляет его, а пользователю отображается модальное окно;
• Далее пользователь заполняет блоки представления и вашему приложению отправляется исходящий вебхук с данными заполненных пользователем полей в представлении;
• В ответе на вебхук ваше приложение может отправить список ошибок, которые необходимо отобразить пользователю в представлении, или ответить кодом 200 (после чего модальное окно будет закрыто).

Если у бота не задан адрес исходящего вебхука, события приходят в журнал событий, а отвечать на отправку формы нужно отдельным методом.