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) |
Widget’tan İletme
Ö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.
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
}
});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=enterpriseDeğ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 |
metadata kullanın. Ekibinizin segmentasyon ve iş akışı için aktif olarak kullanacağı yapılandırılmış veriler için properties kullanın.