WhatsApp entegrasyonunuzda sorun yaşamak, müşteri desteğinizi ve iletişim süreçlerinizi aksatabilir. Bu kapsamlı sorun giderme kılavuzu, Qpien üzerinde standart WhatsApp Web bağlantısını veya WhatsApp Business API'yi kullanırken karşılaşabileceğiniz en yaygın hataları ele almaktadır. Kök nedeni hızlıca belirleyip çözmenize yardımcı olmak için bu sorunları; bağlantı problemleri, mesajlaşma kısıtlamaları ve hesap durumu uyarıları olarak kategorize ettik.

QR Kod Taranmıyor veya Zaman Aşımına Uğruyor (Standart WhatsApp)

Standart bir WhatsApp bağlantısı kurarken Qpien, güvenli bir oturum açma kimliği işlevi gören bir QR kod oluşturur. Güvenlik nedeniyle bu kod dinamiktir ve çok hızlı (genellikle 10 ila 20 saniye içinde) geçerliliğini yitirir.

En yaygın neden kodun taranmasındaki gecikmedir. Kurulum sayfasını açtıktan sonra çok uzun süre beklerseniz kod geçersiz hale gelir. Ayrıca, bilgisayarınızdaki veya mobil cihazınızdaki zayıf internet bağlantısı tarama işleminin gerçekleşmesini engelleyebilir.

• Stabil olduğundan emin olmak için cep telefonunuzun internet bağlantısını kontrol edin.

• Yeni ve aktif bir QR kod oluşturmak için Qpien kurulum sayfasını yenileyin.

• Vakit kaybetmeden WhatsApp mobil uygulamanızı açın, Bağlı Cihazlar>Cihaz Bağla yolunu izleyin ve yeni kodu tarayın.

• Qpien kurulum formuna kaydettiğiniz telefon numarasının, kodu taramak için kullandığınız cihazdaki numarayla birebir eşleştiğinden emin olun. Numara uyuşmazlığı, bağlantının başarısız olmasına neden olur.

Bu Numara Mevcut Bir WhatsApp Hesabına Kayıtlı (WhatsApp Business API)

Meta katı bir kural uygular: Tek bir telefon numarası aynı anda hem standart WhatsApp mobil uygulamasında (veya WhatsApp Business uygulamasında) hem de WhatsApp Business API'de aktif olamaz. API yönlendirmesinin devreye girebilmesi için hesabı mobil uygulamadan tamamen ayırmanız ve silmeniz gerekir.

• Mobil cihazınızda WhatsApp veya WhatsApp Business uygulamasını açın.

• Ayarlar>Hesap>Hesabımı Sil yolunu izleyin.

• Hesabı mobil uygulamadan kalıcı olarak silmek için ekrandaki talimatları takip edin.

• Birkaç dakika bekleyin, ardından Qpien'e dönerek API bağlantı işlemini tekrar deneyin. Numaranız artık API'ye atanmaya hazırdır.

Mobil WhatsApp uygulaması ile kullanılıyorsa:

Hatada gösterilen Daha fazla bilgi edin bağlantısının altındaki adımları izleyerek numaranın o WhatsApp hesabıyla bağlantısını kesin. Ardından katılım sürecimizi başarıyla tekrar deneyebilirsiniz.

Not: Bir WhatsApp hesabının bağlantısını kesmek, yedeklenmediği sürece sohbet geçmişini siler.

Hiçbiri geçerli değilse, manuel bir bağlantı deneyebilmemiz için aşağıdaki bilgilerle Destek ekibiyle iletişime geçin:

• WhatsApp Hesap ID'si

• Telefon numarası

Mesaj Gönderilemiyor / "Mesaj Gönderimi Başarısız" (24 Saat Kuralı)

WhatsApp Business API kullanıyorsanız, mesaj giriş kutusunun devre dışı olduğunu veya gönderdiğiniz bir mesajın müşteri penceresiyle ilgili bir hata vererek anında başarısız olduğunu fark edebilirsiniz.

Meta, işletmelerin kullanıcılara spam göndermesini önlemek için katı bir "24 Saatlik Müşteri Hizmetleri Penceresi" uygular. Bu pencere, bir müşterinin size mesaj gönderdiği an açılır. O müşteriden yeni bir mesaj gelmeden tam 24 saat geçerse pencere kapanır. Artık standart, serbest formda metin mesajları göndermenize izin verilmez. Bu aktif 24 saatlik pencerenin dışındaki bir müşteriye yanıt vermek veya yeni bir görüşme başlatmak için önceden onaylanmış bir WhatsApp Şablon Mesajı kullanmalısınız.

