Standart nesneler

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).

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.

Kategoriler

Her yazışma kendiliğinden bir kategoriye ayrılır (v50): Müşteri yazışması · Teklif / fiyat · Sipariş ve sevkiyat · Destek / şikâyet · Fatura ve ödeme · Bülten / bildirim · Diğer.

  • Nasıl seçilir: konuda geçen anahtar kelime güçlü, metinde geçen zayıf sayılır (metinde en az iki farklı kelime gerekir; imza, alıntı ve e-posta adresleri sayılmaz). Teklife, siparişe ya da destek talebine bağlı yazışma ilgili kategoriye gider; toplu gönderenden (noreply…) gelen bülten kelimeli ileti Bülten / bildirim olur. Hiçbirine uymayan firma yazışması Müşteri yazışması, firmasız yazışma Diğer.
  • Yapay zekâ: Yapay Zekâ modülü açıksa yazışmalar önce anahtar kelimelerle hemen, birkaç dakika içinde de yapay zekâyla sınıflanır (son 120 gün, günde en çok 300 yazışma; yalnız konu ve kısa metin gider, adres ve telefon gitmez). Yanıt alınamazsa anahtar kelime sonucu kalır.
  • Elle değiştirme: E-postalar listesinde, yazışma sayfasının başlığında ya da fırsatın E-postalar sekmesinde kategori çipine tıklayın — menüden başka kategori ya da Otomatik sınıflandır; değişiklikte Geri al. Elle seçilen kategori yeni ileti gelse de değişmez. Yazışmanın sahibi, firmanın sorumlusu ya da yönetici değiştirir.
  • Süzmek: E-postalar sayfasında aramanın altındaki kategori şeridi — tıklayınca o kategorinin yazışmaları (sayaçlı).
  • Ayarlar → E-posta kategorileri (yönetici): kategorilerin adı, rengi, anahtar kelimeleri, sırası (eşit puanda üstteki seçilir), aç / kapa; yeni kategori ekleme, Yeniden sınıflandır, Varsayılana dön, Yapay zekâ ile sınıflandır anahtarı. Müşteri yazışması ve Diğer silinmez.

Projeler

  • E-postalar → Projeler sekmesi projeye (fırsata) bağlı yazışmaları proje proje gösterir: firma, proje ve aşaması, yazışma sayısı, yanıt bekleyenler ve son yazışmalar. Proje adı fırsat sayfasının E-postalar sekmesini açar. Müşteri takibi kabındaki ve firma düzeyindeki yazışmalar Yazışmalar sekmesindedir.
  • Fırsat sayfası → E-postalar sekmesi (Genel bakış yanında) projenin tüm yazışmalarını tam genişlikte listeler: kategori, son iletiden kısa metin, kişi, tarih; Tümü · Yanıt bekleyen ve kategori süzgeci, arama, E-posta yaz.

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.
category, category_label, category_color, category_source string Kategori (v50): anahtar, ad, renk, kaynak (rule anahtar kelime · ai yapay zekâ · user elle). Değiştirmek: Yazışmanın kategorisi; süzmek: listede ?category=.

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 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ü).