Kişi Özellikleri

Kişiler için özel alanlar tanımlayın — hesap türü, bölge veya sözleşme kademesi gibi — ve bunları widget aracılığıyla iletin. Özellikler kişinin profilinde gösterilir, temsilciler tarafından düzenlenebilir ve Gelen Kutusu’nda filtrelenebilir.

Genel Bakış#

Kişi Özellikleri, yerleşik alanların (email, name, userId) ötesinde konuşmalara yapılandırılmış veri eklemenizi sağlar. Serbest biçimli metadata alanının aksine, özelliklerin türleri, etiketleri ve doğrulaması olan tanımlı bir şeması vardır — HubSpot veya Salesforce’taki özel alanlara benzer şekilde.

Şema Tanımlayın

Ajan Ayarları’nda string, number, enum, boolean, date, url gibi türlerle özellik tanımları oluşturun

Widget’tan İletin

Özellik değerlerini Respondo.identify() ile gönderin — otomatik olarak saklanır ve gösterilir

Filtreleyin ve Düzenleyin

Gelen Kutusu’nda konuşmaları özellik değerlerine göre filtreleyin. Temsilciler, kişinin niteliklerini kişi profilinde görüntüleyip düzenleyebilir.

Özelliklerin Tanımlanması#

Özellikler her ajan için ayrı ayrı Ajan Ayarları → Kişi Özellikleribölümünde tanımlanır. Her özelliğin şunları vardır:

Alan	Açıklama
key	Kodda kullanılan benzersiz tanımlayıcı. Etiketten otomatik oluşturulur (düzenlenebilir). Küçük harfler, rakamlar ve alt çizgi; bir harfle başlamalı; 2-63 karakter. Sistem anahtarları (`user_id`, `visitor_id`, `timezone`, `page_url`, …) ayrılmıştır. Örnek: `account_type`
label	Panoda gösterilen, insan tarafından okunabilir ad. Örnek: "Account Type"
type	Değer türü: `string`, `number`, `boolean`, `enum`, `date`, `url`
enum_values	`enum` türü için — izin verilen değerlerin listesi. Örnek: `["starter", "pro", "enterprise"]`
is_filterable	İleride filtre denetimi için ayrılmıştır; tanımla birlikte saklanır, ancak Gelen Kutusu filtre seçicisi şu anda tanımlı tüm özellikleri listeler (varsayılan: true)
is_visible	İleride görünüm denetimi için ayrılmıştır; tanımla birlikte saklanır ancak henüz arayüzde uygulanmaz (varsayılan: true)

Her ajan için en fazla 50 özellik. Özellikler ayarlar arayüzünde sürükle-bırak ile yeniden sıralanabilir.

Özellik değerlerini Respondo.identify() çağrısının properties alanında iletin. Anahtarlar, Ajan Ayarları’ndaki özellik tanımlarıyla eşleşmelidir.

Widget entegrasyonujavascript

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

Tüm özellik değerleri dize olarak iletilir. Türe özgü gösterimi pano işler (örneğin boolean → Evet/Hayır, url → tıklanabilir bağlantı, enum → rozet).

Entegrasyon Kod Parçacığı#

Entegrasyon Parçacığı, en az bir özellik tanımladığınızda Ajan Ayarları → Kişi Özellikleri altında tüm özellik anahtarlarınız önceden doldurulmuş olarak otomatik görünür. Kopyala’ya tıklayıp uygulamanıza yapıştırın. Oluşturulan parçacık, kimlik doğrulama (HMAC-SHA256) için bir userHash yer tutucusu da içerir.

Değerler Nasıl Saklanır#

Özellik değerleri, konuşmanın metadata JSONB alanında cp_ öneki ile saklanır. Örneğin, anahtarı account_type olan bir özellik cp_account_type olarak saklanır.

Özellikler her mesajda güncellenir — widget yeni değerler gönderirse, mevcut olanların üzerine yazar. Bu, özellik değerlerinin her zaman uygulamanızdaki en güncel veriyi yansıttığı anlamına gelir.

Gelen Kutusu’nda Filtreleme#

Konuşmaları özellik değerlerine göre Gelen Kutusu filtre çubuğuyla veya kayıtlı bir Görünümle filtreleyin. Bir Özellik koşulu ekleyin, özelliği adıyla seçin — seçici, tüm ajanlarınızdaki her tanımı listeler ve tanımı olmayan ham bir anahtarı da kabul eder — sonra bir değer seçin. Değer alanı, siz yazdıkça gözlemlenen değerleri ve varsa enum değerlerini önerir.

API üzerinden, konuşma listeleme uç noktaları bir cp.<key>=<value> sorgu parametresi kabul eder (attr.<key>’in birebir takma adı). Serbest metin sorgu söz dizimi yoktur:

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

Değerleri Düzenleme#

Özellik değerlerini uygulamanız ayarlar — widget entegrasyonu veya API aracılığıyla — ve konuşma ayrıntıları panelinde salt okunurdurlar. Panel, kişinin profiline bağlantı verir; temsilciler kişinin niteliklerini orada görüntüleyip düzenleyebilir (Kişiler → kişi → Nitelikler).

Properties ve Metadata Karşılaştırması

Özellik	properties	metadata
Şema	Ajan Ayarları’nda türlerle tanımlanır	Serbest biçimli anahtar-değer çiftleri
Filtrelenebilir	Evet, filtre çubuğu / kayıtlı Görünümler ile (API: `cp.<key>` parametresi)	Hayır
Temsilciler tarafından düzenlenebilir	Hayır — değerler uygulamanızdan gelir; kişi nitelikleri kişi profilinde düzenlenir	Hayır
Türe özgü gösterim	Evet (rozetler, bağlantılar, tarihler, boolean değerler)	Yalnızca düz metin
Otomatik tamamlama	Evet, filtre değer alanında değer önerileri	Hayır

Filtreleme veya türe özgü gösterim gerektirmeyen anlık alanlar için metadata kullanın. Ekibinizin segmentasyon ve iş akışı için aktif olarak kullanacağı yapılandırılmış veriler için properties kullanın.