# Kişiler

> Firmalardaki muhataplar — görüşmeler, e-postalar ve teklifler kişilere bağlanır.

Kişi (API'de `contact`) her zaman bir firmaya aittir. Bir firmanın bir **ana kişisi** olur: firma listesinde ve mobil uygulamadaki arama / WhatsApp düğmelerinde o görünür. Firmanın ilk kişisi kendiliğinden ana kişi olur.

## Alanlar

| Alan | Tür | Açıklama |
|---|---|---|
| `id` | integer | Kimlik. |
| `rid` | string | Kalıcı kayıt kimliği (`003…`). |
| `customer_id`, `customer` | integer, string | Bağlı olduğu firma. |
| `name` | string | Ad soyad. |
| `title`, `department` | string | Unvan ve departman. |
| `phone`, `email` | string | İletişim. |
| `wa` | string | Telefonun yalnız rakamları — `https://wa.me/<wa>` bağlantısı için. |
| `is_main` | boolean | Firmanın ana kişisi. |
| `is_former` | boolean | Firmadan ayrıldı. Ayrılan kişiler silinmez; listelerde gizlenir, geçmiş görüşmelerde adı kalır. |
| `note` | string | Kısa not (250 karakter). |

## Kişiler nasıl oluşur?

- [Kişi ekle](/rest-api/people/create) ucu ya da firma kartı.
- [Firma oluştururken](/rest-api/companies/create) `contact_*` alanları.
- [Görüşme kaydederken](/rest-api/activities/log) firmada olmayan bir ad yazıldığında.
- E-posta eşitlemesi: firmanın alan adından gelen e-postaların göndericileri (otomatik kişiler `auto` olarak işaretlenir ve uygulamalara `contact_created` olayı göndermez).
- Form başvuruları, Segment `identify` olayları ve veri eşitleme kancası.

## E-posta ile eşleşme

Gelen e-postalar ve kancalar kişiyi önce **e-posta adresiyle**, bulamazsa firma + adla eşler. Aynı e-posta adresini iki firmada kullanmaktan kaçının; eşleşme ilk bulunan kişiye yapılır.

## İlgili uçlar

:::cards
- [Kişileri listele](/rest-api/people/list) list | Tüm firmaların kişileri, aramayla.
- [Kişi ekle](/rest-api/people/create) plus | Firmaya kişi ekle.
- [Kişiyi güncelle](/rest-api/people/update) pencil | Ana kişi yap, ayrıldı işaretle.
:::