Skip to main content
Panelde gördüğünüz ad ile API’deki kaynak adı her zaman aynı değildir. Örneğin panelde Hasta olan kayıt API’de customer, Sohbet ise conversation adını taşır. Bu sayfa, iki taraf arasında çeviri yapmanız gereken durumlar için hazırlanmıştır.

​
Nasıl kullanılır

  • Panelde bir ekranı biliyorsanız ve API karşılığını arıyorsanız Kaynak adları tablosuna bakın.
  • Bir alanda pending, cancelled gibi bir değer görüyorsanız Durum değerleri bölümünde panel etiketini bulun.
  • İki terimi birbirine karıştırıyorsanız Sık karıştırılan terimler bölümüne geçin.
Tablolardaki yollar https://app.flextell.ai/api/v1 adresine eklenir. Her istekte Authorization ve X-Tenant başlıkları gerekir. Ayrıntı için Klinikler ve X-Tenant sayfasına bakın.

​
Kaynak adları

Panel etiketleri, kenar çubuğundaki menü adlarıyla birebir aynıdır.

​
Hasta ve randevu

​
Lead ve satış hattı

​
Sohbet ve bildirim

​
Finans

​
Klinik ve sistem

Her kaynağın ayrıntısı Kaynaklar grubundaki sayfalardadır. Örneğin Hastalar, Randevular ve Sohbetler.

​
Durum değerleri

API her zaman İngilizce makine değerini döndürür. Panel bu değerin Türkçe etiketini gösterir. Filtrelerde ve yazma isteklerinde makine değerini kullanın.

​
Randevu (status)

​
Satış (status)

​
Teklif (status)

​
Fatura (status)

​
Kanal (status)

status kanalın sağlayıcıyla bağlantı durumudur. is_active ise kanalı sizin açıp kapattığınız anahtardır. İkisi birbirinden bağımsızdır.

​
Destek Talebi ve Sorun Bildirimi (status)

​
Randevu hatırlatması

​
AI yanıt modu (ai_reply_windows[].mode)

​
Rol adları

API, rolün adını name alanında anahtar olarak döndürür. Yeni bir kliniğe şu yedi sistem rolü kurulur. Sistem rollerinin adı değiştirilemez; kliniğinizin kendi oluşturduğu roller ise kendi adını taşır.
doctor, assistant ve accountant rollerine kurulumda hiçbir izin verilmez. Neyi görebileceklerini kliniğiniz Sistem Ayarları → Roller ekranından belirler. Ayrıntı için İzinler ve görünürlük sayfasına bakın.

​
Sık karıştırılan terimler

Panelde ve belgelerde her zaman Hasta denir. API ise customer adını kullanır: /customers, customer_id. İkisi aynı kayıttır.
Lead henüz hastaya dönüşmemiş kişidir ve /leads altında yönetilir. Dönüştürülene kadar /customers listelerinde görünmez. Dönüştürme POST /leads/{id}/convert ile yapılır. Panelde buna Hastaya Dönüştür denir.
Pipeline aşamaların sıralı listesidir. Aşama (stage) lead’in o anda bulunduğu adımdır. Lead’in ayrı bir “durum” alanı yoktur. Kazanıldı ve Kaybedildi, sabit aşamalardır.
İkisi aynı şeydir. Panelde Klinik, API’de tenant denir. Hangi kliniğin verisine eriştiğinizi X-Tenant başlığı belirler. Bazı eski mesajlarda “firma” ifadesi geçebilir.
scope, bir OAuth uygulamasına verdiğiniz erişimdir, örneğin customers:read. İzin, kullanıcının rolünden gelir, örneğin View:Customer. Bir istek için ikisi de gerekir. Bkz. Scope’lar.
Destek Talebi (/tickets) hastanın kliniğe ilettiği talebi anlatır. Sorun Bildirimi (/panel-tickets) ise klinik personelinin Flextell ekibine ilettiği bildirimdir. Aynı durum değerlerini paylaşırlar ama ayrı kaynaklardır.
Teklif (/offers) hastaya sunulan fiyat teklifidir ve satışa dönüştürülebilir. Proforma ise Flextell aboneliğinizin faturasıdır ve /billing/proforma-invoices altındadır. Birbiriyle ilgisi yoktur.
Faturalar (/invoices) kliniğin hastaya kestiği e-SMM belgeleridir. Faturalarım (/billing) Flextell’e ödediğiniz abonelik ve kota ödemeleridir.
Kredi (/credits), kliniğinizin satın aldığı ek paketlerden gelen Flextell kullanım bakiyesidir (örneğin mesaj, depolama, AI kullanımı). Kontör ise fatura entegratörünüzün belge başına düştüğü kotadır. Flextell yalnızca kalan kontörü okur, saymaz.
/account oturum açan kullanıcının kendi profilidir: şifre, iki adımlı doğrulama, bildirim tercihleri, klinik listesi. Hesaplar menüsü ise kasa ve banka hesaplarıdır ve /bank-accounts altındadır.
Satış hastaya yapılan, fiyatı olan kayıttır. Tahsilat o satış için alınan ödemedir. Hasta tarafında alacak olarak Satış, ödeme olarak Tahsilat işlemi oluşur.
Belgelerde Sohbet denir. API alan ve yol adları conversation olarak kalır. Bir sohbetin içindeki her ileti message kaynağıdır.
Bazı etiketler ekrana göre değişir. Faturada iptal durumu panelde İptal, API metinlerinde İptal Edildi yazar. Teklifte converted panelde Satışa Dönüştü görünür. Duyuru önem derecesi low, medium, high değerleri panelde Düşük, Orta, Yüksek olarak, mobil uygulamada ise Bilgi, Önemli, Kritik olarak gösterilir. Kodunuzda her zaman makine değerine göre karar verin, etikete göre değil.