# Ö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

| 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](#ai) |

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ı {#ai}

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ı](/guides/workflows#ai) 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](/guides/salesforce-migration) 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](/guides/views-and-lists)
- **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](/guides/import) 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):

```json
"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:

```json
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.