Özel alanlar

Firma, kişi ve fırsatlara kendi alanlarınızı ekleyin — kartta, tablolarda, listelerde, raporlarda, iş akışlarında, Excel'de, REST API'de ve Claude bağlantısında kullanılır.

Standart alanlar yetmediğinde (segment, bayi mi, kredi limiti, sözleşme bitişi, rakip…) yönetici Ayarlar → Özel alanlar'dan firma, kişi ve fırsat için alan ekler. Nesne başına en çok 80 alan açılabilir.

Türler

Her alanın kalıcı bir anahtarı vardır (key, addan üretilir: Çalışan sayısı → calisan_sayisi, Yapay zekâ özeti → yapay_zeka_ozeti). Ad sonradan değişebilir, anahtar değişmez. Kaldırılan alanın değerleri silinir.

Yapay zekâ alanları

Değerini kullanıcının değil yapay zekânın yazdığı alan. Örnekler: Satın alma sıcaklığı (Sıcak · Ilık · Soğuk), Hesap özeti, Sonraki en iyi adım.

• Doldurma: kartta alanın altındaki Doldur / Yenile; tablo görünümünde kayıtları seçip alt çubukta Yapay zekâ ile doldur… (istek başına en çok 200 kayıt, sırayla dolar).
• Kendiliğinden doldur işaretliyse boş kayıtlar zamanlayıcıyla (10 dakikada bir, her turda 20 kayıt) doldurulur; Her N günde bir yenile değeri eskiyen değerleri yeniler.
• Alan salt okunurdur: düzenleme formunda, içe aktarmada ve REST API'de yazılmaz. Okunur, tabloda süzülür ve sıralanır, iş akışı koşulunda kullanılır; sınıflandırma alanı raporda gruplama olarak da seçilir. İş akışının Alan güncelle eylemi yapay zekâ alanına yazamaz.
• Kartta değerin altında mod ve son dolum zamanı görünür.
• Yapay zekâ modülü lisansta olmalı ve kuruluşta açık olmalıdır (Ayarlar → Güvenlik). Yapay zekâya kaydın özeti gider (aşama, tutar, özel alanlar, firma bilgileri, kişilerin adı ve unvanı, son görüşmeler, notlar, e-posta konuları); kişilerin e-posta adresi ve telefonu gönderilmez. Her doldurma yapay zekâ kullanımına sayılır.

İş akışlarındaki yapay zekâ adımı da sonucu bir metin ya da seçim özel alanına yazabilir.

Nerede görünür?

• Firma ve fırsat kartı — Özel alanlar bölümü; Düzenle ile tümü tek formda. Sayılar Türkçe yazımla girilir (1.250 = bin iki yüz elli, 3,5).
• Kişi — firma kartında kişinin düzenleme formunda; değerler kişi satırında kısaca.
• Salesforce'tan taşıma Salesforce'taki alanları özel alan olarak açar (SF rozetiyle); aynı adlı var olan alana da yazabilir.
• Tablo görünümleri ve listeler — sütun olarak eklenir, süzgeçte ve sıralamada kullanılır, kanban seçim alanına göre gruplanabilir, toplu güncellenir. Müşteriler ve Fırsatlar sayfalarında da Özel alanlar düğmesiyle kişiye özel sütun, süzgeç ve sıralama. Tablo görünümleri ve listeler
• Excel — Müşteriler, Fırsatlar (firma alanlarıyla birlikte), tablo görünümü ve liste dışa aktarmalarında sütun; içe aktarmada başlık adıyla eşlenir.
• Rapor oluşturucu — seçim / onay / metin alanına göre gruplama ve süzgeç, sayı / para / yüzde alanının toplamı ve ortalaması; fırsat raporunda firmanın alanları da.
• İş akışları — koşullarda (fırsat ve firma alanları) ve Alan güncelle eyleminde.

REST API

Firma, kişi ve fırsat kartları custom_fields dizisi döndürür (alan tanımlıysa):

"custom_fields": [
  {"key": "segment", "label": "Segment", "type": "select", "value": "A Segmenti"},
  {"key": "calisan_sayisi", "label": "Çalışan sayısı", "type": "number", "value": 1250.0},
  {"key": "bayi", "label": "Bayi", "type": "check", "value": true}
]

Yazmak için gövdeye custom_fields nesnesi koyun — anahtar ya da ad kullanılabilir:

PATCH /api/v1/customers/42
{"custom_fields": {"segment": "B Segmenti", "Çalışan sayısı": 1300, "bayi": false}}

Kabul eden uçlar: POST /api/v1/customers, PATCH /api/v1/customers/{id}, POST /api/v1/customers/{id}/contacts, PATCH /api/v1/contacts/{id}, POST /api/v1/opportunities, POST /api/v1/opportunities/{id}/fields.

• Sayıları JSON sayısı olarak gönderin; metin olarak "3,45" ve "1.250,50" de çözülür.
• Boş metin ya da null değeri siler.
• Bilinmeyen alan ya da geçersiz değer kaydı engellemez; yanıtta custom_field_errors listesi döner (ör. "bilinmeyen özel alan: yok_boyle", "Segment: geçerli seçenek değil").

MCP (Claude)

create_company, update_company, create_contact ve create_opportunity araçlarında custom_fields parametresi vardır; açıklamasında kurulumdaki alanlar türleri ve seçenekleriyle listelenir, böylece Claude doğru anahtarı ve değeri kullanır. Okuma araçları (get_company, get_opportunity) değerleri döndürür.