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

# Telegram

> Telegram botu üzerinden kanal kurma ve çalışma mantığı.

Telegram'da iletişim **bot** üzerinden olur. Hastalar size doğrudan numara ile değil, botun kullanıcı adı (`@firma_destek_bot` gibi) üzerinden ulaşır.

## Kurulum akışı

```mermaid theme={null}
sequenceDiagram
    participant U as Firma
    participant BF as @BotFather
    participant P as Flextell Paneli
    participant F as Flextell

    U->>BF: /newbot, isim ver, kullanıcı adı seç
    BF-->>U: Bot token
    U->>P: Entegrasyonlar → Telegram → Yeni Kanal
    U->>P: Token yapıştır
    P->>F: Token doğrula + webhook kur
    F-->>P: status = open
```

<Steps>
  <Step title="BotFather'dan bot oluşturun">
    Telegram'da `@BotFather` ile sohbet açın → `/newbot`. İsim ve kullanıcı adı verin. Size bir **HTTP API token** verir (örn. `1234:ABC...`).
  </Step>

  <Step title="Panele girin">
    `Entegrasyonlar → Telegram → Yeni Kanal` ekranını açın.
  </Step>

  <Step title="Token'ı yapıştırın">
    Kanal adı + bot token girin. Flextell webhook'u otomatik kurar.
  </Step>

  <Step title="Botu paylaşın">
    Hastalar bota `t.me/<bot_kullanici_adi>` linki veya kullanıcı adı arama ile ulaşır. İlk mesaj atan kişi görüşmeyi başlatır.
  </Step>
</Steps>

<Note>
  Telegram tarafında **hasta sizinle ilk mesajı atmak zorundadır.** Bot, daha önce kendisine yazmamış birine mesaj gönderemez — bu Telegram kuralıdır.
</Note>

## Desteklenen mesaj türleri

| Tür               | Yön         | Notlar                       |
| ----------------- | ----------- | ---------------------------- |
| Metin             | Her iki yön | 4096 karakter üst sınır      |
| Görsel            | Her iki yön | —                            |
| Doküman           | Her iki yön | Boyut limiti Telegram'a tabi |
| Ses / Video kaydı | Her iki yön | —                            |
| Konum             | Gelen       | —                            |

## Tipik problemler

| Belirti             | Olası neden          | Çözüm                                                                                |
| ------------------- | -------------------- | ------------------------------------------------------------------------------------ |
| Token doğrulanmıyor | Yanlış kopyalanmış   | BotFather'dan yeni token alın                                                        |
| Mesajlar düşmüyor   | Webhook başka yerde  | Eski bir entegrasyonla aynı bota webhook kurmuşsanız Flextell üzerinden tekrar kurun |
| Bot bulunamıyor     | Kullanıcı adı yanlış | Botu `@username` ile arattırın                                                       |

## API tarafı

Telegram API tarafındaki kullanım için bkz. [Entegrasyonlar → Telegram](/integrations/telegram).