Отслеживание веб-форм | Документация Alfa-Track

Отслеживание веб-форм выполняется с помощью отправки HTTP POST запроса на сервер Alfa-Track. Разработчик вызывает этот запрос после успешной валидации и отправки формы.

В заявке должен быть указан хотя бы один контакт: email или phone. Поэтому Alfa-Track может отслеживать в том числе формы, в которых посетитель оставляет только номер телефона.

Пример технического задания:

После успешной отправки формы необходимо выполнить POST запрос:


POST /user/open/webhook/send?token={token} HTTP/1.1
Host: cloud.alfa-track.com
Content-Type: application/json

{
  "email": "test@mail.com",
  "gaId": "1234567.345435",
  "ymId": "9876543210123456789",
  "atId": "1234547.345436",
  "message": "Добрый..",
  "name": "Иван",
  "phone": "+78123456789"
}

Описание передаваемых параметров:

Параметр	Описание	Обязательность
token	Get-параметр, токен веб-формы. Доступен в личном кабинете Alfa-Track. Подключения → Отслеживание форм У каждой формы свой уникальный токен.	Да
email	E-mail отправителя формы.	Да, если нет phone
gaId	Google Analytics ClientID. Может заменяться параметром `cId`.	Нет*
ymId	Идентификатор Яндекс.Метрики (clientId).	Нет*
atId	Alfa-Track CID. Можно получить через JS API.	Нет*
message	Текст сообщения.	Нет
name	Имя отправителя.	Нет
phone	Телефон отправителя. Допускаются пробелы, скобки, дефисы и знак `+`; значение должно содержать цифры.	Да, если нет email

Важно: если одновременно не переданы email и корректный phone, сервер вернёт ошибку 400 Bad Request. Если заявка содержит только телефон, Alfa-Track использует нормализованный номер как стабильный идентификатор контакта.

*Важно: хотя бы один параметр из gaId, ymId или atId должен быть передан. Если все значения пустые — сервер вернёт ошибку.

Названия полей в формах Tilda

Вебхук Tilda распознаёт названия полей без учёта регистра. Поддерживаются следующие варианты:

e-mail: email, e-mail, mail, почта;
телефон: phone, tel, telephone, телефон, тел;
имя: name, имя, fio, фио;
сообщение: Comments, Textarea, Text, Message, комментарий, сообщение.

Например, поля Phone, ТЕЛЕФОН и tel будут обработаны как телефон. В форме Tilda также должен присутствовать хотя бы e-mail или телефон.

Асинхронная отправка запроса крайне рекомендуется, так как время отклика сервера Alfa-Track может достигать 30+ секунд.

После получения запроса Alfa-Track автоматически создаёт лид в подключенных CRM системах (если это установлено настройками интеграции) и отправляет события в подключенные системы веб-аналитики, Google Analytics(с параметрами Категория: alfatrack, Действие: leadform), Яндекс.Метрику (цель AlfatrackFormLead и AlfatrackAllLead) и другие.

Подробную инструкцию по подключению форм-трекинга можно найти здесь: читать →