> ## 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 > WhatsApp kanalı eklemeyi, QR kodla bağlamayı, bağlantı kontrolünü, geçmiş mesajları eşitlemeyi ve webhook ayarlarını anlatır. Kliniğinizin WhatsApp numarasını Flextell'e bağladığınızda hasta mesajları **Sohbetler** ekranına düşer, AI asistan yanıt verebilir ve ekibiniz bu numaradan mesaj gönderebilir. Bu sayfa, panelden WhatsApp kanalı eklemeyi ve yönetmeyi anlatır. WhatsApp kanallarını **Bağlantılar → Entegrasyonlar** ekranındaki **WhatsApp** kartından yönetirsiniz: kartta **Kanallar**'a tıklayınca **WhatsApp Kanalları** penceresi açılır. Kanal ekleme için **Oluşturma: Kanal**, düzenleme, bağlama, geçmiş mesajlar ve webhook için **Güncelleme: Kanal** izniniz olmalıdır. Diğer kanal türleri için [Kanallar](/panel/baglantilar/kanallar) sayfasına bakın. ## Telefon gereksinimleri Flextell, numaranızı WhatsApp'ın "bağlı cihaz" özelliğiyle bağlar. Resmi WhatsApp Business API kullanılmaz; numara telefonunuzdaki WhatsApp uygulamasına bağlı kalır. * Numaranın bulunduğu telefon yanınızda olmalı ve WhatsApp uygulaması açılabilmeli. * WhatsApp'ta **Bağlı Cihazlar** menüsü bulunmalı. * Flextell'e yazdığınız numara, QR kodu okutacak telefonun numarasıyla birebir aynı olmalı. ## WhatsApp kanalı ekleme **Bağlantılar → Entegrasyonlar** ekranında **WhatsApp** kartından **Kanallar**'a tıklayın. **Kanal Oluştur** formu açılır. Alanları aşağıdaki tabloya göre doldurun. **Kaydet**'e tıklayınca `Kanal oluşturuldu.` mesajını görürsünüz. **Güncelleme: Kanal** izniniz varsa **WhatsApp Bağlantısı** penceresi kendiliğinden açılır. | Alan | Zorunlu | Açıklama | | - | - | - | | **Kanal İsmi** | Evet | Örn. `Satış`. En çok 120 karakter. | | **Telefon Numarası** | Evet | Örn. `501 234 56 78`. En çok 32 karakter. QR kodu bu numaranın telefonuyla okutmalısınız. | | **Aktif** | Hayır | Varsayılan olarak açıktır. Kapalı kanal mesaj almaz. | | **Sağlayıcı** | Evet | Tek seçenek **Evolution API**'dir; değiştirilemez. | | **Yapay Zeka Yanıt Modu** | Hayır | **Otomatik**, **Yarı otomatik**, **Kapalı** veya **Klinik programını kullan** (varsayılan). | **Yapay Zeka Yanıt Modu** seçenekleri: | Seçenek | Anlamı | | - | - | | **Otomatik** | Yapay zeka yanıtı doğrudan gönderir. | | **Yarı otomatik** | Yapay zeka yanıtı öneri olarak sunar. | | **Kapalı** | Yapay zeka bu kanalda yanıt üretmez. | | **Klinik programını kullan** | Sohbet ayarlarındaki haftalık program uygulanır. | Kanalı düzenlerken **Telefon numarasını değiştirmek mevcut WhatsApp oturumunu başka bir numaraya taşımaz.** Numara değiştiyse kanalı yeni numarayla yeniden bağlamanız gerekir. Haftalık program için [Sohbet ayarları](/panel/sistem/ayarlar/sohbet) sayfasına bakın. ## QR kod ile bağlama **WhatsApp Bağlantısı** penceresi, kanal oluşturulunca kendiliğinden açılır. Daha sonra açmak için kanalın satır menüsünden **Yeniden Bağlan**'ı seçin. Telefonunuzda WhatsApp uygulamasını açın. Android'de sağ üstteki ⋮ menüsüne, iPhone'da **Ayarlar**'a dokunun. **Bağlı Cihazlar**'ı, ardından **Cihaz Bağla**'yı seçin. Telefonunuzu ekrandaki QR koda doğrultun. Ekranda `Telefonunuzdan okutulması bekleniyor...` yazar. Okutma tamamlanınca `WhatsApp bağlantısı kuruldu.` mesajı görünür ve pencere kapanır. Flextell bağlantı durumunu birkaç saniyede bir kendisi kontrol eder; sayfayı yenilemeniz gerekmez. QR kodunu yalnızca kanala yazdığınız numaralı WhatsApp hesabıyla okutun. Başka bir numarayla okutursanız Flextell bağlantıyı kapatır, kanal **Numara Uyuşmuyor** durumuna geçer ve pencerede **Farklı bir numarayla okutuldu** uyarısı görünür. Çözüm için QR kodu doğru telefonla yeniden okutun; numara gerçekten değiştiyse önce kanalın numarasını güncelleyin. ### QR kod okunamıyorsa * QR kod yaklaşık 45 saniye geçerlidir; süre dolduğunda kod bulanıklaşır. **QR Kodunu Yenile** veya **Yeni QR Kodu Al** ile yeni kod isteyin. * Kamerayla okutamıyorsanız WhatsApp'ta **Bunun yerine telefon numarasıyla bağla**'ya dokunun ve pencerede gösterilen kodu girin. * QR kod hemen hazır değilse `QR kodu şu an hazır değil.` görürsünüz; birkaç saniye bekleyip **Yeni QR Kodu Al**'a tıklayın. * Okutmadan **Bağlantıyı Kontrol Et**'e basarsanız `QR kodu henüz telefondan okutulmadı.` mesajı çıkar. ## Bağlantı kontrolü ve yeniden bağlanma **WhatsApp Kanalları** listesinde **Durum** sütunu bağlantının anlık halini gösterir. | Durum | Anlamı | | - | - | | **Bağlı** | WhatsApp bağlantısı aktif; mesajlar akıyor. | | **Bekliyor** | Bağlantı kuruluyor; QR kodun okutulması veya numaranın doğrulanması bekleniyor. | | **Kapalı** | Bağlantı yok. **Yeniden Bağlan** ile yeniden eşleştirin. | | **Numara Uyuşmuyor** | QR kod, kanala yazılan numaradan farklı bir numarayla okutuldu. | Satırın **İşlemler** menüsündeki seçenekler: | Menü öğesi | Ne zaman görünür | Ne yapar | | - | - | - | | **Bağlantı Kontrolü** | Her WhatsApp kanalında | Bağlantıyı sorgular ve sonucu mesajla bildirir. | | **Yeniden Bağlan** | Durum **Bağlı** değilse | **WhatsApp Bağlantısı** penceresini açar. | | **Geçmiş Mesajlar** | Her WhatsApp kanalında | Geçmiş mesaj eşitleme ayarlarını açar. | | **Webhook Ayarları** | Yalnızca durum **Bağlı** iken | Webhook penceresini açar. | | **Düzenle** | **Güncelleme: Kanal** izninizle | Ad, numara, **Aktif** ve yapay zeka yanıt modunu değiştirir. | | **Sil** | **Silme: Kanal** izninizle | **Kanalı Sil** penceresini açar; silmek için **Parolanız** istenir. Ayrıntılar için [Kanallar](/panel/baglantilar/kanallar) sayfasındaki **Kanalı silme** bölümüne bakın. | **Bağlantı Kontrolü** şu mesajlardan birini verir: * `WhatsApp bağlantısı aktif.` * `WhatsApp bağlantısı kuruluyor.` * `WhatsApp bağlantısı kapalı. Yeniden bağlanabilirsiniz.` * Numara uyuşmuyorsa, uyuşmazlığı açıklayan uyarı metni. * `WhatsApp bağlantısı kontrol edilemedi.` (kontrol sırasında bir hata oluştu; biraz sonra yeniden deneyin.) Telefonunuzda WhatsApp oturumu kapanırsa (ör. **Bağlı Cihazlar**'dan cihazı kaldırırsanız) kanal **Kapalı** olur. **Yeniden Bağlan** ile yeni bir QR kod alıp aynı numarayla okutun. Geçmiş mesaj eşitlemesi açıksa bağlantı koptuğu sürede gelen mesajlar yeniden bağlanınca aktarılır. **Bağlantı Kontrolü** için **Durum sorgulama: Kanal** veya **Güncelleme: Kanal** izni gerekir. Menüde görünmesine rağmen işlem izin hatası verirse klinik yöneticinizden bu izni isteyin. İzinler için [Roller ve izinler](/panel/sistem/roller) sayfasına bakın. Bağlantı sorunlarını adım adım gidermek için [WhatsApp sorun giderme](/panel/sorun-giderme/whatsapp) sayfasına bakın. ## Geçmiş mesajları eşitleme Telefonunuzdaki eski WhatsApp yazışmalarını Flextell'e aktarabilirsiniz. Numara ilk kez bağlandığında ve henüz ayar yapılmamışsa **Geçmiş Mesajlar** penceresi kendiliğinden açılır: ` bağlandı. Telefondaki geçmiş mesajlar da sisteme aktarılsın mı?` Sonradan ayarlamak için satır menüsünden **Geçmiş Mesajlar**'ı açın; pencere o zaman **Geçmiş Mesaj Senkronizasyonu** başlığıyla gelir. | Ayar | Seçenekler | Not | | - | - | - | | **Geçmiş mesajları aktar** | Açık / kapalı | Hat ilk bağlandığında seçtiğiniz dönem, bağlantı her koptuğunda da aradaki mesajlar aktarılır. | | **Dönem** | **Son 30 gün**, **Son 90 gün**, **Son 1 yıl** | 30 gün en hızlı seçenektir; 90 gün çoğu klinik için yeterlidir; WhatsApp en fazla 1 yıl verir. | | **Hangi sohbetler aktarılsın?** | **Yalnızca kayıtlı kişiler**, **Tüm sohbetler** | Kayıtlı kişi: hasta, lead ya da bu hatta daha önce konuşması olan numara. **Tüm sohbetler** seçilirse sistemde olmayan numaralar için yeni kayıt açılır. | | **Sistemde olmayan numaralar** | **Hasta olarak kaydet**, **Lead olarak kaydet** | Yalnızca **Tüm sohbetler** seçiliyken görünür. Lead olarak kaydedilenler aktif pipeline'ın ilk aşamasına eklenir; aktif pipeline yoksa hasta olarak kaydedilir. | | **Kayıtlı kişilerin adları** | **Boş adları doldur**, **Kayıtlara dokunma** | **Boş adları doldur**, adı girilmemiş kayıtlara WhatsApp adını yazar. | Varsayılanlar: dönem 90 gün, yalnızca kayıtlı kişiler, yeni numaralar hasta olarak, boş adlar doldurulur. **Tüm sohbetler** seçilirse hattaki kişisel yazışmalar da sisteme aktarılır ve her numara için kayıt açılır. Numaranızı hem kişisel hem klinik amaçla kullanıyorsanız **Yalnızca kayıtlı kişiler**'i tercih edin. Aktarım hakkında bilmeniz gerekenler: * Aktarım sırasında Flexy yanıt vermez ve bildirim gönderilmez. * Grup sohbetleri aktarılmaz. * Medya (fotoğraf, belge vb.) yalnızca son 30 gün için alınabilir. * Silinmiş hastalar geri getirilmez. * Hat bağlı değilse aktarım, hat bağlandığında kendiliğinden başlar. Yukarıdaki tabloya göre seçimlerinizi yapın. Hat bağlıysa **Aktarımı Başlat**'a, yalnızca ayarı saklamak istiyorsanız **Kaydet**'e tıklayın. İlk bağlantıda vazgeçmek için **Şimdi Değil**'i seçin. `Geçmiş mesajlar aktarılıyor. İlerlemeyi sohbetler sayfasında görebilirsiniz.` mesajı çıkar. Ayrıntı için [Sohbetler](/panel/sohbetler/genel-bakis) ekranına bakın. Pencerenin altında son aktarımın özeti görünür: `Son aktarım tarihinde tamamlandı: mesaj.`, devam eden aktarım için `Aktarım sürüyor (%

): mesaj aktarıldı.`, yarım kalan için `Son aktarım tamamlanamadı. Yeniden başlatabilirsiniz.` Hat koparsa aktarım, hat yeniden bağlanınca kaldığı yerden devam eder. Atlanan mesajlar `Atlanan mesajlar: kayıtsız numara, silinmiş kayıt, numarası gizli.` şeklinde sayılır. **Yeniden Aktar** düğmesi aktarımı yeniden başlatır; daha önce aktarılan mesajlar atlanır (`Geçmiş mesajlar yeniden aktarılıyor; daha önce aktarılanlar atlanır.`). Hat bağlı değilse veya aktarım sürüyorsa düğme çalışmaz. Aynı kişi klinikteki birden fazla WhatsApp hattıyla yazıştıysa Flextell tek hasta kaydı tutar; her hat için ayrı sohbet oluşur ve her mesaj kendi hattında görünür. ## Webhook ayarları **Webhook Ayarları**, WhatsApp altyapısının olayları nereye ilettiğini belirler. Normal kullanımda bu ayara dokunmanız gerekmez; yalnızca teknik bir ihtiyacınız varsa değiştirin. Menü öğesi yalnızca kanal **Bağlı** iken görünür. | Alan | Açıklama | | - | - | | **Webhook URL** | Olayların gönderileceği adres. Örn. `https://ornek.com/webhook/whatsapp`. `http` veya `https` ile başlamalı, en çok 2048 karakter olmalı. | | **Webhook Etkin** | Webhook'u açar veya kapatır. | | **Webhook Olayları** | İletilecek olayların işaret kutuları. | **Webhook Olayları** listesi 23 olay içerir. Örnekler: **Bağlantı durumu**, **Yeni mesaj**, **Mesaj düzenleme**, **Mesaj güncelleme**, **Mesaj silme**, **Mesaj gönderme**, **Yazıyor / ses kaydı**, **Sohbet güncelleme**, **Grup oluşturma**. Kaydetmek için **Kaydet**'e tıklayın; başarılı olunca `Webhook ayarları güncellendi.` görünür. Ayarlar yüklenemezse `Webhook ayarları yüklenemedi.` görünür ve düğme **Yeniden Dene**'ye döner. Webhook adresini Flextell'in varsayılan adresinden başka bir yere yönlendirirseniz veya gerekli olayları kapatırsanız Flextell yeni mesajları ve bağlantı değişikliklerini alamaz. Flextell yalnızca bağlantı, yeni mesaj, mesaj düzenleme/güncelleme/silme, durum ve yazıyor olaylarını işler. Emin değilseniz değiştirmeyin. ## İlgili sayfalar Telegram, Instagram ve website kanalları. Gelen WhatsApp mesajlarını yanıtlama. Bağlantı koparsa ne yapmalı? Kanalı API ile kurmak isteyen geliştiriciler için. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.