• Qpien'deki onaylı listenizden ilgili bir şablon seçin.

• Şablonu müşteriye gönderin.

• Müşteri şablonunuza yanıt verdiğinde yeni bir 24 saatlik pencere açılır; normal şekilde yazmaya ve serbest formda mesajlar göndermeye devam edebilirsiniz.

Henüz bir şablon oluşturmadıysanız veya nasıl yapılacağını bilmiyorsanız, WhatsApp Mesaj Şablonu Oluşturma kılavuzuna göz atın.

Şablon Mesaj Reddedildi veya İletilmedi

Bazen bir şablon mesajı, 24 saatlik pencerenin dışındaki bir müşteriye ulaşmaya çalışsanız bile gönderilemez. Bu durum genellikle iki sorundan kaynaklanır: Şablon Meta tarafından onaylanmamıştır veya ücretli mesajın gönderilmesini engelleyen bir faturalandırma sorunu vardır.

• Onay Durumunu Kontrol Edin: Meta Business Manager'da (veya Gupshup panelinizde) ilgili şablonun durumunun "Onaylandı" olduğunu doğrulayın. Meta, aşırı agresif promosyon dili kullanan veya ticaret politikalarını ihlal eden şablonları düzenli olarak reddeder.

• Hesap Bakiyesini Kontrol Edin: Şablon onaylıysa ancak Gupshup Partner API bağlantısında gönderilemiyorsa, Qpien cüzdan bakiyenizi kontrol edin. Şablon mesajlar mesaj başına bir ücrete tabidir ve Qpien bakiyeniz sıfır veya yetersizse mesaj iletilmez.

Telefon Numarası Yasaklandı / Banlandı (Standart WhatsApp)

Toplu mesajlaşma için Qpien'de standart WhatsApp Web bağlantısını kullanıyorsanız, aniden tüm mesajların başarısız olduğunu ve numaranızın oturumunun kapatıldığını görebilirsiniz.

Standart WhatsApp hesapları kişisel kullanım veya düşük hacimli iş iletişimi için tasarlanmıştır. Yüksek hacimli ve aynı içerikli mesajlar gönderirseniz (toplu mesajlaşma) veya birden fazla müşteri numaranızı engeller ve spam olarak bildirirse, WhatsApp'ın otomatik sistemleri telefon numaranızı kalıcı veya geçici olarak yasaklar. Bu durum tamamen Meta'nın mobil uygulama politikaları tarafından kontrol edildiğinden, Qpien standart WhatsApp numaralarının yasağını kaldıramaz.

• WhatsApp mobil uygulamasını açın. Numaranızın yasaklandığını belirten bir mesaj göreceksiniz.

• Destek'e dokunun veya Ayarlar>Yardım>Bize Ulaşın yolunu izleyin.

• Müşterileriyle iletişim kuran meşru bir işletme olduğunuzu açıklayan kibar bir itiraz yazısı gönderin.

Bunun tekrar yaşanmasını önlemek için, yüksek hacimli ve toplu mesajlaşma kampanyaları için resmi olarak tasarlanmış ve onaylanmış WhatsApp Business API'ye geçiş yapmanızı şiddetle tavsiye ederiz.

Numara Durumu "İşaretlendi" veya "Kısıtlandı" Olarak Değişti (Business API)

Resmi API'de bile Meta, mesajlaşmanızın kalitesini izler. Kullanıcılar API mesajlarınızı sık sık engeller veya şikayet ederse, telefon numaranızın kalite derecelendirmesi "Yüksek"ten (Yeşil) "Orta"ya (Sarı) veya "Düşük" seviyeye (Kırmızı) düşer. Çok fazla düşerse, durum "İşaretlendi" (Flagged) olur ve Meta mesajlaşma sınırları getirebilir.

• Devam eden tüm toplu mesajlaşma kampanyalarını derhal durdurun.

• Alıcılar tarafından beklenen ve ilgili içerikler olduğundan emin olmak için şablon mesajlarınızı gözden geçirin.

• Müşterilerin sizden mesaj almayı açıkça kabul ettiğinden (opt-in) emin olun.

Şikayet edilmeyen daha yüksek kaliteli mesajlar gönderdikçe, kalite derecelendirmeniz birkaç gün içinde doğal olarak iyileşecektir.