WhatsApp

Bu rehber, Quickchat AI Agent’ınızı WhatsApp ile nasıl entegre edeceğinizi gösterir. İşlem 2 basit adımdan oluşur:

• Adım 0: gereksinimler
• Adım 1: WhatsApp’ı bağlama

Entegrasyonda sorun yaşıyorsanız veya yardıma ihtiyacınız varsa Sorun giderme ve sık sorulan sorular bölümüne bakın veya bizimle iletişime geçin.

İsteğe bağlı kurulum araçları

• WhatsApp kurulum gereksinimlerini kontrol edin. Belirttiğiniz numara ve sağlayıcı bilgilerini belgelenmiş kurulum gereksinimleriyle karşılaştırın. Bu araç WhatsApp hesabına erişmez veya hesap bağlamaz.

• WhatsApp hizmet penceresini kontrol edin. Saat dilimi farklarını içeren, sağladığınız gelen mesaj ve yanıt zamanlarına göre 24 saatlik pencereyi kontrol edin. Bu araç şablonları, onayı veya hesap izinlerini doğrulamaz ve mesaj göndermez.

• Kullanım maliyetlerini tahmin edin. Quickchat AI model kredilerini ve sağladığınız ücret kalemlerinin toplamını ayrı ayrı hesaplayın. Bu araç sağlayıcı tarifelerini aramaz, kredilerle parayı birleştirmez veya hesabınızı kontrol etmez.

Videoyu izleyin

Play

Adım 0: gereksinimler

A. İşletme telefon numarası

WhatsApp için hangi telefon numarasını kullanacağınıza karar verin. WhatsApp belgelerinden daha fazla bilgi edinebilir veya aşağıdaki sık sorulan soruları okuyabilirsiniz:

WhatsApp Cloud API’de hangi numara kullanılabilir?

• Doğrulama için SMS veya sesli arama alabilen, işletmeye özel bir telefon numarası kullanmalısınız.
• Numara geçerli, size ait ve ülke kodu ile alan kodu içeren bir numara olmalıdır.

WhatsApp Messenger’da zaten kullanılan bir numarayı kullanabilir miyim?

• Hayır. Numarayı arama ve SMS için kullanmaya devam edebilirsiniz, ancak WhatsApp Messenger’da kullanamazsınız.
• Numara WhatsApp Messenger’da kullanılıyorsa önce oradan silin. WhatsApp sohbet geçmişinizi yedeklemeyi unutmayın.
• Yasaklanmış numaraların kayıt öncesinde yasağı kaldırılmalıdır.

WhatsApp Business App’te zaten kullanılan bir numarayı kullanabilir miyim?

• Quickchat AI’ın mevcut bağlantı akışı, var olan bir WhatsApp Business App numarası için doğrulanmış bir Coexistence yolu sunmaz. Meta, desteklenen entegrasyonlarda birlikte kullanımın nasıl çalıştığını Business App başlangıç rehberinde açıklar.
• Mevcut numaranızı, Business App hesabınızı ve sohbet geçmişinizi korumanız gerekiyorsa devam etmeden önce support@quickchat.ai adresine yazın. Sorun gidermek amacıyla Business App hesabını silmeyin veya bağlantısını kesmeyin; numarayı taşımayın.

Yeni bir telefon numarası kullanabilir miyim?

• Evet. Mevcut numaranızı kullanmak istemiyorsanız yeni numara alın (fiziksel SIM veya sanal numara). Hushed gibi hizmetlerden sanal telefon numarası satın alabilirsiniz.

B. İşletme bilgileri

Şu bilgileri hazır bulundurun; Meta entegrasyon akışında girmeniz gerekecektir:

• İşletme adı
• İşletme web sitesi
• İşletme kategorisi
• İşletme açıklaması

Dikkat

Bazı alanlar isteğe bağlı görünse bile doğru bilgilerle doldurun. Eksik veya yanlış bilgiler onayı geciktirebilir ya da hesap kısıtlamalarına yol açabilir.

Adım 1: WhatsApp’ı bağlama

Quickchat AI uygulamasını açın → External Apps → WhatsApp → Connect WhatsApp düğmesine tıklayın ve Meta penceresindeki adımları izleyin:

