연락처 속성(Contact Properties)

연락처 속성을 사용하면 기본 제공 필드(email, name, userId)를 넘어 구조화된 데이터를 대화에 첨부할 수 있습니다. 자유 형식의 metadata와 달리 속성은 타입, 레이블, 검증이 정의된 스키마를 가집니다 — HubSpot이나 Salesforce의 커스텀 필드와 비슷합니다.

속성은 에이전트 설정 → 연락처 속성에서 에이전트별로 정의됩니다. 각 속성은 다음을 가집니다:

Respondo.identify()의 properties 필드에 속성 값을 전달하세요. 키는 에이전트 설정의 속성 정의와 일치해야 합니다.

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
  }
});

통합 스니펫은 속성을 하나 이상 정의하면 에이전트 설정 → 연락처 속성 아래에 모든 속성 키가 미리 채워진 상태로 자동으로 나타납니다. 복사를 클릭해 가져다가 애플리케이션에 붙여 넣으세요. 생성된 스니펫에는 신원 확인(HMAC-SHA256)용 userHash 플레이스홀더도 포함되어 있습니다.

속성 값은 대화의 metadata JSONB 필드에 cp_ 접두사를 붙여 저장됩니다. 예를 들어 키가 account_type인 속성은 cp_account_type로 저장됩니다.

속성은 모든 메시지마다 업데이트됩니다 — 위젯이 새 값을 보내면 기존 값을 덮어씁니다. 즉, 속성 값은 항상 애플리케이션의 최신 데이터를 반영합니다.

Inbox 필터 바나 저장된 뷰(View)를 사용해 속성 값으로 대화를 필터링하세요. 속성(Property) 조건을 추가하고 이름으로 속성을 고르세요 — 선택기는 모든 에이전트에 걸친 모든 정의를 나열하며 정의가 없는 원시 키도 허용합니다 — 그런 다음 값을 선택하세요. 값 필드는 입력하는 동안 관측된 값과 enum 값을 제안합니다.

API에서는 대화 목록 엔드포인트가 cp.<key>=<value> 쿼리 매개변수(attr.<key>의 정확한 별칭)를 받습니다. 자유 텍스트 쿼리 구문은 없습니다:

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

속성 값은 여러분의 애플리케이션이 — 위젯 통합이나 API를 통해 — 설정하며, 대화 상세 패널에서는 읽기 전용입니다. 패널은 연락처 프로필로 이어지는 링크를 제공하며, 상담원은 그곳에서 연락처의 속성을 보고 편집할 수 있습니다(연락처 → 연락처 → 속성).