Proje: Okul B2B App · Hub: Okul B2B App — Domain

Leads (Başvuru) Yönetimi

Okul.com.tr platformunda potansiyel veliler okullara başvurur. Bu başvurular “lead” olarak adlandırılır ve B2B uygulamasının temel iş objesidir.

Lead Nedir?

Bir veli, okul.com.tr üzerinden bir okula ilgi bildirdiğinde veya iletişim formunu doldurduğunda bir lead oluşur. Okul yönetici/personeli bu leadi görüp takip eder.

Lead Alanları (API → App)

API Alan	App Alan	Açıklama
name	contactName	Veli adı-soyadı
phone	parentPhone	Veli telefonu
student_name	studentName	Öğrenci adı
date_of_birth	birthDate	Öğrenci doğum tarihi
student_class	studentClass	Okul/Sınıf bilgisi
school.name	schoolName	Okul adı
interaction_status.text	statusText	Görüntülenebilir durum
interaction_status.type	status	UI durum kodu
is_locked	isRestricted	Kilitli lead (görüntüleme kısıtlı)
school_answered_lead_status	okulcomControl	Okul.com.tr kontrolü
agent_user.name	schoolAuthority	Sorumlu personel
message	message	Veli mesajı
message_visible_status	message_visible_status	Mesaj görünürlüğü
customer_viewed_at	viewed_at	Son görüntülenme tarihi

Durum Tipleri

interaction_status.type üzerinden gelen UI durum kodları:

• new → Yeni başvuru
• contacted → İletişime geçildi
• interested → İlgili
• not_interested → İlgisiz
• registered → Kayıt yaptırdı
• lost → Kaybedildi

API Endpoint

GET /customer/leads
  ?page={n}
  &per-page={size}             (default: 20, PAGINATION_CONFIG'den)
  &filter[school_id]={id}     (okul filtresi, opsiyonel)
  &include=school,stage,schoolAnsweredLeadStatus

x-cid header’ında firma ID’si otomatik gönderilir (ApiClient tarafından).

Sayfalama

LeadsService.getLeads(page, pageSize, schoolId, bypassCache) döner:

{
  leads: Lead[],
  currentPage: number,
  totalPages: number,
  totalCount: number,
  hasNextPage: boolean
}

Ana sayfa için getRecentLeads() → ilk 5 lead (sayfa 1, pageSize 5).

Lead Detayı

getLeadDetailById(id) lead’i LeadDetail formatına dönüştürür (NotesService ile notlar ayrı yüklenir).

Kilitli Lead (is_locked)

Bazı leadler is_locked: true olabilir. Bu durumda veli telefon numarası gizlenir ve belirli aksiyonlar kısıtlanır. Paket/abonelik gerektiren özellik.

Related

• firma-okul-hiyerarsisi — Lead’in hangi firmaya/okula ait olduğu
• lead-durum-akisi — Lead durumları ve geçişleri