ChatGPT, Claude veya bağlı başka bir AI uygulamasından da başlayabilirsiniz: bu Agent’ı WhatsApp’a bağlamak için bağlantı isteyin. Bağlantı 10 dakika geçerlidir ve yalnızca onu isteyen Quickchat hesabı için bir kez çalışır. O hesaba giriş yapılmış bir tarayıcıda açın, Meta kurulumunu izleyin ve Quickchat yeniden açıldığında gösterilen hesap veya telefon seçimini tamamlayın. Ardından AI uygulamanızdan kurulumu kontrol etmesini isteyin ve AI yanıtının ulaştığını doğrulamak için gerçek bir WhatsApp mesajı gönderin. Birden fazla numara bağladıysanız her etkin numarayı test edin. Meta erişimini tarayıcıda onaylarsınız; sohbette token paylaşmazsınız.

1. Meta (Facebook) hesabınıza giriş yapın.
2. Quickchat AI ile paylaşacağınız izinleri (WhatsApp Business hesabı ve işletme portföyü erişimi) inceleyip devam edin.
3. Doğru işletme bilgilerini girin (işletme portföyü, işletme adı, web sitesi, ülke vb.).
4. WhatsApp Business hesabınızı oluşturun veya seçin.
5. WhatsApp Business için görünen ad ve kategori seçin.
6. İşletme telefon numaranızı ekleyin ve istendiği şekilde SMS veya sesli aramayla doğrulayın.
7. Quickchat AI’a gerekli erişimi vermek için Confirm düğmesine tıklayın.
8. Meta kurulumun tamamlandığını onayladığında Finish düğmesine tıklayın. Pencerede WhatsApp hesabınızın bağlandığını belirten Quickchat AI onayı görünür; pencere otomatik kapanır.

Meta, Quickchat AI’a birden fazla hesap için erişim verirse WhatsApp paneli hemen bağlanmak yerine Choose your WhatsApp Business Account gösterir. AI Agent’ın yanıt vermesi gereken hesabı seçip Use this account düğmesine tıklayın. Yeniden bağlanıyorsanız mevcut WhatsApp ayarlarınız siz onaylayana kadar değişmez.

Quickchat AI uygulamasına döndüğünüzde WhatsApp paneli, kendi işletme numaranızda başarılı bir mesaj alışverişi doğrulanana kadar Finish setup gösterir. Panel yaklaşık 30 saniye sonra güncellenmemişse yenileme simgesine tıklayın.

Meta’ya bağlanmak ve bir mesaj almak kurulumun yalnızca bir kısmıdır. Panel, her etkin numara için sonraki adımı gösterir:

• Waiting for your first message: başka bir telefondan gösterilen numaraya WhatsApp mesajı gönderip Refresh düğmesine tıklayın. Müşterilerinizin kullanacağı işletme numarasına yazdığınızdan emin olun.
• Waiting for the AI reply to be delivered: Quickchat mesajınızı aldı, ancak WhatsApp AI yanıtının teslimini henüz onaylamadı. Yanıtın diğer telefona ulaşıp ulaşmadığını kontrol edin. Ulaşmadıysa AI kredilerinizi ve paneldeki uyarıları kontrol edip başka bir test mesajı gönderin.
• AI reply delivered: WhatsApp, bu işletme numarasında gelen bir mesaja verilen AI yanıtının teslim edildiğini doğruladı.
• Verification needs attention: bağlantı uyarılarını giderin, kullanmak istediğiniz numarayı etkin tutun ve yeni bir test mesajı gönderin.
• Display name: panelin aşağısındaki her numara Meta’dan gelen görünen ad durumunu taşır (Approved, Pending review, Declined, Expired veya No display name). Devam eden inceleme sizden işlem gerektirmez ve genellikle birkaç günde tamamlanır. Reddedilmiş, süresi dolmuş veya eksik bir ad için WhatsApp Manager üzerinden ad göndermeniz istenir.
• Meta test number: Meta’nın sağladığı +1 555 numaraları ve deneme ortamı numaraları, işletme numaranızın etkinleştiğini doğrulamaz. WhatsApp Manager’da kendi numaranızı ekleyin, Quickchat’te açın ve o numarayı test edin.

Panel, etkin her işletme numarasında doğrulanmış mesaj alışverişi olduğunda ve bağlantı kontrolleri sorunsuz olduğunda Live gösterir. Birden fazla işletme numarasını açtıysanız her birini test edin. Test numarasıyla başarılı mesaj alışverişi, gönderilmiş şablon veya mesaj kotası bildirimi bu kontrolü tamamlamaz.

İpucu

