Sifat Kenalan

Takrifkan medan tersuai untuk kenalan — seperti jenis akaun, wilayah atau peringkat kontrak — dan hantarkannya melalui widget. Sifat ini dipaparkan pada profil kenalan, boleh disunting oleh kakitangan, dan boleh ditapis dalam Peti Masuk.

Gambaran Keseluruhan#

Sifat Kenalan membolehkan anda melampirkan data berstruktur pada perbualan, melangkaui medan terbina dalam (email, name, userId). Tidak seperti metadata yang berbentuk bebas, sifat mempunyai skema yang jelas dengan jenis, label dan pengesahan — serupa dengan medan tersuai dalam HubSpot atau Salesforce.

Takrifkan skema

Cipta takrifan sifat dalam Tetapan Ejen dengan jenis seperti string, number, enum, boolean, date, url

Hantar daripada widget

Hantar nilai sifat melalui Respondo.identify() — ia disimpan dan dipaparkan secara automatik

Tapis & sunting

Tapis perbualan mengikut nilai sifat dalam Peti Masuk. Operator boleh melihat dan menyunting atribut kenalan pada profil kenalan.

Menakrifkan Sifat#

Sifat ditakrifkan bagi setiap ejen dalam Tetapan Ejen → Sifat Kenalan. Setiap sifat mempunyai:

Medan	Penerangan
key	Pengecam unik yang digunakan dalam kod. Dijana automatik daripada label (boleh disunting). Huruf kecil, digit dan garis bawah; mesti bermula dengan huruf; 2-63 aksara. Kunci sistem (`user_id`, `visitor_id`, `timezone`, `page_url`, …) adalah terpelihara. Contoh: `account_type`
label	Nama mesra pengguna yang dipaparkan dalam papan pemuka. Contoh: "Account Type"
type	Jenis nilai: `string`, `number`, `boolean`, `enum`, `date`, `url`
enum_values	Untuk jenis `enum` — senarai nilai yang dibenarkan. Contoh: `["starter", "pro", "enterprise"]`
is_filterable	Dikhaskan untuk kawalan penapis pada masa hadapan; disimpan bersama takrifan, tetapi pemilih penapis Peti Masuk buat masa ini menyenaraikan semua sifat yang ditakrifkan (lalai: true)
is_visible	Dikhaskan untuk kawalan paparan pada masa hadapan; disimpan bersama takrifan tetapi belum dikuatkuasakan dalam UI (lalai: true)

Sehingga 50 sifat bagi setiap ejen. Sifat boleh disusun semula dengan seret dan lepas dalam antara muka tetapan.

Hantar nilai sifat dalam medan properties pada Respondo.identify(). Kunci mesti sepadan dengan takrifan sifat daripada Tetapan Ejen.

Integrasi widgetjavascript

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 (dihantar sebagai string)
    is_partner: 'true',           // boolean (dihantar sebagai string)
    contract_end: '2026-12-31',   // date
    dashboard_url: 'https://app.example.com/org/123'  // url
  }
});

Semua nilai sifat dihantar sebagai string. Papan pemuka mengendalikan paparan mengikut jenis (contohnya, boolean → Ya/Tidak, url → pautan boleh klik, enum → lencana).

Coretan Integrasi#

Coretan Integrasi muncul secara automatik di bawah Tetapan Ejen → Sifat Kenalan sebaik sahaja anda menakrifkan sekurang-kurangnya satu sifat, dengan semua kunci sifat anda telah diisi. Klik Salin untuk mengambilnya dan tampal ke dalam aplikasi anda. Coretan yang dijana turut menyertakan placeholder userHash untuk pengesahan identiti (HMAC-SHA256).

Bagaimana Nilai Disimpan#

Nilai sifat disimpan dalam medan JSONB metadata pada perbualan dengan awalan cp_. Sebagai contoh, sifat dengan kunci account_type disimpan sebagai cp_account_type.

Sifat dikemas kini pada setiap mesej — jika widget menghantar nilai baharu, nilai itu menulis ganti nilai sedia ada. Ini bermakna nilai sifat sentiasa mencerminkan data terkini daripada aplikasi anda.

Menapis dalam Peti Masuk#

Tapis perbualan mengikut nilai sifat menggunakan bar penapis Peti Masuk atau Paparan yang disimpan. Tambah syarat Property, pilih sifat mengikut nama — pemilih menyenaraikan setiap takrifan merentas ejen anda dan turut menerima kunci mentah yang tiada takrifan — kemudian pilih nilai. Medan nilai mencadangkan nilai yang pernah dilihat dan sebarang nilai enum sambil anda menaip.

Melalui API, endpoint senarai perbualan menerima parameter pertanyaan cp.<key>=<value> (alias tepat bagi attr.<key>). Tiada sintaks pertanyaan teks bebas:

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

Menyunting Nilai#

Nilai sifat ditetapkan oleh aplikasi anda — melalui integrasi widget atau API — dan bersifat baca-sahaja dalam panel butiran perbualan. Panel itu berpaut ke profil kenalan, tempat operator boleh melihat dan menyunting atribut kenalan (Kenalan → kenalan → Atribut).

properties berbanding metadata

Ciri	properties	metadata
Skema	Ditakrifkan dalam Tetapan Ejen berserta jenis	Pasangan kunci-nilai bentuk bebas
Boleh ditapis	Ya, melalui bar penapis / Paparan tersimpan (API: parameter `cp.<key>`)	Tidak
Boleh disunting kakitangan	Tidak — nilai datang daripada aplikasi anda; atribut kenalan disunting pada profil kenalan	Tidak
Paparan mengikut jenis	Ya (lencana, pautan, tarikh, boolean)	Teks biasa sahaja
Autolengkap	Ya, cadangan nilai dalam medan nilai penapis	Tidak

Gunakan metadata untuk medan sementara yang tidak perlu ditapis atau dipaparkan mengikut jenis. Gunakan properties untuk data berstruktur yang akan digunakan secara aktif oleh pasukan anda bagi segmentasi dan aliran kerja.