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

# WhatsApp bağlantı sorunları

> WhatsApp kanalının bağlanmaması, kopması, numara uyuşmazlığı ve mesajların gelmemesi gibi sorunların çözümünü anlatır.

WhatsApp kanalınız bağlanmıyor, kopuyor ya da mesajlar **Sohbetler** ekranına düşmüyorsa bu sayfadan başlayın. Her başlık bir belirtiyi, olası nedenlerini ve çözümünü anlatır.

Kanalın durumunu **Bağlantılar → Entegrasyonlar** ekranında **WhatsApp** kartındaki **Kanallar** düğmesinden açılan **WhatsApp Kanalları** penceresinde görürsünüz. **Durum** sütunu dört değerden birini gösterir:

| Durum | Anlamı | Bu sayfada |
| - | - | - |
| **Bağlı** | Bağlantı aktif. | [Mesajlar gelmiyor](#mesajlar-gelmiyor) |
| **Bekliyor** | Bağlantı kuruluyor; QR kodun okutulması veya numaranın doğrulanması bekleniyor. | [Bağlantı kapalı veya bekliyor](#bağlantı-kapalı-veya-bekliyor) |
| **Kapalı** | Bağlantı yok. | [Bağlantı kapalı veya bekliyor](#bağlantı-kapalı-veya-bekliyor) |
| **Numara Uyuşmuyor** | QR kod, kanala yazılan numaradan farklı bir numarayla okutulmuş. | [Numara uyuşmuyor](#numara-uyuşmuyor) |

<Tip>
  Önce satırın **İşlemler** menüsünden **Bağlantı Kontrolü**'nü çalıştırın. Verdiği mesaj sorunun hangi başlığa girdiğini gösterir. Bu işlem için **Durum sorgulama: Kanal** veya **Güncelleme: Kanal** izni gerekir; izin hatası alırsanız bkz. [Yetki hataları](/panel/sorun-giderme/yetki-hatalari).
</Tip>

## QR kod okutulamıyor

**WhatsApp Bağlantısı** penceresindeki QR kodu okutamıyorsanız aşağıdakileri sırayla deneyin.

<Steps>
  <Step title="Kodun süresini kontrol edin">
    QR kod yaklaşık 45 saniye geçerlidir. Kod bulanıklaşmışsa süresi dolmuştur. **QR Kodunu Yenile** veya **Yeni QR Kodu Al** düğmesine tıklayıp yeni kodu okutun.
  </Step>

  <Step title="Doğru telefonu kullanın">
    Pencerede `QR kodunu yalnızca <numara> numaralı WhatsApp hesabıyla okutun.` yazar. Kodu yalnızca bu numaranın bulunduğu telefondan okutun.
  </Step>

  <Step title="WhatsApp menüsünü doğru açın">
    WhatsApp'ta Android'de sağ üstteki ⋮ menüsüne, iPhone'da **Ayarlar**'a dokunun. Ardından **Bağlı Cihazlar** → **Cihaz Bağla**'yı seçin ve telefonu ekrandaki koda doğrultun.
  </Step>

  <Step title="Kamerayla okutamıyorsanız kodu elle girin">
    WhatsApp'ta **Bunun yerine telefon numarasıyla bağla**'ya dokunun ve pencerede gösterilen kodu girin.
  </Step>
</Steps>

| Gördüğünüz mesaj | Ne yapmalısınız |
| - | - |
| `QR kodu şu an hazır değil.` | Birkaç saniye bekleyin, ardından **Yeni QR Kodu Al**'a tıklayın. |
| `QR kodu henüz telefondan okutulmadı.` | **Bağlantıyı Kontrol Et**'e kodu okutmadan bastınız. Kodu okutun; pencere bağlantıyı kendisi de kontrol eder. |
| `WhatsApp QR kodu alınamadı.` | Birkaç dakika sonra **Yeni QR Kodu Al** ile yeniden deneyin. Sorun sürerse [Sorun Bildirimi](/panel/sistem/sorun-bildirimleri) oluşturun. |

**WhatsApp Bağlantısı** penceresini kapattıysanız satırın **İşlemler** menüsünden **Yeniden Bağlan**'ı seçin. Kanal oluşturulunca pencere kendiliğinden açılmadıysa **Güncelleme: Kanal** izniniz yok demektir; **Yeniden Bağlan** için de bu izin gerekir.

## Bağlantı kapalı veya bekliyor

### Durum Bekliyor

QR kodu okuttuktan sonra kanal birkaç saniye **Bekliyor** kalabilir. Flextell, telefonun numarasını doğrulayıp kanaldaki numarayla karşılaştırır; doğrulama bitince durum **Bağlı** olur. **Bağlantı Kontrolü** `WhatsApp bağlantısı kuruluyor.` diyorsa birkaç saniye bekleyip yeniden deneyin.

Durum uzun süre **Bekliyor** kalıyorsa QR kodu okutmamışsınızdır ya da kodun süresi dolmuştur. [QR kod okutulamıyor](#qr-kod-okutulamıyor) adımlarına dönün.

### Durum Kapalı

**Kapalı**, WhatsApp oturumunun bulunmadığı anlamına gelir. Başlıca nedenler:

* Kanalı yeni oluşturdunuz ve QR kodu henüz okutmadınız.
* Telefonda **Bağlı Cihazlar** listesinden bu cihazı kaldırdınız ya da oturum düştü.
* QR kod başka bir numarayla okutuldu ve Flextell bağlantıyı kapattı (bkz. [Numara uyuşmuyor](#numara-uyuşmuyor)).

<Steps>
  <Step title="Bağlantıyı kontrol edin">
    **İşlemler** menüsünden **Bağlantı Kontrolü**'nü seçin. Kapalıysa `WhatsApp bağlantısı kapalı. Yeniden bağlanabilirsiniz.` mesajını görürsünüz.
  </Step>

  <Step title="Yeniden bağlanın">
    **Yeniden Bağlan**'ı seçin. Bu menü öğesi yalnızca durum **Bağlı** değilken görünür.
  </Step>

  <Step title="QR kodu okutun">
    Kanaldaki numaranın telefonuyla yeni QR kodu okutun. `WhatsApp bağlantısı kuruldu.` mesajı çıkınca pencere kapanır.
  </Step>
</Steps>

Bağlantı koptuğu sürede gelen mesajlar geri gelir mi? Geçmiş mesaj eşitlemesi açıksa evet: bağlantı yeniden kurulunca arada kalan mesajlar aktarılır. Ayrıntı için [Geçmiş mesajlar eşitlenmedi](#geçmiş-mesajlar-eşitlenmedi) bölümüne bakın.

<Note>
  `WhatsApp bağlantısı kontrol edilemedi.` mesajı, WhatsApp altyapısına o an ulaşılamadığında da görünebilir. Birkaç dakika sonra yeniden deneyin. Sorun sürerse [Sorun Bildirimi](/panel/sistem/sorun-bildirimleri) oluşturun.
</Note>

## Numara uyuşmuyor

Kanal **Numara Uyuşmuyor** durumundaysa QR kod, kanalda kayıtlı numaradan farklı bir numarayla okutulmuştur. Flextell güvenlik için WhatsApp oturumunu kapatır, kanal **Kapalı** olur. **WhatsApp Bağlantısı** penceresinde **Farklı bir numarayla okutuldu** uyarısı ve şu biçimde bir açıklama görünür: `Bu kanal <beklenen numara> numarası için tanımlı, ancak QR kodu <okutulan numara> numarasıyla okutulduğu için bağlantı kapatıldı.` Flextell bağlı hatları düzenli aralıklarla da denetler; yanlış numarayla eşleşmiş bir oturum bu denetimde de kapatılır.

Çözüm, numaranın hangisinin doğru olduğuna bağlıdır.

<Tabs>
  <Tab title="Kanaldaki numara doğru">
    <Steps>
      <Step title="Doğru telefonu hazırlayın">
        Kanalda kayıtlı numaranın bulunduğu telefonu alın.
      </Step>

      <Step title="Yeniden bağlanın">
        **İşlemler → Yeniden Bağlan**'ı seçin ve QR kodu bu telefonla okutun.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Kanaldaki numara yanlış veya numara değişti">
    <Steps>
      <Step title="Numarayı düzeltin">
        **İşlemler → Düzenle**'yi seçin, **Telefon Numarası** alanını doğru numarayla güncelleyin ve **Kaydet**'e tıklayın.
      </Step>

      <Step title="Yeniden bağlanın">
        **Yeniden Bağlan**'ı seçin ve QR kodu yeni numaranın telefonuyla okutun.
      </Step>
    </Steps>
  </Tab>
</Tabs>

<Warning>
  Kanalı düzenlerken **Telefon numarasını değiştirmek mevcut WhatsApp oturumunu başka bir numaraya taşımaz.** Numarayı değiştirdikten sonra mutlaka **Yeniden Bağlan** ile yeni numarayı eşleştirin.
</Warning>

## Mesajlar gelmiyor

Kanal **Bağlı** göründüğü hâlde hasta mesajları **Sohbetler** ekranına düşmüyorsa şu nedenleri sırayla kontrol edin.

| Kontrol edin | Ne yapmalısınız |
| - | - |
| Kanalın durumu **Bağlı** mı? | **Kapalı** veya **Bekliyor** ise [Bağlantı kapalı veya bekliyor](#bağlantı-kapalı-veya-bekliyor) adımlarını izleyin. |
| **Aktif** anahtarı açık mı? | **İşlemler → Düzenle** ile **Aktif**'i açın. Kapalı kanal mesaj almaz ve bu kanaldan mesaj gönderilemez (bkz. [Mesaj gönderilemiyor](#mesaj-gönderilemiyor)). |
| Webhook ayarı değişmiş mi? | **Bağlı** kanalda **İşlemler → Webhook Ayarları**'nı açın. **Webhook Etkin** açık, **Webhook URL** Flextell'in varsayılan adresi ve **Yeni mesaj** ile **Bağlantı durumu** olayları işaretli olmalı. Adresi başka bir yere yönlendirdiyseniz Flextell mesajları alamaz. Ayrıntı için [WhatsApp](/panel/baglantilar/whatsapp) sayfasındaki webhook bölümüne bakın. |
| Gönderen engelli mi? | Engellenen kişinin mesajları işlenmez. **Sohbet Yönetimi → Engellenen Kullanıcılar** listesine bakın. Kısa sürede art arda çok sayıda mesaj gönderen numara da geçici olarak engellenebilir. Engeli kaldırma için [Engellenen kullanıcılar](/panel/sohbetler/engellenen-kullanicilar) sayfasına bakın. |
| Mesaj bir grup sohbetinden mi geliyor? | Grup sohbetleri alınmaz; Flextell yalnızca bire bir yazışmaları işler. |
| Klinik deneme süresi dolmuş mu? | Deneme süresi dolmuş kliniklerde WhatsApp mesajları işlenmez. Bkz. [Abonelik ve kurulum kilidi](/panel/sorun-giderme/abonelik-ve-kurulum-kilidi). |

Mesaj geliyor ama beklediğiniz yerde görünmüyorsa:

* **Sohbetleri tam görme izni olmayan kullanıcılar** (ör. Satış Temsilcisi) yalnızca kendilerine atanmış Lead'lerin ve hastaların sohbetlerini görür. Bu kullanıcıların listesi canlı güncellenmeyebilir; sayfayı yenileyin ya da başka bir sayfaya geçip dönün.
* Numarasını gizleyen kişilerin mesajı, numarasız bir kayıt olarak görünebilir. Numara sonradan öğrenilince kayıt, o numaralı hastayla birleştirilir veya ona taşınır.
* Kliniğin telefonundan bir sohbete kendiniz elle mesaj yazarsanız AI asistan o sohbette 30 dakika devre dışı kalır. AI asistan yanıt vermiyorsa bkz. [AI asistan sorunları](/panel/sorun-giderme/ai-asistan).

## Mesaj gönderilemiyor

Kanalın **Aktif** anahtarı kapalıysa o kanalın sohbetinde metin, dosya, sesli mesaj, hızlı yanıt, tepki ve AI önerisi gönderimi reddedilir. Panel şu uyarıyı gösterir; mesaj gönderilmez, kuyruğa da alınmaz:

| Gördüğünüz mesaj | Neden | Ne yapmalısınız |
| - | - | - |
| `Bu sohbetin kanalı pasif. Mesaj göndermek için kanalı yeniden etkinleştirin.` | Kanalın **Aktif** anahtarı kapalı. | **Bağlantılar → Entegrasyonlar** ekranında **Kanallar** penceresini açın, satırın **İşlemler → Düzenle** menüsüyle **Aktif**'i açıp kaydedin, sonra mesajı yeniden gönderin. |

<Note>
  Bu uyarı kanalın **Aktif** anahtarının kapalı olduğunu söyler; WhatsApp bağlantısının kopması değildir. Bağlantı kopuksa [Bağlantı kapalı veya bekliyor](#bağlantı-kapalı-veya-bekliyor) adımlarını izleyin. Mesaj kabul edildikten sonra hat kapanırsa mesaj iletilemez ve gönderim durumu `failed` (başarısız) olarak kaydedilir; panel bunu ayrıca işaretlemeyebilir. Kanalı yeniden bağlayıp mesajı tekrar gönderin.
</Note>

## Geçmiş mesajlar eşitlenmedi

Telefondaki eski yazışmalar Flextell'e gelmediyse **İşlemler → Geçmiş Mesajlar** penceresini açın. Pencerenin altındaki son aktarım özeti sorunu gösterir.

| Belirti | Neden | Çözüm |
| - | - | - |
| Hiçbir şey aktarılmadı | **Geçmiş mesajları aktar** kapalı ya da ayar hiç kaydedilmedi. | Anahtarı açın, **Dönem**'i seçin ve **Aktarımı Başlat**'a (ya da **Kaydet**'e) tıklayın. |
| Aktarım başlamadı | Hat bağlı değil. | Önce kanalı bağlayın. Hat bağlanınca aktarım kendiliğinden başlar. |
| `Aktarım sürüyor (%<p>): <n> mesaj aktarıldı.` | Aktarım sürüyor. | Bekleyin. İlerleme **Sohbetler** ekranında da görünür. Tüm sohbetleri görme izni olmayan kullanıcılar ilerlemeyi canlı göremeyebilir. |
| `Son aktarım tamamlanamadı. Yeniden başlatabilirsiniz.` | Aktarım yarıda kesildi. | Hattın **Bağlı** olduğundan emin olun ve **Yeniden Aktar**'a tıklayın. Daha önce aktarılan mesajlar atlanır. |
| Bazı kişilerin mesajları eksik | **Yalnızca kayıtlı kişiler** seçili; sistemde olmayan numaralar atlanır. | **Hangi sohbetler aktarılsın?** ayarını **Tüm sohbetler** yapıp yeniden aktarın. Bu seçim kişisel yazışmaları da getirir; önce uyarıyı okuyun. |
| `Atlanan mesajlar: <n> kayıtsız numara, <n> silinmiş kayıt, <n> numarası gizli.` | Sistemde olmayan numaralar, silinmiş hastalar ve numarası gizli kişiler aktarılmaz. | Silinmiş hastalar geri getirilmez. Diğerleri için ayarları gözden geçirin. |
| Eski mesajlar var ama fotoğraf ve belgeler yok | Medya yalnızca son 30 gün için alınabilir. | Daha eski medya aktarılamaz. |
| Grup yazışmaları yok | Grup sohbetleri aktarılmaz. | Çözüm yok; bu beklenen davranıştır. |
| Seçtiğiniz dönemden eski mesajlar yok | Yalnızca seçilen **Dönem** (**Son 30 gün**, **Son 90 gün**, **Son 1 yıl**) içindeki mesajlar gelir. | Daha uzun bir dönem seçip **Yeniden Aktar**'a tıklayın. WhatsApp en fazla 1 yıl verir. |

**Yeniden Aktar** düğmesi hat bağlı değilse veya aktarım sürüyorsa çalışmaz. Eşitleme sırasında Flexy yanıt vermez ve bildirim gönderilmez; bu normaldir.

<Note>
  Bağlantı her koptuğunda, eşitleme açıksa arada kalan mesajlar yeniden bağlanınca aktarılır. Eşitleme kapalıysa bağlantı koptuğu sürede gelen mesajlar telefonda kalır.
</Note>

## İlgili sayfalar

<CardGroup cols={2}>
  <Card title="WhatsApp" icon="message-circle" href="/panel/baglantilar/whatsapp">
    Kanal ekleme, QR kodla bağlama, geçmiş mesajlar ve webhook ayarları.
  </Card>

  <Card title="Kanallar" icon="plug" href="/panel/baglantilar/kanallar">
    Telegram, Instagram ve website kanalları.
  </Card>

  <Card title="Engellenen kullanıcılar" icon="ban" href="/panel/sohbetler/engellenen-kullanicilar">
    Engelleri görme ve kaldırma.
  </Card>

  <Card title="Yetki hataları" icon="lock" href="/panel/sorun-giderme/yetki-hatalari">
    Menü öğesi görünüyor ama işlem izin hatası veriyor.
  </Card>
</CardGroup>


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