Test sırasında entegrasyonu açık tutun. Başka bir telefondan kullanacağınız her işletme numarasına mesaj gönderin, AI yanıtının ulaştığını doğrulayıp Refresh düğmesine tıklayın. Konuşma Quickchat AI uygulamasının Inbox bölümünde de görünmelidir. Mevcut bir bağlantı, teslimi doğrulamak için yeni bir test alışverişi isteyebilir. Bu adımı tamamlarken mesaj alıp yanıtlamaya devam edebilir.

Meta’da kalan başlangıç adımları varsa Setup guidance bölümünü açarak WhatsApp Manager içinde tamamlayın. Meta kurulumu bitmemişse Quickchat AI hesap sahibine e-postayla hatırlatma da gönderir.

Sorun giderme ve sık sorulan sorular

WhatsApp Business API fiyatlandırması nasıl çalışır?

• Kullanıcıların başlattığı (gelen) müşteri sorularına verilen yanıtları WhatsApp hizmet mesajı olarak değerlendirir. İşletmeler bu mesajlarla gelen müşteri sorularını bir çalışan veya konuşma odaklı AI botu üzerinden yönetebilir.
• Kullanıcı bir işletmeye mesaj gönderdiğinde 24 saatlik müşteri hizmetleri penceresi açılır. İşletmeler bu sürede hizmet mesajlarıyla ücretsiz yanıt verebilir. Pencere her kullanıcı mesajında yeniden başlar.
• 24 saat dolduktan sonra onaylı mesaj şablonları (Marketing, Utility, Authentication vb.) kullanmalı ve WhatsApp Business Platform mesaj tarifelerine göre mesaj başına ödeme yapmalısınız.
• Konuşmaları Meta sınıflandırır ve faturalandırır. İşletmenin başlattığı veya şablon kullanan mesajlar için WhatsApp Business hesabınızda geçerli ödeme yöntemi bulunduğundan emin olun.

Connect WhatsApp düğmesi çalışmıyor. Meta penceresini görmüyorum.

• Tarayıcı açılır pencereyi engelliyorsa Quickchat AI uygulaması için açılır pencerelere izin verip Try again düğmesine tıklayın. Aynı kurulumu açılır pencere olmadan tamamlamak için Continue on Meta in this tab seçeneğini de kullanabilirsiniz.

Quickchat couldn’t confirm the WhatsApp connection

Meta penceresi sonuç döndürmediğinde ve Quickchat bağlantıyı hâlâ doğrulayamadığında bu kurtarma mesajı görünür. Bu, Meta’nın hiçbir değişiklik yapmadığını kanıtlamaz.

1. WhatsApp Business hesabının sahibi olan Meta işletmesinde yönetici olduğunuzu doğrulayın. Değilseniz bir yöneticiden kendi Facebook girişiyle bağlamasını isteyin.
2. Try again düğmesine tıklayın. Bir engelleyici Meta penceresine müdahale ediyorsa uzantıları duraklatılmış özel bir pencere kullanın veya Continue on Meta in this tab seçeneğine tıklayın.
3. Numara WhatsApp Messenger’da etkinse önce oradan kaldırın veya başka numara kullanın. WhatsApp Business App’te etkinse burada durun ve devam etmeden önce support@quickchat.ai adresine yazın. Quickchat AI’ın mevcut bağlantı akışı doğrulanmış Coexistence yolu sunmaz. Bu mesajı gidermek için Business App hesabını silmeyin veya bağlantısını kesmeyin; numarayı taşımayın.
4. WhatsApp Business hesabı Aircall, Twilio, 360dialog, MessageBird veya başka bir sağlayıcı kullanıyorsa Meta Business Settings’te Quickchat AI’ı ortak olarak ekleyin:
   1. Meta Business Settings bölümünü açıp Accounts → WhatsApp Accounts yolunu izleyin.
   2. WhatsApp Business hesabını seçin, Partners bölümünü açıp Add Partners düğmesine tıklayın.
   3. Quickchat AI’ın Business ID değerini girin: 270696274483463.
   4. Manage WhatsApp accounts iznini verin, Quickchat AI’a dönüp durumu yenileyin.

Diğer sağlayıcıyı yalnızca Meta aynı hesapta iki ortağa izin vermiyorsa ayırın. Emin değilseniz etkin bir mesajlaşma sağlayıcısının bağlantısını kesmeden önce destekle iletişime geçin.

Numara doğrulaması başarısız oldu.

