Thuộc tính liên hệ

Thuộc tính liên hệ cho phép bạn gắn dữ liệu có cấu trúc vào hội thoại, vượt ra ngoài các trường có sẵn (email, name, userId). Khác với metadata dạng tự do, thuộc tính có lược đồ được định nghĩa với kiểu dữ liệu, nhãn và xác thực — tương tự các trường tùy chỉnh trong HubSpot hoặc Salesforce.

Thuộc tính được định nghĩa cho từng agent trong Cài đặt agent → Thuộc tính liên hệ. Mỗi thuộc tính có:

Truyền giá trị thuộc tính trong trường properties của Respondo.identify(). Các key phải khớp với các định nghĩa thuộc tính từ Cài đặt agent.

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 (truyền dưới dạng chuỗi)
    is_partner: 'true',           // boolean (truyền dưới dạng chuỗi)
    contract_end: '2026-12-31',   // date
    dashboard_url: 'https://app.example.com/org/123'  // url
  }
});

Đoạn mã tích hợp tự động xuất hiện dưới Cài đặt agent → Thuộc tính liên hệ ngay khi bạn đã định nghĩa ít nhất một thuộc tính, với tất cả các key thuộc tính của bạn được điền sẵn. Bấm Sao chép để lấy nó và dán vào ứng dụng của bạn. Đoạn mã được tạo cũng bao gồm một placeholder userHash cho xác minh danh tính (HMAC-SHA256).

Giá trị thuộc tính được lưu trong trường JSONB metadata của hội thoại với tiền tố cp_. Ví dụ, một thuộc tính có key account_type được lưu là cp_account_type.

Thuộc tính được cập nhật trên mỗi tin nhắn — nếu widget gửi giá trị mới, chúng sẽ ghi đè lên giá trị hiện có. Điều này có nghĩa là giá trị thuộc tính luôn phản ánh dữ liệu mới nhất từ ứng dụng của bạn.

Lọc hội thoại theo giá trị thuộc tính bằng thanh lọc của Hộp thư hoặc một Chế độ xem đã lưu. Thêm một điều kiện Property, chọn thuộc tính theo tên — bộ chọn liệt kê mọi định nghĩa trên tất cả các agent của bạn và cũng chấp nhận một key thô chưa có định nghĩa — rồi chọn một giá trị. Ô giá trị gợi ý các giá trị đã quan sát được và mọi giá trị enum khi bạn nhập.

Qua API, các endpoint danh sách hội thoại chấp nhận một tham số truy vấn cp.<key>=<value> (một alias chính xác của attr.<key>). Không có cú pháp truy vấn văn bản tự do:

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

Giá trị thuộc tính được đặt bởi ứng dụng của bạn — qua tích hợp widget hoặc API — và chỉ đọc trong bảng chi tiết hội thoại. Bảng này liên kết đến hồ sơ của liên hệ, nơi nhân viên có thể xem và chỉnh sửa các thuộc tính của liên hệ (Liên hệ → liên hệ → Thuộc tính).