Свойства контактов

Свойства контактов позволяют прикреплять к диалогам структурированные данные помимо встроенных полей (email, имя, userId). В отличие от произвольных metadata, свойства имеют определённую схему с типами, метками и валидацией — по аналогии с пользовательскими полями в HubSpot или Salesforce.

Свойства задаются для каждого агента в разделе Настройки агента → Свойства контактов. У каждого свойства есть:

Передавайте значения свойств в поле properties метода Respondo.identify(). Ключи должны совпадать с определениями свойств из настроек агента.

Respondo.identify({
  email: 'user@example.com',
  name: 'Jane Smith',
  userId: 'usr_456',
  properties: {
    account_type: 'enterprise',   // enum
    region: 'eu-west',            // string
    monthly_spend: '15000',       // number (передаётся как строка)
    is_partner: 'true',           // boolean (передаётся как строка)
    contract_end: '2026-12-31',   // date
    dashboard_url: 'https://app.example.com/org/123'  // url
  }
});

Сниппет интеграции появляется автоматически в разделе Настройки агента → Свойства контактов, как только вы определили хотя бы одно свойство, — все ваши ключи свойств уже подставлены. Нажмите Копировать, чтобы забрать его, и вставьте в своё приложение. Сгенерированный сниппет также содержит плейсхолдер userHash для проверки личности (HMAC-SHA256).

Значения свойств хранятся в поле metadata (JSONB) диалога с префиксом cp_. Например, свойство с ключом account_type хранится как cp_account_type.

Свойства обновляются при каждом сообщении — если виджет присылает новые значения, они перезаписывают существующие. Это значит, что значения свойств всегда отражают самые свежие данные из вашего приложения.

Фильтруйте диалоги по значениям свойств через панель фильтров Инбокса или сохранённое представление. Добавьте условие Свойство, выберите свойство по имени — список показывает все определения по всем вашим агентам и также принимает произвольный ключ без определения — затем выберите значение. Поле значения подсказывает наблюдавшиеся значения и значения enum по мере ввода.

Через API эндпоинты списка диалогов принимают query-параметр cp.<key>=<value> (точный алиас attr.<key>). Свободного текстового синтаксиса запросов нет:

GET /api/v1/conversations?cp.account_type=enterprise

Значения свойств задаются вашим приложением — через интеграцию виджета или API — и доступны только для чтения в панели деталей диалога. Панель ссылается на профиль контакта, где операторы могут просматривать и редактировать атрибуты контакта (Контакты → контакт → Атрибуты).