# E-posta yazışmaları

> Kullanıcıların bağlı posta kutularından eşitlenen yazışmalar ve kayıtlara bağlanışları.

Kullanıcılar Gmail / Google Workspace, Microsoft 365 ya da şirket postası (IMAP/SMTP) hesaplarını bağladığında e-postaları CRM'e eşitlenir. Aynı konudaki iletiler **yazışma** (`thread`) olarak gruplanır; yazışma bir firmaya ve isteğe bağlı olarak bir projeye bağlanır ve ilgili kayıtların kartlarında E-postalar bölümünde görünür.

## Bağlanma kuralları

1. Karşı tarafın e-posta adresi bir kişininkiyle eşleşirse o kişinin firmasına bağlanır; eşleşmezse alan adından firma bulunur ya da (kuruluş kuralına göre) aday firma ve kişi kendiliğinden açılır.
2. Proje, sırasıyla şu kaynaklardan seçilir: yanıt zinciri, CRM'den gönderilmiş ilk ileti, firmanın tek açık projesi, konudaki teklif / proje numarası, firmanın son projesi (öneri olarak). Seçimin nedeni `opp_how` alanındadır.
3. Kullanıcı yazışmayı başka bir projeye taşıyabilir, ziyaret / deneme / görev / teklif / talep / sözleşmeye bağlayabilir ya da öneriyi yok sayabilir ([Yazışmayı kayda bağla](/rest-api/email/threads-action)).

Bülten, bildirim ve otomatik yanıt gibi gürültü iletileri eşitlenmez; yönetici, **E-posta hesabı** sayfasındaki **Kuruluş e-posta kuralları** kartıyla belirli alan adlarını hiç almamayı ya da onlardan kişi açmamayı seçebilir.

## Gizlilik

Posta kutusu sahibi paylaşımı seçer: **tam** (ekip ileti içeriğini görür) ya da **yalnız üst bilgi** (ekip konu ve kişileri görür, içerik gizli). İçeriği görme izni olmayan kullanıcıya iletiler `body: null`, `hidden: true` ile gelir. Bu kural API ve MCP için de geçerlidir.

## Yazışma alanları

| Alan | Tür | Açıklama |
|---|---|---|
| `id` | integer | Yazışma kimliği. |
| `subject` | string | Konu. |
| `customer_id`, `customer` | integer, string | Bağlı firma. |
| `opp_id`, `opp`, `opp_how` | integer, string | Bağlı proje ve seçilme nedeni (`chain`, `compose`, `single`, `number`, `recent`, `manual`…). |
| `suggested` | boolean | Proje yalnız öneri (`recent`). |
| `n`, `last_at`, `last_dir` | integer, datetime, string | İleti sayısı, son ileti zamanı ve yönü (`in` gelen, `out` giden). |
| `waiting` | boolean | Son ileti gelen — yanıt bekliyor. |
| `peer` | string | Son yazışan dış kişi. |

Tekil uç ayrıca `messages`, `links`, `companies`, `suggestions`, `linkables`, `may_edit` ve yanıt için hazır `reply` (alıcı, `Re:` konusu, `in_reply_to`) döndürür.

## Gönderim

[E-posta gönder](/rest-api/email/send) ucu iletiyi kullanıcının **kendi hesabından** gönderir; ileti Gönderilenler klasörüne de düşer ve yazışmaya bağlanır. Toplu gönderim ve e-posta dizileri yalnız web arayüzündedir (E-posta Otomasyonu modülü).