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

# Giriş

> Flextell API'ye genel bakış — ne yapabilirsiniz, hangi kavramları bilmeniz gerekir ve ilk isteğinizi atmadan önce neleri hazırlamalısınız.

Flextell, klinik ve hastaneler için AI destekli bir iletişim & operasyon platformudur. Flextell API; randevu, hasta (customer), doktor, tedavi, satış, stok, fatura ve çok kanallı mesajlaşma (WhatsApp, Telegram) verilerinize programatik erişim sağlar. Ayrıca AI asistanını her görüşme (conversation) için tekil olarak kontrol etmenize, gerçek zamanlı mesaj olaylarını dinlemenize ve kendi uygulamalarınızı Flextell panelinin yanında çalıştırmanıza imkân verir.

## Neler yapabilirsiniz?

<CardGroup cols={2}>
  <Card title="Operasyon otomasyonu" icon="calendar-check">
    Randevu oluşturma, güncelleme, hatırlatma gönderimi ve doktor ajandası senkronizasyonu.
  </Card>

  <Card title="Çok kanallı mesajlaşma" icon="messages">
    WhatsApp ve Telegram üzerinden hastalarla konuşmalar başlatın, mesaj gönderin, medya ekleyin, AI ajanını açıp kapatın.
  </Card>

  <Card title="Satış & stok yönetimi" icon="box">
    Satışları kaydedin, ödeme alın, depolar arası transfer yapın, stok girişi/sayımı oluşturun.
  </Card>

  <Card title="Gerçek zamanlı akış" icon="bolt">
    Pusher tabanlı WebSocket kanallarıyla yeni mesajları, okundu olaylarını ve ajan durumunu anlık alın.
  </Card>
</CardGroup>

## Temel kavramlar

Flextell API'yi kullanmaya başlamadan önce dört temel kavramı tanımakta fayda var.

**OAuth 2.0 uygulamaları.** API isteklerini, Flextell panelinden oluşturduğunuz bir OAuth uygulamasının adına yaparsınız. Kullanıcı uygulamanıza yetki verir, siz de bu yetki karşılığında aldığınız access token ile istek atarsınız. Detaylar [Kimlik Doğrulama](/authentication/overview) bölümünde.

**Tenant (klinik).** Bir kullanıcı birden fazla kliniğe (tenant) erişebilir. Bu nedenle her API isteğinde hangi klinik adına işlem yaptığınızı `X-Tenant` header'ı ile bildirmeniz gerekir. Detaylar [Multi-Tenancy](/tenancy/overview) bölümünde.

**Scope (izin).** Access token, yalnızca kullanıcı tarafından onaylanmış izinler (`customers:read`, `appointments:write`, `conversations:write` gibi) için çalışır. Tüm izinlerin listesi [Scopes](/authentication/scopes) sayfasında.

**Realtime kanallar.** Görüşmelerdeki yeni mesajlar ve durum değişiklikleri WebSocket üzerinden yayınlanır. Bir JS istemcisiyle `chat-log.{tenantId}` kanalını dinleyebilirsiniz. Detaylar [Realtime](/realtime/overview) bölümünde.

## Base URL'ler

Flextell iki ortam sunar:

| Ortam      | Base URL                      | Kullanım                           |
| ---------- | ----------------------------- | ---------------------------------- |
| Sandbox    | `https://dev.flextell.ai/api` | Geliştirme ve entegrasyon testleri |
| Production | `https://app.flextell.ai/api` | Canlı trafik                       |

Tüm istekler HTTPS üzerinden yapılmalıdır. Düz HTTP istekleri reddedilir. API şu anda `/v1` prefix'i altında servis edilir (ör. `https://dev.flextell.ai/api/v1/appointments`). Bu dokümantasyonun tüm örneklerinde `dev.flextell.ai` kullanılmıştır — production'da aynı yol yapısı `app.flextell.ai` hostu üzerinde çalışır.

<Note>
  API sürümü ve kırıcı değişiklik politikası için [Sürümleme](/resources/versioning) sayfasına bakın.
</Note>

## Sonraki adımlar

<CardGroup cols={2}>
  <Card title="Hızlı Başlangıç" icon="rocket" href="/quickstart">
    İlk isteğinizi beş dakikada atın.
  </Card>

  <Card title="Kimlik Doğrulama" icon="lock" href="/authentication/overview">
    OAuth 2.0 akışını ve uygulama oluşturma adımlarını öğrenin.
  </Card>

  <Card title="API Referansı" icon="code" href="/api-reference">
    Tüm endpoint'lerin otomatik üretilmiş şemalarını inceleyin.
  </Card>

  <Card title="Destek" icon="life-ring" href="/resources/support">
    Sorun yaşarsanız bize nasıl ulaşacağınızı görün.
  </Card>
</CardGroup>