Firmalar
Müşteri ve aday firmalar — CRM'deki her kaydın bağlandığı ana nesne.
Firma (API'de customer) CRM'in merkezidir. Kişiler, fırsatlar, ziyaretler, denemeler, teklifler, siparişler, sözleşmeler, destek talepleri ve e-posta yazışmaları bir firmaya bağlanır. Firma kartı bunların hepsini tek sayfada gösterir; API'de GET /api/v1/customers/{id} aynı içeriği döndürür.
Durum
| Değer | Anlamı |
|---|---|
Prospect |
Aday — henüz satış yapılmamış firma. Yeni firmaların varsayılanı. |
AC |
Aktif müşteri. Bir fırsat kazanıldığında firma kendiliğinden AC olur. |
Firmalar silinmez, pasife alınır (active: false): pasif firmalar listelerden ve hatırlatıcılardan çıkar, geçmişi korunur. API'de silme ucu yoktur; pasif firmaları GET /api/v1/customers?active=0 listeler. Ayrıntı: Pasifleştirme ve silme.
Alanlar
Liste uçları her firma için satır biçimini, tekil uç kart biçimini döndürür. Kart, satırdaki her alanı da içerir.
| Alan | Tür | Açıklama |
|---|---|---|
id |
integer | Kurulum içindeki kimlik. |
rid |
string | 15 karakterlik kalıcı kayıt kimliği (001…). Kayıt kimlikleri. |
name |
string | Firma adı (en çok 200 karakter). |
status, status_label |
string | AC / Prospect ve görünen adı. |
owner |
user | Sorumlu satışçı (id, full_name, role). |
city, sector, phone |
string | İletişim bilgileri. |
main_contact |
object | Ana kişinin adı, telefonu, e-postası ve WhatsApp numarası (wa). |
visit_state |
string | Ziyaret takvimi: overdue gecikti, soon yaklaşıyor, ok, none takvim yok. |
last_visit, next_visit_due |
date | Son ziyaret ve sıradaki ziyaret günü. |
open_opps |
integer | Açık fırsat sayısı. |
at_risk |
boolean | Müşteri risk altında (uzun süredir ziyaret ya da sipariş yok). |
potential_kg, unit |
number, string | Aylık potansiyel ve kurulumun ana birimi. v60'tan beri grup satırları varsa varsayılan birimdeki satırların toplamı. Birim ve döviz. |
currency |
string | Firmanın işlem dövizi. |
pending_state |
string | En acil açık aksiyonun durumu. |
Kartta ayrıca: address, website, note, supplier_note (mevcut tedarikçi), barrier (engel), mgmt_support, visit_period_days, pay alanları (share_start, share_current, share_target), miktar hedefleri (our_kg_current, our_kg_target, commit_kg), contacts, opps, visits, demos, offers, orders, open_actions, events (zaman tüneli), competitors, prices, threads, categories (liste) + categories_source (auto · ai · user), connection (strength 0–5, label, strongest_user_id, last_interaction, last_kind, next_interaction, next_kind, first_interaction, computed_at), tax_no · tax_office (vergi no / dairesi), potentials (v60: ürün grubu başına potansiyel — grp, potential, ours, share, share_target, gap, supplier; bkz. Firma potansiyeli) + pot (on, title), finance (ERP bağlıysa: balance, overdue, credit_limit, risk_pct, open_invoices, open_amount, overdue_invoices, revenue_12m, avg_terms_days, last_invoice, accounts — Muhasebe ve ERP; faturalar Firmanın finansı) ve can_edit gelir.
Logo, kategoriler ve bağlantı gücü
Firma kartının başlığında ve her listede (Firmalar tablosu, Aksiyonlar, E-postalar, Notlar, Pipeline, Dashboard, Bugün) firmanın logosu görünür. Logo firmanın kendi web sitesinden kendiliğinden gelir: önce web sitesi alanı, yoksa e-postadan açılan firmanın alan adı, o da yoksa kişilerin kurumsal e-posta alan adı kullanılır (Gmail gibi genel adresler sayılmaz). Sitede sırasıyla apple-touch-icon, büyük site simgesi ve /favicon.ico aranır; bulunan görsel kurulumda saklanır, 60 günde bir yenilenir. Logo bulunamazsa firmanın baş harfi renkli bir kare içinde gösterilir. Firma kartında logoyu yenile hemen yeniden arar.
Kişiler baş harfleriyle, fırsatlar aşama halkasıyla görünür: halka fırsatın aşama rengindedir ve kaçıncı aşamada olduğu kadar dolar (kazanılan yeşil ✓, kaybedilen gri ×).
Firma kartındaki etkileşim şeridi (Attio'daki gibi):
| Alan | Nasıl hesaplanır |
|---|---|
| Bağlantı gücü | Son 365 gündeki e-postalar, toplantılar, ziyaretler (yüz yüze en ağır), denemeler ve görüşme kayıtları; her temas tazeliğine göre ağırlıklanır (45 günde yarıya iner) ve aynı gün aynı firmayla en çok 3 e-posta sayılır. Sonuç beş seviye: Çok zayıf · Zayıf · İyi · Güçlü · Çok güçlü (hiç temas yoksa Yok). Elle değiştirilmez. |
| En güçlü bağ | Bu temasların en çoğu ve en yenisi kimde — ekipten bir kişi. |
| Son etkileşim | En son e-posta, toplantı, ziyaret ya da deneme: ne zaman, türü, kim. |
| Sonraki etkileşim | En yakın planlı toplantı ya da arama / toplantı / ziyaret / e-posta türündeki açık görev (120 gün içinde; iptal edilen toplantı sayılmaz). |
| İlk etkileşim | Firmayla ilk e-posta, toplantı, ziyaret ya da deneme. |
Değerler üç saatte bir yeniden hesaplanır; firma kartı açılınca o firma hemen güncellenir.
Kategoriler
Kategoriler (Kimya, Plastik ve Ambalaj, Metal ve Çelik, Lojistik ve Taşımacılık… — 32 sektör) firmanın adından, alan adından, Sektör alanından ve web sitesinin başlık / açıklamasından kendiliğinden belirlenir; otomatik etiketiyle görünür. Kalemle elle seçin ya da kendi etiketinizi yazın — elle girilen kategoriler bir daha otomatik değiştirilmez (Otomatiğe dön ile geri alınır). Yapay zekâ açıksa Yapay zekâ ile yalnız bu listeden 1–3 kategori seçer (yapay zekâya firma adı, alan adı, sektör ve site açıklaması gider).
Firmalar tablosunda Kategoriler, Bağlantı gücü, En güçlü bağ, Son etkileşim, Sonraki etkileşim ve İlk etkileşim sütun olarak seçilir, süzülür, sıralanır ve Excel'e aktarılır. Tablo görünümleri
Mükerrer koruması
Firma açarken ad, mevcut firmalarla karşılaştırılır:
- Aynı ad (büyük-küçük harf, şirket türü ekleri ve noktalama yok sayılarak) varsa
409 existsdöner ve mevcut firmacustomeralanında gelir. - Benzer adlar varsa
409 similardöner ve adaylarsimilarlistesinde gelir. Doğru firmayı seçin ya da yine de açmak içinconfirm_new: truegönderin.
Bu kural firma oluştur, görüşme kaydet ve gelen kancalarda (form, veri eşitleme) aynıdır.
Otomatik açılan firmalar
E-posta eşitlemesi, form başvuruları, Segment ve veri eşitleme kancaları yeni firma açabilir. E-postadan açılan firmalar alan adından tanınır (auto_domain) ve firma kartında "otomatik açıldı" bandıyla görünür; kullanıcı yanlışsa tek tıkla geri alır.