Standart nesneler

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 exists döner ve mevcut firma customer alanında gelir.
  • Benzer adlar varsa 409 similar döner ve adaylar similar listesinde gelir. Doğru firmayı seçin ya da yine de açmak için confirm_new: true gö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.

İlgili uçlar