Формы и лиды

Формы Atlas собирают обращения на вашем сайте и превращают каждое из них в лид, которого ваша команда может назначить ответственному, обработать и экспортировать. Формы работают на вашем сайте в Development и, когда Production запущен, на рабочем сайте.

Как это работает

1. Создайте форму в Studio. Поля, подписи, текст согласия, подпись кнопки отправки и сообщение об успехе — в разделе Forms & leads.

2. Ваш сайт отображает её. Он получает описание формы и рисует поля своими компонентами, поэтому форма соответствует вашему дизайну.

3. Посетитель отправляет форму. Браузер отправляет данные напрямую в Atlas. Токен не используется: Atlas принимает только запросы, у которых Origin — зарегистрированный адрес вашего сайта.

4. Atlas проверяет и сохраняет. Сначала выполняются проверки на спам и злоупотребления, затем лид сохраняется, отправляется вашей команде по почте и передаётся в ваши вебхуки.

Development и рабочий сайт

	Сайт в Development	Рабочий сайт (Production)
Когда формы отвечают	Всегда	Когда Production включён и действует подписанный релиз
Какая версия формы	Последний опубликованный черновик	Версия внутри действующего релиза
Допустимый источник	Ваши адреса Development	Только https:// и ваш домен Production
Где появляются лиды	Leads → Development	Leads → Live website («Leads from the live website»)
Письма о лидах	По умолчанию выключены	По умолчанию включены; можно приостановить

Формы попадают в Production внутри релизов, как и страницы. Форма, изменённая в Development, доходит до рабочего сайта со следующим одобренным релизом, а форма, удалённая из релиза, перестаёт там отвечать.

Пока Production выключен, адреса его форм отвечают 404 CP_NOT_FOUND. Если Production включён, но подписанного релиза ещё нет, они отвечают 403 CP_PRODUCTION_LOCKED.

Отображение формы

// GET /v1/public/environments/{environmentId}/forms/{formKey}
// → { key, name, version, fields, settings: { submitLabel, successMessage, consentText },
//     challenge: { provider: 'turnstile', action, siteKey } }

Отобразите fields своими полями ввода. Если challenge.provider равен turnstile, отобразите виджет Cloudflare Turnstile с указанными siteKey и action и разрешите Turnstile в вашей Content-Security-Policy.

Отправка

// POST /v1/public/environments/{environmentId}/forms/{formKey}/submissions
{
  "idempotencyKey": "<new UUID per attempt>",
  "sessionId": "<16–128 chars, A–Z a–z 0–9 _ ->",
  "startedAt": 1761210000000,       // when the visitor opened the form, in ms
  "challengeToken": "<Turnstile token>",
  "website": "",                    // hidden honeypot field; leave empty
  "consent": true,
  "fields": { "name": "…", "email": "…", "message": "…" }
}

Ответ	Значение
201 { status: 'received' }	Принято. Покажите settings.successMessage
422 SUBMISSION_INVALID	Поле не прошло проверку. Покажите ошибки полей
400 SUBMISSION_REJECTED	Отклонено, например из-за непройденной проверки
429	Слишком много отправок. Попросите посетителя повторить позже

Подозрительные отправки помещаются в карантин, но всё равно получают 201, чтобы злоумышленники не могли узнать, что именно было отмечено.

Защита от спама и злоупотреблений

• Проверка Cloudflare Turnstile для каждого сайта.
• Поле-ловушка (honeypot) и минимальное время заполнения.
• Обнаружение дубликатов в течение 10 минут.
• Ограничения частоты по сайту, форме, сессии посетителя и IP-адресу. См. Лимиты.

Вкладка Spam review в Studio показывает отправки из Development, помещённые в карантин. Отправки с рабочего сайта, помещённые в карантин, пока нельзя просмотреть в Studio.

Письма о лидах

Владелец сайта добавляет подключение к почте (SMTP или почтовый провайдер) в разделе Integrations → Email. Пароли и ключи API хранятся в зашифрованном виде, больше не показываются и не записываются в журналы.

В карточке Email for enquiries and leads есть два переключателя:

• Live website: по умолчанию включён, как только Production запущен. Переключите его в «emails paused», чтобы остановить письма, не трогая формы.
• Development: по умолчанию выключен, чтобы тестовые отправки никому не рассылали письма. Тестовые отправки помечаются [Test].

Менять эти переключатели может только администратор сайта. Автоматические ответы посетителям выключены, пока вы их не включите.

Что читать дальше

Работа с лидамиНазначайте, объединяйте, экспортируйте и очищайте лиды и отправляйте их в свою CRM.ЗапускОпубликуйте релиз и включите Production, чтобы формы отвечали реальным посетителям.