Канонические поля

Полный справочник наших внутренних полей лида — для тех, кто настраивает field mapping или хочет понимать структуру данных.

Личные данные (PII)

Поле	Тип	Хранение	Описание
first_name	string	plain	Имя.
last_name	string	plain	Фамилия.
full_name	string	plain	Полное имя. Авто-собирается, если не передано.
email	string	encrypted + sha256 hash	Email. Шифруется на rest, хэш для поиска.
phone	string	encrypted + sha256 hash	Телефон. Шифруется на rest, хэш для поиска.
ip	string	encrypted	IP клиента.
user_agent	string	plain	UA клиента.

PII шифрование

email, phone, ip шифруются через Laravel encrypted cast. В БД лежат только шифрограммы. Дополнительно хранится email_hash / phone_hash — sha256 от соли + значения, используется для поиска и дедупликации. Партнёру эти хэши никогда не показываются.

Идентификация

Поле	Тип	Описание
external_id	string	Ваш id у себя. Уникален per партнёр.
affiliate_id	int	Наш id вашего партнёрского аккаунта (заполняется автоматически).
uuid	string	Внутренний UUID лида.

Geo / locale

Поле	Тип	Описание
country	string	Страна. ISO-2 предпочтителен, но принимаем любую строку.
country_code	string	2-буквенный ISO. Авто-выводится из country, если можно.
language	string	Язык клиента (ru, en, ...).

Tracking / источник

Поле	Тип	Описание
source	string	Источник трафика (facebook_ads, google, email, ...).
funnel	string	Имя воронки, по которой пришёл.
sub_id	string	Ваш sub-id.
click_id	string	Ваш click-id.
landing_url	string	URL посадки.

Системные

Поле	Тип	Описание
status_id	int	FK на справочник статусов.
status_code	string	Дублирует код статуса для удобства фильтров.
assigned_user_id	int	Кому распределён лид (внутренний agent id).
team_id	int	Команда, в которой работает агент.
last_activity_at	timestamp	Последняя активность по лиду.
assigned_at	timestamp	Момент распределения.
client_id	int	Если лид стал клиентом — id записи в таблице clients.
metadata	jsonb	Всё, что не попало в канонические поля.

Поля, которые не возвращаются партнёру

В callback'ах и GET /status ответах вы получаете только то, что относится к вам и не относится к финансам:

• ❌ assigned_user_id, team_id — внутренняя информация.
• ❌ email_hash, phone_hash — security.
• ❌ Что-либо денежное — по договору.

Если поле есть у вас, но нет у нас

Положите его в metadata (или просто в верхний уровень — мы автоматически закинем в metadata всё, что не замапили). Это поле видно агентам в карточке лида, но не используется в логике распределения / статусов.