• Numaranın SMS veya sesli arama alabildiğinden emin olun.
• Genel bir Ineligible mesajı veya This number can’t be shared with this app ipucu, nedeni ya da Meta’nın birlikte kullanım gereksinimlerinin karşılanıp karşılanmadığını göstermez. Tam mesajı ve göründüğü adımı support@quickchat.ai adresine gönderin.
• Numara WhatsApp Business App içinde kullanılıyorsa ve hesabı ve geçmişini korumanız gerekiyorsa devam etmeden önce destekle iletişime geçin. Hatayı gidermek için hesabı silmeyin veya bağlantısını kesmeyin; numarayı taşımayın.

Yanlış hesabı bağladım.

• Reconnect, zaten bağlı olan hesabı korur. AI Agent’ı farklı bir WhatsApp Business hesabına taşımak için WhatsApp panelinde Disconnect, ardından yeniden Connect WhatsApp düğmesine tıklayın. Meta penceresinde doğru Meta Business hesabını ve WhatsApp hesabını seçin.

We could not tell which WhatsApp Business Account to connect

• Meta girişinizde telefon numarası olan birden fazla WhatsApp Business hesabı vardır ve Quickchat hangisini istediğinizi belirleyememiştir. Bağlamak istediğiniz numarayla birlikte support@quickchat.ai adresine yazın; kurulumu sizin için tamamlayalım.

Mesajlar Quickchat AI Inbox içinde görünmüyor.

• Açılır pencerede son onay mesajının göründüğünü doğrulayın: “WhatsApp account connected!”.
• İstediğiniz WhatsApp hesabını bağladığınızı ve doğru AI Agent’ın seçili olduğunu tekrar kontrol edin.
• Waiting for your first message kartı, AI Agent’ın yanıt verdiği numarayı belirtir. Tam olarak o numaraya mesaj gönderdiğinizden ve numaranın panelde açık olduğundan emin olun; ardından Refresh düğmesine tıklayın.
• Kullanıcıdan mesaj gelmeden 24 saat sonrasında mesaj gönderiyorsanız onaylı şablonlar kullanın ve WhatsApp Manager içinde ödeme yöntemi ayarlı olduğundan emin olun.

AI’ın WhatsApp yanıtları gönderilemiyor.

AI yanıtları teslim edilemiyorsa Quickchat AI, External Apps içindeki WhatsApp panelinde “WhatsApp replies are failing” uyarısı ve ana panelde bildirim gösterir. En sık görülen nedenler ve çözümleri:

• Meta test numarasının görünen adı onaylanmamış: Meta, sağladığı +1 555 numarasından gelen yanıtları görünen ad onaylanana kadar bekletir. Paneldeki görünen ad uyarısı kırmızı olur ve numarayı belirtir. İncelemenin tamamlanmasını bekleyin (genellikle birkaç gün sürer). Reddedildiyse WhatsApp Manager üzerinden yeni ad gönderip ardından test mesajı gönderin. Kendi numaranızda henüz incelenen bir görünen ad tek başına yanıtları engellemez; panel bunu not olarak gösterir.
• Bağlantının süresi dolmuş veya erişimi iptal edilmiş: WhatsApp bağlantısı artık geçerli değildir. Yanıt göndermeye devam etmek için WhatsApp panelini açıp Reconnect düğmesine tıklayın.
• Numara kısıtlanmış: Meta, kalite puanı veya politika sorunu nedeniyle numaranızı sınırlandırmıştır. Gönderimi yeniden açmak için WhatsApp Manager içindeki durumunu kontrol edin.
• Business hesabı kilitlenmiş (hata 131031): Meta, WhatsApp Business hesabının yanıtlarını engellemiştir. Inbox teslim hatası ve WhatsApp paneli kısıtlamayı açıklar. Business Support Home sayfasını açın, WhatsApp hesabını ve ihlali seçip Request Review düğmesine tıklayın. Meta hesap kilidini yalnızca bu inceleme üzerinden kaldırır. Quickchat’i yeniden bağlamak kısıtlamayı kaldırmaz.

Diğer uyarılar, bir yanıt yeniden başarıyla gönderildiğinde otomatik temizlenir. Hesap kilidi uyarısı, gerçek bir ziyaretçinin yeni mesajına verilen AI yanıtı tamamen teslim edilene kadar kalır. Çünkü Meta yanıtı kabul edip daha sonra başarısız sayabilir. Yalnızca Meta test numaraları (+1 555) etkinse sonraki başarılı AI yanıtı gönderimi uyarıyı temizler. Support AI yakın zamanda kaydedilmiş bir hesap kilidi hatasını da açıklayabilir; ancak geçmiş kayıtlar hesabın hâlâ kilitli olduğunu kanıtlamaz.

