> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flextell.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Terimler sözlüğü

> API kaynak ve alan adlarının paneldeki Türkçe karşılıklarını ve sık karıştırılan terimleri listeler.

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ı](#kaynak-adları) tablosuna bakın.
* Bir alanda `pending`, `cancelled` gibi bir değer görüyorsanız [Durum değerleri](#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](#sık-karıştırılan-terimler) bölümüne geçin.

<Note>
  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](/api/klinikler-ve-x-tenant) sayfasına bakın.
</Note>

## Kaynak adları

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

### Hasta ve randevu

| Panelde | API yolu | Not |
| - | - | - |
| **Hastalar** | `/customers` | Alan adı `customer_id`. Lead aşamasındaki kişiler bu listede çıkmaz. |
| **Lead'ler** | `/leads` | Dönüştürülünce kayıt `/customers` altında görünür. |
| **Lead Kaynakları** | `/leads/reference-sources` | Lead'deki alan `reference_source`. |
| **Etiketler**, **Meslekler** | `/tags`, `/occupations` | |
| **Hasta Birleştirme** | `/customer-merges` | |
| **Randevular** | `/appointments` | Zaman alanı `scheduled_at`. |
| **Randevu Hatırlatmaları** | `/appointment-reminders` | **Seans Onayları** ve **İptal Takibi Hatırlatmaları** da bu kaynaktandır. |
| **Tatiller** | `/holidays` | |
| **Doldurulan Formlar** | `/customer-forms` | Şablonlar `/form-templates` altındadır. |

### Lead ve satış hattı

| Panelde | API yolu | Not |
| - | - | - |
| **Pipeline'lar** | `/pipelines` | |
| **Aşama** | `/pipelines/{id}/stages` | Lead'de `pipeline_stage_id` ve `stage` alanları. |
| **Satış Temsilcileri** | `/salespeople` | Satış temsilcisi `salesperson` rolündeki bir kullanıcıdır. |
| **Teklifler** | `/offers` | |

### Sohbet ve bildirim

| Panelde | API yolu | Not |
| - | - | - |
| **Sohbetler** | `/conversations` | Mesajlar `/conversations/{id}/messages` altındadır. |
| **Kanallar** | `/channels` | `type`: WhatsApp, Instagram, Website, Telegram. |
| **Hızlı Yanıtlar** | `/quick-replies` | |
| **Engellenen Kullanıcılar** | `/channel-blacklists` | `DELETE` engeli kaldırır. |
| **Mesaj Şablonları** | `/message-templates` | |
| **Destek Talepleri** | `/tickets` | Hastaların açtığı talepler. |
| **Sorun Bildirimlerim** | `/panel-tickets` | Sizin Flextell ekibine ilettiğiniz bildirimler. |
| Bildirim merkezi | `/notifications`, `/message-notifications`, `/announcements` | **Duyurular** için `X-Tenant` ve `View:Announcement` izni gerekir. |

### Finans

| Panelde | API yolu | Not |
| - | - | - |
| **Satışlar** | `/sales` | **Tahsilat** `/sales/{id}/payments` altındadır. |
| **Faturalar** | `/invoices` | Hastaya kesilen fatura. |
| **Bakiyeler** | `/customer-balances` | |
| **Hesaplar** | `/bank-accounts` | Kasa ve banka hesapları. |
| **Ürünler**, **Ürün Setleri** | `/products`, `/product-sets` | |
| **Kategoriler**, **Markalar** | `/product-categories`, `/product-brands` | |
| **Depolar**, **Stoklar** | `/warehouses`, `/stocks` | Hareketler `/stocks/movements` altındadır. |

### Klinik ve sistem

| Panelde | API yolu | Not |
| - | - | - |
| **Tedaviler** | `/treatments` | Tedavi grupları `/treatment-groups` altındadır. |
| **Doktorlar**, **Asistanlar**, **Odalar** | `/doctors`, `/assistants`, `/rooms` | |
| **AI Raporları**, **Rapor Planları** | `/ai-reports`, `/ai-report-schedules` | |
| **Agentlar** | `/agent-prompts` | |
| **Krediler**, **Kredi Kullanımları** | `/credits`, `/credit-usages` | |
| **Faturalarım** | `/billing/*` | Flextell aboneliğiniz. Bkz. [Abonelik ve faturalama](/api/kaynaklar/abonelik-ve-faturalama). |
| **Kullanıcılar**, **Roller** | `/users`, `/roles` | Davetler `/invitations` altındadır. |
| **Uygulamalar** | `/oauth/clients` | |
| **Aktivite Logları** | `/activity-logs` | |
| **Kullanıcı Girişleri** | `/authentication-logs` | |
| **Geri Dönüşüm Kutusu** | `/recycle-bin` | |
| **Veri İmha Talepleri** | `/data-erasure-requests` | |
| **Klinik Bilgileri** | `/tenant` | |

Her kaynağın ayrıntısı **Kaynaklar** grubundaki sayfalardadır. Örneğin [Hastalar](/api/kaynaklar/hastalar), [Randevular](/api/kaynaklar/randevular) ve [Sohbetler](/api/kaynaklar/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`)

| Değer | Panel etiketi |
| - | - |
| `pending` | Bekliyor |
| `approved` | Onaylandı |
| `cancelled` | İptal Edildi |
| `rejected` | Reddedildi |
| `completed` | Tamamlandı |
| `no_show` | Gelmedi |

### Satış (`status`)

| Değer | Panel etiketi |
| - | - |
| `draft` | Taslak |
| `pending` | Beklemede |
| `completed` | Tamamlandı |
| `invoiced` | Faturalandırıldı |
| `cancelled` | İptal Edildi |

### Teklif (`status`)

| Değer | Panel etiketi |
| - | - |
| `draft` | Taslak |
| `sent` | Gönderildi |
| `accepted` | Kabul Edildi |
| `rejected` | Reddedildi |
| `converted` | Satışa Dönüştü |

### Fatura (`status`)

| Değer | Panel etiketi |
| - | - |
| `draft` | Taslak |
| `waiting` | Bekliyor |
| `sent` | Gönderildi |
| `success` | Başarılı |
| `error` | Hata |
| `cancelled` | İptal |

### Kanal (`status`)

| Değer | Panel etiketi |
| - | - |
| `open` | Aktif |
| `waiting` | Bağlanıyor |
| `closed` | Kapalı |

`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`)

| Değer | Panel etiketi |
| - | - |
| `open` | Açık |
| `processing` | İşleniyor |
| `resolved` | Çözüldü |
| `closed` | Kapalı |

### Randevu hatırlatması

| Alan | Değer | Etiket |
| - | - | - |
| `status` | `queued` | Planlandı |
| `status` | `sent` | Gönderildi |
| `status` | `error` | Hatalı |
| `status` | `expired` | Süresi Geçti |
| `approval_status` | `pending` | Onay Bekliyor |
| `approval_status` | `approved` | Onaylandı |
| `approval_status` | `rejected` | Reddedildi |

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

| Değer | Panel etiketi |
| - | - |
| `auto` | Otomatik |
| `semi_auto` | Yarı Otomatik |
| `closed` | Kapalı |

## 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.

| Rol adı (`name`) | Türkçe karşılığı | Ne için kullanılır |
| - | - | - |
| `super_admin` | Süper Yönetici | Tüm izinlere açıkça sahiptir. |
| `doctor` | Doktor | Doktor kullanıcıları. `/doctors` listesi bu role dayanır. |
| `assistant` | Asistan | Asistan kullanıcıları. |
| `accountant` | Muhasebeci | Muhasebe kullanıcıları. |
| `coordinator` | Koordinatör | Lead yönetimi için hazır izin kümesiyle gelir. |
| `salesperson` | Satış Temsilcisi | Kendi lead'leriyle çalışır. Rol ve kullanıcı yönetimi izni verilmez. |
| `sales_director` | Satış Direktörü | Temsilcilerin kayıtlarını görür ve pipeline'ları yönetir. |

<Info>
  `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](/api/izinler-ve-gorunurluk) sayfasına bakın.
</Info>

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

<AccordionGroup>
  <Accordion title="Hasta mı, müşteri mi?">
    Panelde ve belgelerde her zaman **Hasta** denir. API ise `customer` adını kullanır: `/customers`, `customer_id`. İkisi aynı kayıttır.
  </Accordion>

  <Accordion title="Lead mi, hasta mı?">
    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.
  </Accordion>

  <Accordion title="Pipeline mı, aşama mı?">
    **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.
  </Accordion>

  <Accordion title="Klinik mi, tenant mı?">
    İ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.
  </Accordion>

  <Accordion title="Scope mu, izin mi?">
    **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](/api/kimlik-dogrulama/scopelar).
  </Accordion>

  <Accordion title="Destek Talebi mi, Sorun Bildirimi mi?">
    **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.
  </Accordion>

  <Accordion title="Teklif mi, proforma mı?">
    **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.
  </Accordion>

  <Accordion title="Fatura mı, Faturalarım mı?">
    **Faturalar** (`/invoices`) kliniğin hastaya kestiği e-SMM belgeleridir. **Faturalarım** (`/billing`) Flextell'e ödediğiniz abonelik ve kota ödemeleridir.
  </Accordion>

  <Accordion title="Kredi mi, kontör mü?">
    **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.
  </Accordion>

  <Accordion title="Hesap mı, hesaplar mı?">
    `/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.
  </Accordion>

  <Accordion title="Satış mı, tahsilat mı?">
    **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.
  </Accordion>

  <Accordion title="Sohbet mi, konuşma mı?">
    Belgelerde **Sohbet** denir. API alan ve yol adları `conversation` olarak kalır. Bir sohbetin içindeki her ileti `message` kaynağıdır.
  </Accordion>

  <Accordion title="Aynı durum, farklı etiket">
    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.
  </Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.