Какие события можно отправлять
CDP не ограничивается заранее заданными событиями. Можно отправлять любые business events: order_created, tariff_changed, lead_qualified, bonus_used, support_ticket_closed. Главное — стабильное имя события и понятные атрибуты.
REST-пример
POST /v1/projects/{projectUuid}/events
{
"nameEvent": "order_created",
"email": "client@example.com",
"softId": "crm:100500",
"attributes": {
"order.amount": "1590",
"order.status": "paid",
"product.category": "books"
}
}Как передавать сложные данные
В текущем REST DTO атрибуты передаются как Map<String, String>. Поэтому вложенную бизнес-структуру лучше разворачивать в стабильные ключи: order.amount, order.status, product.category. Так builder отчётов легче воспринимает данные, а пользователю проще выбирать поля.
Связь с customer
Если передать customerUUID, событие прикрепится к известному customer. Если customerUUID нет, используйте email, phone, softId или fingerprint: cdp_customer сможет связать или создать профиль по сигналам.
Технически: пользователь работает во frontend через REST в gateway. Внутри CDP используется контур gateway → event; customer resolution выполняется через cdp_customer по identity-сигналам. Пользователю это нужно знать только для диагностики: если UI показывает ошибку, смотрите route, HTTP-статус gateway и связанный сервис.
