Bu kılavuz, Quickchat AI Agent’ınızı WhatsApp ile nasıl entegre edeceğinizi gösterir. Süreç 2 basit adıma ayrılır:
- Adım 0 - Ön koşullar
- Adım 1 - WhatsApp’ı bağlama
Entegrasyonla ilgili sorun yaşarsanız veya yardıma ihtiyacınız olursa Sorun giderme ve SSS bölümüne gidin veya bizimle iletişime geçin.
Videoyu izleyin
Adım 0 - Ön koşullar
A. İşletme telefon numarası
WhatsApp için hangi telefon numarasını kullanacağınıza karar verin. WhatsApp dokümantasyonunda daha fazla bilgi okuyabilir veya aşağıdaki SSS’leri takip edebilirsiniz:
WhatsApp Cloud API’de hangi numara kullanılabilir?
- Doğrulama için SMS veya sesli arama alabilen ayrı bir işletme telefon numarası kullanmanız gerekir.
- Numara geçerli olmalı, size ait olmalı ve ülke ile alan kodu içermelidir.
WhatsApp Messenger’da zaten kullanılan bir numarayı kullanabilir miyim?
- Hayır. Bu numarayı aramalar ve SMS’ler için kullanmaya devam edebilirsiniz, ancak WhatsApp Messenger’da kullanamazsınız.
- Numara WhatsApp Messenger’da zaten kullanılıyorsa, önce silin. WhatsApp sohbet geçmişinizi yedeklemeyi unutmayın.
- Yasaklanmış numaraların kaydedilmeden önce yasağının kaldırılması gerekir.
WhatsApp Business App tarafından zaten kullanılan bir numarayı kullanabilir miyim?
- Evet. Numaranız şu anda WhatsApp Business App içinde kullanılıyorsa, uygulama hesabını silmeden Cloud API’ye geçirebilirsiniz. Meta dokümantasyonunda Coexistence onboarding hakkında daha fazla bilgi edinin.
Yeni bir telefon numarası kullanabilir miyim?
- Evet, mevcut numaranızı kullanmak istemiyorsanız yeni bir numara edinin (fiziksel SIM veya sanal numara). Hushed gibi hizmetlerden sanal telefon numarası satın alabilirsiniz.
B. İşletme bilgileri
Bu bilgileri hazır bulundurun (Meta entegrasyon akışı sırasında gireceksiniz):
- İşletme adı
- İşletme web sitesi
- İşletme kategorisi
- İşletme açıklaması
Bazı alanlar isteğe bağlı görünse bile doğru şekilde doldurun. Eksik veya hatalı bilgiler onayı geciktirebilir ya da hesap kısıtlamalarına neden olabilir.
Adım 1 - WhatsApp’ı bağlama
Son güncellememizden bu yana bağlantı tek tıklamayla yapılır. Artık ayrı bir ikinci adım yoktur: Meta’nın kendi Embedded Signup sihirbazı, yeni bir WhatsApp Business Account ve numara oluşturma veya mevcut olanlardan birini seçme sürecinde size yol gösterir, geri kalanını Quickchat AI tamamlar.
Quickchat AI App uygulamasını açın → External Apps → WhatsApp → Connect WhatsApp düğmesine tıklayın ve Meta açılır penceresindeki adımları izleyin:
- Meta (Facebook) hesabınıza giriş yapın.
- Quickchat AI ile paylaşacağınız izinleri (WhatsApp Business hesabı erişimi ve Business portfolio erişimi) gözden geçirin ve devam edin.
- Doğru işletme bilgilerini girin (Business Portfolio, Business Name, Business Website, Country vb.).
- WhatsApp Business Account oluşturun veya seçin.
- Bir WhatsApp Business görünen adı ve kategorisi seçin.
- İşletme telefon numaranızı ekleyin ve istendiği şekilde SMS/sesli arama ile doğrulayın.
- Quickchat AI’a gerekli erişimi vermek için Confirm düğmesine tıklayın.
- Meta kurulumun tamamlandığını onayladığında Finish düğmesine tıklayın. Açılır pencere, WhatsApp hesabınızın bağlandığını belirten bir Quickchat AI onayı gösterir ve otomatik olarak kapanır.
Quickchat AI App’e döndüğünüzde, WhatsApp paneli Connecting your WhatsApp account durumunu gösterir ve yaklaşık 30 saniye içinde Connected durumuna güncellenir. Güncellenmezse panelde Refresh Status düğmesine tıklayın. Aksi durumda, işletme telefon numaranızı ve bilgilerinizi doğru verdiğinizden emin olmak için lütfen yukarıdaki Ön koşullar bölümünü tekrar kontrol edin.
Connected, Quickchat AI’ın WhatsApp Business Account hesabınıza erişebildiği anlamına gelir. Panelde hemen altında, müşterilerin yanıt alması için hâlâ gerekenler gösterilir:
Connected paneli kalanları listeler: burada ilk mesaj
- Waiting for your first message: başka bir telefondan gösterilen numaraya bir WhatsApp mesajı gönderin, ardından Refresh düğmesine tıklayın. Bir mesaj ulaştığında panelde Webhook Active ve Admin Assigned yanında Messages Received gösterilir.
- Display name: panelin alt kısmında listelenen her numara, Meta’daki görünen ad durumunu taşır (Approved, Pending review, Declined, Expired veya No display name). Devam eden bir inceleme sizden işlem gerektirmez ve genellikle birkaç gün içinde tamamlanır. Reddedilmiş, süresi dolmuş veya eksik görünen ad, WhatsApp Manager üzerinden bir ad göndermenizi gerektirir.
- Meta test number: aktif numara Meta tarafından sağlanan +1 555 numarasıysa panel bunu belirtir. Bu numaralar deneme amaçlıdır ve başka bir hesaba taşınamaz. Yayına geçmek için WhatsApp Manager içinde kendi numaranızı ekleyin.
Panel Messages Received gösterdiğinde yayındasınız! 🎉 Müşteriler WhatsApp numaranıza mesaj gönderebilir ve AI Agent’ınız otomatik olarak yanıt verir.
Entegrasyonunuzu son kez doğrulamak için az önce bağladığınız WhatsApp numarasına bir kısa mesaj gönderin, ardından panelde Refresh düğmesine tıklayın. Waiting for your first message, Messages Received durumuna dönüşür, AI Agent’ınızdan yanıt almalısınız ve konuşma Quickchat AI App Inbox içinde görünmelidir. Meta kurulum adımlarından herhangi birini tamamlamadan bırakırsanız Quickchat AI, kalan adımları hatırlatma olarak hesap sahibine e-posta ile de gönderir.
Sorun giderme ve SSS
WhatsApp Business API fiyatlandırması nasıl çalışır?
- Kullanıcı tarafından başlatılan (gelen) müşteri sorularına verilen yanıtlar, WhatsApp tarafından Service messages olarak değerlendirilir. Bu mesajlar, işletmelerin gelen müşteri sorularını insan temsilci veya konuşma tabanlı AI destekli bot üzerinden yönetmesini sağlar.
- Kullanıcılar bir işletmeye mesaj gönderdiğinde, işletmelerin service messages ile ücret ödemeden yanıt verebildiği 24 saatlik müşteri hizmetleri penceresi açılır. Bu pencere her kullanıcı mesajıyla sıfırlanır.
- 24 saatin dışında, onaylı Message Templates (Marketing, Utility, Authentication vb.) kullanmanız ve WhatsApp Business Platform Message Rates uyarınca mesaj başına ödeme yapmanız gerekir.
- Konuşmalar Meta tarafından kategorilere ayrılır ve ücretlendirilir. WhatsApp Business Account hesabınızda işletme tarafından başlatılan/şablon mesajlar için geçerli bir ödeme yöntemi olduğundan emin olun.
Connect WhatsApp düğmesi çalışmıyor. Meta açılır penceresini görmüyorum.
- Tarayıcınız açılır pencereyi engelliyorsa uygulama açılır pencerelere izin vermenizi isteyen bir mesaj gösterir. Tarayıcınızda açılır pencere ve izleyici engelleyicilerini devre dışı bırakın, web sitesini yenileyin ve tekrar deneyin. Yardımcı olmazsa farklı bir tarayıcı deneyin.
Numara doğrulaması başarısız oldu.
- Numaranın SMS/sesli arama alabildiğinden ve Meta’nın birlikte var olmasına izin vermediği aktif bir kayıt yolu tarafından engellenmediğinden emin olun. Numara Business App içinde kullanılıyorsa Coexistence ile onboarding deneyin.
Meta kurulumumun tamamlanmadığını söylüyor veya panel uyarı gösteriyor.
- Önce Connected altındaki kartı okuyun: AI Agent’ınızın hangi numarada yanıt verdiğini belirtir ve Meta’nın görünen adı hâlâ inceleyip incelemediğini, bunun bir Meta test numarası olup olmadığını veya ilk mesajın henüz gelip gelmediğini söyler. Her kart WhatsApp Manager içindeki doğru yere bağlantı verir.
- Uyarı bağlantının kendisiyle ilgiliyse panelde Reconnect WhatsApp düğmesine tıklayın. Bu, çoğu durumu çözer.
- Çözmezse numaranız başka bir sağlayıcıya bağlı olabilir (Meta, bir WhatsApp hesabı için aynı anda yalnızca bir iş ortağına izin verir). Quickchat AI’ı Meta Business ayarlarında iş ortağı olarak eklemek için ekrandaki talimatları izleyin, ardından Refresh Status düğmesine tıklayın.
Yanlış hesabı bağladım.
- Reconnect, zaten bağlı olan hesabı korur. Geçiş yapmak için WhatsApp panelinde Disconnect düğmesine, ardından tekrar Connect WhatsApp düğmesine tıklayın ve Meta penceresinde doğru Meta Business hesabını ve WhatsApp Account hesabını seçin.
Mesajlar Quickchat AI Inbox içinde görünmüyor.
- Açılır pencerenin WhatsApp hesabınızın bağlandığına dair son onayı gösterdiğini doğrulayın.
- Amaçladığınız WhatsApp Account hesabını bağladığınızı ve doğru AI Agent’ın seçili olduğunu yeniden kontrol edin.
- Waiting for your first message kartı, AI Agent’ınızın hangi numarada yanıt verdiğini belirtir. Tam olarak o numaraya mesaj gönderdiğinizden ve panelde açık olduğundan emin olun, ardından Refresh düğmesine tıklayın.
- Bir kullanıcı mesajı olmadan 24 saatten sonra mesaj gönderiyorsanız onaylı şablonlar kullanın ve WhatsApp Manager içinde bir ödeme yönteminin ayarlı olduğundan emin olun.
AI’ımın WhatsApp yanıtları gönderilemiyor.
- Quickchat AI, WhatsApp panelinde “WhatsApp replies are failing” uyarısını ve dashboard’unuzda bir bildirim gösterir. Yaygın çözümler: WhatsApp Manager içinde görünen ad onayını tamamlayın; bağlantı süresi dolduysa veya iptal edildiyse Reconnect düğmesine tıklayın; Meta kalite veya politika nedeniyle numaranızı kısıtladıysa durumunu WhatsApp Manager içinde kontrol edin. Bir yanıt yeniden başarıyla gönderildiğinde uyarı temizlenir.
Şablon veya işletme tarafından başlatılan mesajlar başarısız oluyor.
- Message Templates öğelerinizin onaylı olduğunu ve ödeme yönteminizin WhatsApp Manager içinde aktif olduğunu doğrulayın.
- Yeni göndericiler, kalite ve doğrulamaya göre ölçeklenen mesajlaşma limitleri ile başlar. İşletme tarafından başlatılan mesajlaşmada limitlere ulaşırsanız Meta’nın Messaging Limits kılavuzunu inceleyin.
- Teslimat kısıtlanıyorsa WhatsApp Manager içinde mesajlaşma limitlerini ve kalite puanını kontrol edin.
Kendi WhatsApp bağlantımı ve “Chat on WhatsApp” düğmemi nasıl oluştururum?
- Bu WhatsApp öğreticisini takip edin.
Kendi WhatsApp QR kodumu nasıl oluştururum?
- WhatsApp Manager → Phone numbers → işletme telefon numaranızı seçin → Message links → Create Message Link bölümüne gidin.
- Alternatif olarak bunu WhatsApp Business mobil uygulamanızda bulabilirsiniz. Bu WhatsApp öğreticisini takip edin.
Yardıma mı ihtiyacınız var?
WhatsApp’ta Quickchat Support AI ile sohbet edin:
📱 +1 302-405-9992: Sohbet başlatın
Veya QR kodunu tarayın:
