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

Отслеживание веб-форм выполняется с помощью отправки HTTP POST запроса на сервер 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 отправителя формы.	Да
gaId	Google Analytics ClientID. Может заменяться параметром `cId`.	Нет*
ymId	Идентификатор Яндекс.Метрики (clientId).	Нет*
atId	Alfa-Track CID. Можно получить через JS API.	Нет*
message	Текст сообщения.	Нет
name	Имя отправителя.	Нет
phone	Телефон отправителя.	Нет

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

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

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

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