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

> Flextell'in desteklediği kanal türleri, ortak görüşme akışı ve kanal eklemenin temel mantığı.

Kanal, Flextell'in dış dünya ile konuşma kapısıdır. Hangi kanaldan gelirse gelsin gelen mesaj **aynı veri modelinde** (`Conversation` + `ChatLog`) toplanır; firma tek bir gelen kutusunda hepsini görür.

## Kanal türleri

| Tür      | `type`     | Durum  | Kurulum                                                |
| -------- | ---------- | ------ | ------------------------------------------------------ |
| WhatsApp | `whatsapp` | Stabil | [WhatsApp ekle](/documentation/conversations/whatsapp) |
| Telegram | `telegram` | Stabil | [Telegram ekle](/documentation/conversations/telegram) |

<Note>
  Kanal kurulumu **yalnızca panel üzerinden** yapılır. API üzerinden yeni kanal oluşturulamaz — kurulumdan sonra kanal `GET /channels` listesine düşer.
</Note>

## Ortak görüşme akışı

```mermaid theme={null}
sequenceDiagram
    actor H as Hasta
    participant K as Kanal (WA/TG)
    participant F as Flextell
    participant AI as AI Asistan
    participant O as Firma (Panel)

    H->>K: Mesaj
    K->>F: Webhook
    F->>F: Conversation + ChatLog yaz
    F-->>O: Realtime event (ChatLogCreated)
    alt Asistan açık
      F->>AI: Mesaj
      AI->>F: Otomatik yanıt
      F->>K: Yanıt gönder
      K->>H: Yanıt
    else Asistan kapalı
      O->>F: Manuel yanıt
      F->>K: Yanıt gönder
      K->>H: Yanıt
    end
```

Akışın detayları:

* **Conversation** uzun soluklu — hasta hafta sonra tekrar yazdığında aynı thread'e eklenir.
* **AI Asistan** görüşme bazındadır. Aynı hastanın iki ayrı kanalında biri açık, biri kapalı olabilir.
* **Realtime event'leri** her yeni mesajda yayılır; entegrasyonlar bu event'leri dinleyerek anlık tepki verir.

## Bir kanalın sağlığı

| Durum     | Etiket     | Anlamı                                 | Ne yapılmalı            |
| --------- | ---------- | -------------------------------------- | ----------------------- |
| `open`    | Aktif      | Kanal çalışıyor, mesaj alıp gönderiyor | —                       |
| `waiting` | Bağlanıyor | Bağlantı bekleniyor (örn. QR okutma)   | Telefonu açıp QR okutun |
| `closed`  | Kapalı     | Bağlantı koptu veya henüz kurulmadı    | Panelden yeniden bağla  |

## AI asistanı ve kanallar

Asistanın açık/kapalı durumu **kanalda değil, görüşmede** tutulur (`Conversation.agent_disabled`). Detay: [İnsan devri](/documentation/conversations/handoff).

## Sohbet ayarları ile ilişki

`AI_REPLY_WINDOWS` (`tenant.chat.ai_reply_windows`) firma genelinde AI yanıt pencerelerini (gün, saat aralığı, mod) tanımlar; bu ayar tüm kanallar için geçerlidir. Detay: [Sohbetler](/documentation/conversations/overview).

## Sonraki adımlar

<CardGroup cols={2}>
  <Card title="WhatsApp ekle" icon="whatsapp" href="/documentation/conversations/whatsapp">
    QR ile WhatsApp Web bağlama.
  </Card>

  <Card title="Telegram ekle" icon="telegram" href="/documentation/conversations/telegram">
    BotFather'dan token alıp bağlama.
  </Card>

  <Card title="Sohbet ayarları" icon="sliders" href="/documentation/conversations/overview">
    AI yanıt pencereleri ve firma geneli ayarlar.
  </Card>

  <Card title="Conversation API" icon="code" href="/integrations/overview">
    Kanal kurulduktan sonra API tarafı.
  </Card>
</CardGroup>