Temel kavramlar

Ö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, fırsat ve destek talebi için alan ekler. Nesne başına en çok 80 alan açılabilir. Destek talebi alanları talep kartında Ek bilgiler olarak görünür ve destek formunda blok olur.

Türler

Tür API'deki type Değer
Metin text metin (1.000 karakter)
Uzun metin long çok satırlı metin
Sayı · Para · Yüzde number · currency · percent sayı (para alanında döviz tanımda)
Tarih date YYYY-MM-DD
Seçim select seçeneklerden biri
Çoklu seçim multi seçenek listesi
Onay kutusu check true / false
Bağlantı · E-posta · Telefon url · email · phone metin (bağlantıya https:// eklenir, e-posta doğrulanır)
Yapay zekâ ai yapay zekânın yazdığı metin ya da seçenek — aşağıda

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.

Alanları düzenlemek

Ayarlar → Özel alanlar (yönetici) nesne sekmeleriyle açılır: Firmalar · Kişiler · Fırsatlar · Destek talepleri. Listede her alanın türü, anahtarı, ilk seçenekleri ve kaç kayıtta dolu olduğu görünür; üstteki arama ad, anahtar, tür ve seçeneklerde arar.

  • Bir alana tıklayın: sağda düzenleyici açılır — ad, tür (açıklamalı tür ızgarası), seçenekler, döviz, yapay zekâ ayarları, açıklama, Kartlarda göster ve canlı önizleme (alanın kayıt kartında nasıl görüneceği). Altta kullanım: değer girilmiş kayıt sayısı ve alanı kullanan kayıtlı görünüm, rapor ve iş akışı sayısı.
  • Seçenekler sürükleyerek sıralanır; çok satırlı metin yapıştırınca her satır bir seçenek olur. Bir seçeneği yeniden adlandırırsanız kayıtlardaki değerler de yeni adla güncellenir; her seçeneğin yanında kaç kayıtta kullanıldığı yazar.
  • Tür değiştirmek: değeri olmayan alanda her türe; değeri olan alanda yalnız uyumlu türe — metin ↔ uzun metin, sayı ↔ para ↔ yüzde, bağlantı / e-posta / telefon → metin, seçim → çoklu seçim (değerler korunur).
  • Sıralama: tutamaçtan sürükleyin (dokunmatikte de) ya da klavyede ↑ ↓; sıra kayıt kartındaki sırayı belirler. Tosttaki Geri al eski sırayı geri getirir.
  • Gizlemek: göz simgesi alanı kartlardan kaldırır, değerleri silinmez. Silmek alanı ve tüm değerlerini kalıcı olarak kaldırır (onay sorulur).
  • Hızlı ekleme: listenin altına adı yazıp türü seçin, Enter; seçim, çoklu seçim, para ve yapay zekâ türlerinde seçenekler için düzenleyici açılır.

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.

Mod Ne yazar
Özet Kaydın son durumunu birkaç cümleyle
Sınıflandırma Tanımda verdiğiniz seçeneklerden birini (en az iki seçenek)
Talimata göre metin Talimatınızın yanıtını ("Firmanın bizden aldığı ürünleri ve risklerini iki cümleyle yaz")
  • 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.