Skip to main content
Tüm isteklerde X-Tenant header’ı zorunludur. İşlemler yalnızca belirtilen tenant’a ait lead kayıtları ile sınırlandırılmıştır.

​
Endpoint özeti

​
Lead statüleri

​
Lead CRUD

Tüm parametreler, alanlar ve örnek istek/yanıtlar için API Referansı sekmesine bakın.

​
Lead kavramı

Lead, kliniğe ilgi gösteren ancak henüz hasta kaydı oluşturulmamış potansiyel müşteriyi temsil eder. Bir lead; iletişim bilgileri, kaynak, atanmış kullanıcı, statü ve dönüşüm durumu ile yönetilir. Lead statüleri tenant bazında özelleştirilebilir. Her statü; renk, sıralama, varsayılan (is_default) ve terminal (is_terminal) işaretleri ile yapılandırılabilir.

​
İş kuralları

phone_number normalizasyonu: Girilen telefon numarası sistem tarafından otomatik olarak normalize edilir. Tenant içinde benzersiz olmalıdır.
Statü benzersizliği: POST /leads/statuses ile oluşturulan statü adı (name) tenant içinde benzersiz olmalıdır.
is_terminal: Terminal olarak işaretlenen statüler lead akışının son adımını temsil eder (örn. “Kaybedildi”, “Dönüştürüldü”).

​
Lead → Müşteri dönüşümü (POST /leads/{id}/convert)

existing_customer_id gönderilirse lead mevcut bir müşteriyle ilişkilendirilir; gönderilmezse sistem otomatik olarak yeni bir müşteri kaydı oluşturur.
Yanıt { result, customer, lead } yapısında döner.

​
Yetkilendirme

​
Uygulama izinleri (permissions)

​
Token scope’ları (Passport)