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

# Kanallar API

> Kliniğin hastalarla iletişim kurduğu entegrasyon noktalarını (WhatsApp, Instagram, Web sitesi vb.) listelemek için kullanılan endpoint.

<Warning>
  Bu API tamamen **salt okunur (read-only)** bir servistir. Yeni kanal ekleme, mevcut kanalları düzenleme veya silme işlemleri API üzerinden yapılamaz; bu işlemler yalnızca **Admin Paneli (Filament)** üzerinden yönetilebilir.
</Warning>

<Note>
  Tüm isteklerde `X-Tenant` header'ı **zorunludur** ve sadece ilgili tenant'a ait kanallar listelenir.
</Note>

## Endpoint özeti

| Metot | Endpoint           | Açıklama                                       |
| ----- | ------------------ | ---------------------------------------------- |
| `GET` | `/api/v1/channels` | Tenant'a ait tüm iletişim kanallarını listeler |

<Tip>
  Tüm parametreler, alanlar ve örnek istek/yanıtlar için **[API Referansı](/api-reference)** sekmesine bakın.
</Tip>

## İletişim kanalı (channel) kavramı

İletişim kanalları, kliniğin (tenant'ın) hastalarla iletişim kurduğu **entegrasyon noktalarını** temsil eder. Örneğin: "Klinik WhatsApp Hattı 1", "Instagram Hesabı" vb.

<Tip>
  Sohbetler (Conversations) API'sini kullanarak yeni bir konuşma başlatmak istediğinizde, sistemi hangi kanal üzerinden mesaj göndereceği konusunda yönlendirmek için bu listedeki **aktif** kanallardan birinin ID'sini (`channel_id`) kullanmanız gerekir.
</Tip>

<Tip>
  **Entegrasyon için pratik not:** Kullanıcı arayüzünüzde (UI) mesaj göndermek için bir kanal seçimi yaptıracaksanız; yalnızca `is_active` değeri `true` **ve** `status` değeri `open` olan kanalları listelemeniz önerilir. Aksi takdirde mesaj gönderim işlemleri arka planda hata alabilir.
</Tip>

## Yetkilendirme

### Uygulama izinleri (permissions)

| İşlem     | Permission        |
| --------- | ----------------- |
| Listeleme | `ViewAny:Channel` |

### Token scope'ları (Passport)

| İşlem           | Scope           |
| --------------- | --------------- |
| Okuma (`index`) | `channels:read` |