Şablon mesajları veya işletmenin başlattığı mesajlar başarısız oluyor.

• WhatsApp Manager içinde mesaj şablonlarının onaylı ve ödeme yönteminin etkin olduğunu doğrulayın.
• Yeni gönderenler kalite ve doğrulamaya göre artan mesajlaşma sınırlarıyla başlar. İşletmenin başlattığı mesajlarda sınıra ulaşırsanız Meta’nın Messaging Limits rehberine bakın.
• Teslim kısıtlanıyorsa WhatsApp Manager içinde mesajlaşma sınırlarını ve kalite puanını kontrol edin.

Kendi WhatsApp bağlantımı ve “Chat on WhatsApp” düğmemi nasıl oluştururum?

• Bu WhatsApp rehberini izleyin.
• Veya WhatsApp markalı düğme tasarımlarını indirin ve sayfanızda şu kodlardan birini kullanın:

<!-- WhatsApp inline button -->
<!-- Update WHATSAPP_PHONE_NUMBER and filename/path as needed -->
<a
  aria-label="Chat on WhatsApp"
  href="https://wa.me/WHATSAPP_PHONE_NUMBER"
  target="_blank"
  rel="noopener noreferrer"
>
  <img
    alt="Chat on WhatsApp"
    src="WhatsAppButtonGreenLarge.svg"
    style="
      width: 200px;
      height: auto;
      cursor: pointer;
      border-radius: 12px;
    "
  />
</a>

veya

<!-- WhatsApp floating button -->
<!-- Update WHATSAPP_PHONE_NUMBER and filename/path as needed -->
<a
  aria-label="Chat on WhatsApp"
  href="https://wa.me/WHATSAPP_PHONE_NUMBER"
  target="_blank"
  rel="noopener noreferrer"
  style="position: fixed; right: 20px; bottom: 20px; z-index: 9999"
>
  <img
    alt="Chat on WhatsApp"
    src="WhatsAppButtonGreenLarge.svg"
    style="
      width: 200px;
      height: auto;
      cursor: pointer;
      border-radius: 12px;
      box-shadow: rgba(0, 0, 0, 0.5) 0px 5px 15px 0px;
      transition: all 0.3s ease;
    "
    onmouseover="this.style.transform = 'scale(1.05)'"
    onmouseout="this.style.transform = 'scale(1)'"
  />
</a>

Kendi WhatsApp QR kodumu nasıl oluştururum?

• WhatsApp Manager → Phone numbers → işletme numaranızı seçin → Message links → Create Message Link yolunu izleyin.
• Alternatif olarak WhatsApp Business mobil uygulamasında da bulabilirsiniz. Bu WhatsApp rehberini izleyin.

Kurulumu düzeltmek için WhatsApp Business App hesabımın bağlantısını kesmeli miyim?

• Hayır. Sorun giderme adımı olarak Business App hesabını silmeyin veya bağlantısını kesmeyin; numarasını taşımayın. Quickchat AI’ın mevcut bağlantı akışı, mevcut uygulama ayarlarınızı ve geçmişinizi koruyan doğrulanmış bir Coexistence yolu sunmaz.
• Etkin bir Business App hesabını değiştirmeden önce support@quickchat.ai adresine yazın. Meta’nın Business App başlangıç rehberi, desteklenen entegrasyonlarda birlikte kullanımı açıklar; Quickchat AI kurulumunuzda kullanılabildiğini doğrulamaz.

Quickchat AI, WhatsApp Business hesabımıza hangi erişimi alır?

• Sınırlı API erişimi alır, hesabın sahibi olmaz. WhatsApp Business hesabınız (WABA) kendi Meta Business Manager’ınızda kalır. Meta’nın WABA Sharing modelinde varlıklar size aittir; Quickchat AI, Business Manager’dan istediğiniz zaman erişimini kaldırabileceğiniz bir ortak olarak eklenir.
• Entegrasyon etkinken Cloud API üzerinden mesaj gönderip alabilir ve webhook üzerinden mesaj olaylarını alabiliriz.
• Hesabınızı kapatamaz, devredemez veya marka kimliğini değiştiremeyiz; faturalandırmayı değiştiremez veya yöneticilerinizi kaldıramayız.

Yardıma mı ihtiyacınız var?

WhatsApp’ta Quickchat Support AI ile konuşun:
📱 +1 302-405-9992: Sohbet başlatın

Ya da QR kodunu tarayın: