Перейти к содержимому
FormFlow

v1.75: сохранить и закончить позже, поля UTM и правила по странам

В v1.75.0 многошаговую форму можно продолжить в течение 7 дней, поля UTM добавляются одним действием, у каждой отправки показывается страна отправителя с правилами «разрешить» и «блокировать», а токен API управления может обновлять отправки. В записи разобран каждый пункт и его границы.

Эта статья переведена машинным способом. Читать оригинал на английском

A dark plate titled 'v1.75: save and finish later, UTM fields and country rules', listing resuming a multi-step Form within 7 days, hidden UTM fields filled from the page address, the country shown per Submission with allow or block rules, and the Management API updating Submissions.

В FormFlow v1.75.0, выпущенном 27 октября 2026 года, четыре пункта, и все — новые возможности. Эта запись объясняет каждый из них и где он заканчивается; официальной записью о релизе остаётся v1.75.0 в списке изменений. v1.75.1 и v1.75.2 — отдельные исправительные релизы со своими записями в списке изменений, и эта запись их не рассматривает.

Дать людям сохранять многошаговую форму и закончить её позже

Включите «Сохранять ответы между шагами» на вкладке «Поля» формы. Переключатель появляется, только когда у формы несколько шагов, и доступен на всех платных тарифах.

  • Оно работает на странице, которую хостит FormFlow, или на встроенной форме с «Динамическим рендерингом». Введённые к этому моменту ответы сохраняются при каждом переходе между шагами.

  • Человек может вернуться с того же устройства в течение 7 дней и продолжить с того места, где остановился, либо выбрать «Начать заново».

  • Файлы никогда не сохраняются. Уведомление сообщает людям, что их ответы сохранены: «Ваши ответы сохраняются по ходу заполнения, чтобы вы могли закончить позже.», на языке, на котором форма показывается отправителю.

  • Сохранённые ответы хранятся в зашифрованном виде, без IP-адреса, местоположения и сведений о браузере рядом.

  • Через час без сохранения запись появляется в «Незавершённые» в панели, а в вашей сводке — как люди, которые начали форму и не закончили.

  • Незавершённые записи никогда не учитываются в вашем использовании, не доставляются и не экспортируются. Они удаляются, когда форма заполнена, не позже чем через 30 дней, или раньше в соответствии со сроком хранения формы; срок хранения объясняет v1.18.

Захват UTM-параметров в ваших формах

Выберите «Добавить поля UTM» в конструкторе, чтобы добавить скрытые поля для utm_source, utm_medium, utm_campaign, utm_term и utm_content. Встроенные формы и компоненты React, Vue, HTML и Blade заполняют любое пустое скрытое поле из адреса страницы, так что каждая отправка показывает, какая кампания её привела. Доступно на всех тарифах.

  • Добавляются только те ключи, которых у формы ещё нет; если все пять уже на месте, оно сообщает об этом и ничего не меняет.

  • Это обычная правка списка полей: пока вы не нажмёте «Сохранить», ничего не сохраняется.

  • В многошаговой форме скрытые поля попадают на первый шаг, потому что скрытое поле должно находиться именно там.

Скрытые значения могут приходить и со ссылки, которую вы пишете сами; см. Предзаполнение формы по её ссылке и передача источника кампании.

Страна каждого отправителя и правила «разрешить» и «блокировать»

Каждая отправка теперь показывает страну отправителя во входящих, в экспорте и в API управления. FormFlow определяет её по IP-адресу на своих собственных серверах и хранит только двухбуквенный код страны, никогда — сам адрес. При этом читается файл базы данных о странах на серверах FormFlow, обновляемый раз в месяц; данные об отправителях его издателю, DB-IP, не передаются.

В настройках «Безопасность» формы есть и «Правило по странам»: по умолчанию «Принимать из всех стран», либо «Разрешить только выбранные мной страны», либо «Заблокировать выбранные мной страны». Доступно на всех тарифах.

  • Отклонённая отправка хранится в отклонённых отправках, чтобы вы могли её восстановить.

  • Отправка, страну которой определить нельзя, проходит всегда.

Обновление отправок через API управления

Токен API теперь может помечать отправку как обработанную или необработанную, как спам или не спам и повторять её неудавшиеся доставки, как вы делаете в панели. Нужно разрешение «submissions:write»; доступно на всех платных тарифах.

  • Обновление: PATCH /api/v1/manage/submissions/{uuid} с булевыми значениями read, handled и spam. Значение, которое у отправки уже есть, ничего не меняет.

  • Прочтение работает в одну сторону. Отправка read: false отклоняется с HTTP 422 и ошибкой read_cannot_be_unset.

  • Повтор: POST /api/v1/manage/submissions/{uuid}/deliveries/retry — тот же повтор, что и у панели, не более 500 доставок за запрос.

  • Токены также могут регистрировать свои вебхуки (REST hooks) через POST /api/v1/manage/hooks, до 10 на форму. Для создания нужны разрешения «hooks:write» и «submissions:read», потому что хук отдаёт ответы наружу. Хук удаляется, когда его токен отозван или истёк, а эндпоинта, который их перечисляет, нет.

Чтобы сначала прочитать данные токеном, см. Чтение отправок с ограниченным токеном API управления.

Чего этот релиз не делает

  • Продолжение работает на одном устройстве и только для формы с несколькими шагами, на платном тарифе. Файлы оно не переносит и за человеком на другое устройство не следует.

  • Незавершённая запись — не отправка: она никогда не доставляется, не экспортируется и не учитывается, поэтому до завершения формы ничего не попадает в ваши вебхуки и экспорт. Ваша сводка лишь упоминает её как людей, которые начали и не закончили.

  • «Добавить поля UTM» добавляет пять стандартных ключей и ничего больше, а адрес страницы заполняет только ещё пустые поля.

  • Правило по странам оценивается по IP-адресу отправителя. Если страну определить нельзя, ничего не записывается, и отправка принимается.

  • API управления не может пометить отправку как непрочитанную, а токен делает это только с теми разрешениями, которые вы ему дали.

Полный текст каждого пункта — в записи о v1.75.0 в списке изменений.