Bu rehber; Supsis Ai üzerinden WhatsApp Business API, WhatsApp Business API v2 ve WhatsApp V3 QR kurulum süreçlerini standart hale getirmek, kurulum toplantılarında yaşanan sorunlara hızlı çözüm sunmak ve sürdürülebilir bir bilgi kaynağı oluşturmak amacıyla hazırlanmıştır.
İlgili dokümanlar:
| Doküman | Ne zaman kullanılır? |
|---|---|
| WhatsApp Business API Entegrasyonu | Modül aktivasyonu, panel adımları, ekran görüntülü numara bağlama, ürün özellikleri |
| Meta Business Doğrulama Rehberi | Business Verification, evrak, opt-in, mesaj kalitesi, kısıtlama ve itiraz |
1-) WhatsApp Business'a Genel Bakış
WhatsApp Business Platform Nedir?
WhatsApp Business Platform (WABA), işletmelerin müşterileriyle WhatsApp üzerinden profesyonel şekilde iletişim kurmasını sağlayan Meta altyapısıdır.
Supsis Ai üzerinde WABA entegrasyonu sayesinde:
- Müşteri mesajları tek panelden yönetilebilir.
- Chatbot ve yapay zekâ otomasyonları kullanılabilir.
- Canlı destek ekipleri aynı panel üzerinden çalışabilir.
- Toplu mesaj gönderimleri gerçekleştirilebilir.
- CRM ve otomasyon sistemleri ile entegre çalışabilir.
Detaylı panel ve entegrasyon adımları için WhatsApp Business API Entegrasyonu dokümanını inceleyebilirsiniz.
WABA terminolojisi
| Terim | Açıklama |
|---|---|
| WABA | WhatsApp Business Account |
| Cloud API | Meta'nın resmi API altyapısı. Bağlı numara yalnızca Supsis panelden yönetilir; telefon uygulamasında aynı numara kullanılamaz. |
| Coexistence (CoEx) | WhatsApp Business mobil uygulaması ile Supsis panelinin aynı numarada eşzamanlı kullanılabildiği yapı |
| Business Manager | Meta Business hesabı (business.facebook.com) |
| Embedded Signup | Meta üzerinden gerçekleştirilen hızlı kurulum yöntemi |
| Provider | WABA altyapısını sağlayan servis sağlayıcı (ör. Gupshup, Supsis) |
2-) Kurulum Öncesi Gereksinimler
2.a – Müşteriden talep edilecek bilgiler
Kuruluma başlamadan önce mümkün olduğunca aşağıdaki bilgiler doğrulanmalıdır.
Telefon bilgileri
- Bağlanacak telefon numarası
- İşlemi gerçekleştirecek kişinin telefon numarası
- Telefon cihazı toplantı sırasında yanında mı?
- SMS veya arama doğrulamasına erişim mevcut mu?
- Telefon numarası Normal WhatsApp mı yoksa WhatsApp Business mı kullanıyor?
Meta bilgileri
- Meta hesabı mevcut mu?
- İşlemi yapan kullanıcı Business Manager üzerinde tam yetkili mi?
- Facebook hesabı mevcut mu?
- Facebook Sayfası mevcut mu?
- Meta Business hesabı oluşturulmuş mu?
- İşletme bilgileri eksiksiz tanımlanmış mı?
API tercihi
Kuruluma başlamadan önce müşterinin kullanım senaryosuna uygun API yapısı belirlenmelidir. Karar için 4-) API Tercihleri bölümünü inceleyin.
2.b – Kurumsal evraklar (işletme doğrulaması)
İşletme doğrulaması yapılacaksa aşağıdaki belgeler hazır olmalıdır:
- Vergi levhası veya kuruluş belgesi
- Su / elektrik / doğalgaz / internet faturası
Not: İşletme doğrulaması (Business Verification) kurulum için zorunlu değildir; kanal bağlantısı doğrulanmamış işletme ile de tamamlanabilir. Ancak hesap güveni, Meta incelemeleri ve toplu mesaj / yüksek hacimli gönderim açısından doğrulama gerekli sayılabilir. Doğrulanmamış hesaplarda toplu mesaj gönderimi ve daha yüksek limitler pratikte kullanılamayabilir; ban veya kısıtlama riskini azaltmak için Meta Business Doğrulama Rehberi adımlarının tamamlanması önerilir.
3-) Kurulum Seçenekleri
Supsis Ai üzerinde üç farklı WhatsApp entegrasyon modeli bulunmaktadır:
- WhatsApp Business API (Gupshup provider)
- WhatsApp Business API v2 (Supsis provider)
- WhatsApp V3 QR
Not: Hiçbir modelde WhatsApp Kanallar veya duyuru yönetimi gibi özellikler bulunmaz.
Karşılaştırma ve panel özellikleri için WhatsApp Business API Entegrasyonu — Entegrasyon çözümleri bölümüne bakabilirsiniz.
3.1 – WhatsApp Business API (Gupshup provider)
Nasıl çalışır?
WABA hesabı Gupshup altyapısı üzerinden oluşturulur. Müşteri ödeme yöntemini Supsis Ai sistemine tanımlar; servis sağlayıcı olarak Gupshup kullanılır.
Mimari
Hangi senaryolarda tercih edilmeli?
- Gupshup sağlayıcısını kullanmakta sorun görmeyen müşteriler
- Ödeme yöntemini Supsis Ai üzerinden tanımlamak isteyen müşteriler
Avantajları
- Gupshup altyapısı kullanılır
- Ödeme yöntemi Supsis Ai üzerinden yönetilir
- Meta tarafında ayrıca ödeme yöntemi tanımlanması gerekmez
Ücretlendirme mantığı
| Alan | Değer |
|---|---|
| Servis sağlayıcı | Gupshup |
| Ödeme yöntemi | Supsis Ai (cüzdan) |
WhatsApp Business Platform'da ücretlendirme mesaj kategorisine ve alıcının ülkesine göre değişir. Güncel tahmin için Supsis WABA Pricing aracını kullanabilirsiniz. Meta tarifesi: Platform Pricing.
1 Ekim 2026 itibarıyla önemli değişiklik (Meta):
- Service mesajları 24 saatlik müşteri hizmetleri penceresi içinde artık ücretsiz olmayacaktır.
- Service mesajları mesaj başına ücretlendirilecektir.
- Service mesajlarının birim fiyatı, ilgili pazardaki Utility ve Authentication mesajlarıyla aynı seviyede olacaktır.
- 24 saatlik pencere içinde gönderilen Utility şablon mesajları da ücretli olacaktır.
İlgili sorunlar: 6-) Kurulum hataları
3.2 – WhatsApp Business API v2 (Supsis provider)
Nasıl çalışır?
WABA hesabı Supsis Ai altyapısı üzerinden oluşturulur. Müşteri ödeme yöntemini doğrudan Meta Business hesabına tanımlar.
Mimari
Hangi senaryolarda tercih edilmeli?
- WhatsApp Business bağlantısında Supsis sağlayıcısını kullanmak isteyen müşteriler
- Ödeme yöntemini doğrudan Meta Business hesabında tanımlamak isteyen müşteriler
- Gupshup yerine Supsis altyapısını tercih eden müşteriler
Avantajları
- Supsis provider olarak çalışır
- Ödeme yöntemi doğrudan Meta Business üzerinden yönetilir
- Gupshup sağlayıcısına ihtiyaç duyulmaz
- Supsis WhatsApp entegrasyon altyapısıyla doğrudan çalışır
Ücretlendirme mantığı
| Alan | Değer |
|---|---|
| Servis sağlayıcı | Supsis Ai |
| Ödeme yöntemi | Meta Business |
Fiyatlandırma notları ve 1 Ekim 2026 değişiklikleri WhatsApp Business API bölümündeki tablo ile aynıdır.
İlgili sorunlar: 6-) Kurulum hataları
3.3 – WhatsApp V3 QR
Not: QR çözümü genellikle önerilmez. Meta Business ile resmi bağlantı olmadığı için ban riski vardır. Uzun vadeli ve kurumsal kullanım için WhatsApp Business API veya WhatsApp Business API v2 tercih edilmelidir.
Nasıl çalışır?
WhatsApp Web mantığında QR kod okutularak bağlantı kurulur. Resmi WhatsApp Business Platform entegrasyonu değildir.
Mimari
WhatsApp Web → QR Kod → Supsis Ai
Avantajları
- QR kod ile hızlı kurulum
- Mevcut WhatsApp hesabı üzerinden çalışır
- Resmi WABA kurulumu gerektirmez
Dezavantajları
- Resmi WhatsApp Business API bağlantısı değildir
- Toplu mesaj ve kampanyalarda kısıtlamalar yaşanabilir
- Meta veya WhatsApp Web değişikliklerinden etkilenebilir
- Bağlantı kopabilir; yeniden QR gerekebilir
- Şablon mesaj ve işletme doğrulama gibi WABA özellikleri yoktur
Ücretlendirme: Meta WABA mesaj başı ücretlendirme modeli V3 için geçerli değildir.
İlgili sorunlar: 6-) Kurulum hataları
4-) API Tercihleri (Cloud API & Coexistence)
4.a – Cloud API
Nedir? Meta'nın resmi WhatsApp Business API altyapısıdır.
Çalışma mantığı: Numara yalnızca API üzerinden çalışır; telefonda aynı numara ile WhatsApp kullanılamaz. Kurulumda mevcut WhatsApp hesabı kaldırılır.
Ne zaman tercih edilir?
- İletişimin tamamen Supsis Ai panelinden yönetilmesi isteniyorsa
- Müşterinin numarayı telefondaki uygulamadan kullanmasına gerek yoksa
Kurulum farkı: Embedded Signup sırasında WhatsApp Business hesabı oluşturun ile sıfırdan WABA açılırsa bağlantı Cloud API olur.
4.b – Coexistence (CoEx)
Nedir? Aynı numaranın hem telefonda hem Supsis Ai panelinde eşzamanlı kullanılması.
Ne zaman tercih edilir?
- Müşteri WhatsApp'ı telefondan kullanmaya devam edecekse
- Panel ve telefon birlikte çalışacaksa
Kurulum farkı: İşletme varlıkları adımında mevcut WhatsApp Business hesabı / numarası seçilirse bağlantı CoEx olur. CoEx kurulumunda telefon toplantıda hazır olmalıdır; QR ve doğrulama adımları 5-) Kurulum Süreci bölümünde anlatılmıştır.
Bilinmesi gerekenler (CoEx):
- 2 hafta boyunca telefondan WhatsApp Business uygulamasına giriş yapılmazsa hattın API bağlantısı kopabilir.
- CoEx yapısında operasyonel senaryolara bağlı olarak yaklaşık %5 seviyesinde mesaj kaybı yaşanabilme riski bulunabilir; kritik süreçlerde Cloud API alternatifi değerlendirilmelidir.
CoEx hata analizi için Coexistence Hata Rehberi ve WhatsApp Business API — Coexistence bölümüne bakın.
5-) Kurulum Süreci
Ekran görüntülü detaylı adımlar için WhatsApp Business API Entegrasyonu dokümanındaki modül aktivasyonu, portföy, panel ve numara bağlama bölümlerini takip edebilirsiniz. Aşağıdaki akış kurulum toplantısı için özet süreçtir.
5.a – WhatsApp Business API & WhatsApp Business API v2
Kurulum gereksinimleri
- Meta / Facebook hesabı ve tam yetkili kullanıcı
- Meta Business işletme portföyü
- Bağlanacak telefon numarası
- CoEx ise: WhatsApp Business uygulamasının bulunduğu telefon (QR için hazır)
- v2 ise: Meta Business'a eklenebilecek ödeme yöntemi
- v1 ise: Supsis Ai fatura ve ödeme yöntemi (Fatura & Ödeme)
- Doğrulama e-postasına erişim
Not: WhatsApp Business hesabı seçin adımında sıfırdan hesap oluşturulursa bağlantı Cloud API; WhatsApp Business'ta kayıtlı numara seçilirse CoEx olur.
Supsis Ai paneli
- Entegrasyonlar → WhatsApp Business API veya WhatsApp Business API v2
- Kanal oluştur veya mevcut kanalı seç
- WhatsApp Business hesabını bağla → Facebook ile bağlan
- Gizlilik koşullarını inceleyip Devam
İşletme varlıkları
- Meta işletme portföyünü seçin
- WhatsApp Business hesabını seçin veya oluşturun
- İleri → telefon numarasını girin → İleri (gerekli adımlar)
CoEx — QR kod ile bağlantı
- WhatsApp Business uygulamasından QR kodu taratın
- Sohbet paylaşımında Tüm sohbetleri paylaşma seçeneğini seçin
- Saat dilimini seçin (sonradan değiştirilebilir)
- Onayla → bağlantı tamamlanana kadar bekleyin
Hesap doğrulama
Belirtilen e-postaya gelen kodu girin. Şu anda hesap bağlantısı başarılı mesajını görmelisiniz.
Ödeme yöntemi
| Model | Ödeme nerede? | Adımlar |
|---|---|---|
| WhatsApp Business API v2 | Meta Business | Bağlantı sonrası Ödeme yöntemi ekleyin → bilgileri kaydedin |
| WhatsApp Business API | Supsis Ai | Ayarlar → Fatura & Ödeme → fatura adresi ve ödeme yöntemi |
Önemli: Ödeme yöntemi tanımlanmadan şablon (template) mesaj gönderilemez.
Mesajlaşma özeti
- Müşteri yazdığında serbest yanıt verilebilir (24 saat penceresi)
- İlk mesajı işletme başlatıyorsa onaylı şablon mesaj gerekir
- 24 saat geçtiyse sohbeti yeniden başlatmak için yine şablon gerekir
5.b – WhatsApp V3 QR
Gereksinimler: Bağlanacak WhatsApp hesabı, telefon, QR okutma.
- Supsis Ai panelinden WhatsApp V3 QR kanalını seçin
- Kurulum ekranındaki QR kodu açın
- Telefonda Ayarlar → Bağlı Cihazlar → Cihaz Bağla
- QR kodu okutun → bağlantıyı bekleyin
Not: Telefon WhatsApp ile bağlantısı devam eder (WhatsApp Web mantığı).
6-) Kurulum Sırasında Alınan Hatalar ve Çözümleri
Meta doğrulama adımları için Meta Business Doğrulama Rehberi dokümanını kullanın.
6.a – Meta Business problemleri
| Sorun | Çözüm |
|---|---|
| Meta hesabında gerekli yetki yok | İşlemi yapan kullanıcı Business Manager'da tam yetkili olmalı; yoksa yöneticiden yetki isteyin |
| Portföyde kısıtlama veya kaynak sorunu | Gerekirse yeni İşletme Portföyü veya Facebook Sayfası ile kurulumu yeniden deneyin |
| İşletme doğrulanmamış | Kurulum yapılabilir; toplu mesaj ve incelemelerde sorun çıkabilir. Vergi levhası / kuruluş belgesi + fatura hazırlayın → Doğrulama rehberi |
| Doğrulandı ama mesaj limiti artmadı | Hesabın aktif kullanılması gerekir; limit hemen güncellenmeyebilir |
Mesajlaşma limiti (toplu mesaj bağlamı):
| Durum | Limit |
|---|---|
| Doğrulanmamış işletme | 250 |
| Doğrulanmış işletme | 2.000 |
Limit artırma ve kalite kuralları: Mesaj gönderim kapasitesi bölümü.
6.b – Telefon ve numara problemleri
| Sorun | Çözüm |
|---|---|
| Numara başka entegrasyona bağlı | Mevcut entegrasyonu kaldırın veya farklı numara kullanın |
| Arama geliyor, bağlantı olmuyor | Sabit hatta SIP yönlendirmesini kapatın; doğrulama aramasını alabilmeli |
| Doğrulama koduna erişilemiyor | SMS/arama erişimini doğrulayın; numara sahibini toplantıya alın |
6.c – Kanal oluşturma problemleri
| Sorun | Çözüm |
|---|---|
| Kanal oluşturulamıyor, arka planda entegre görünüyor | Eski kanalı kaldırın; gerekirse 24 saat bekleyin. WhatsApp Business API (Gupshup) kullanılıyorsa Gupshup tarafında bağlantı kaldırma için ticket açın ( süreç 1 güne kadar sürebilir) |
7-) Sık Sorulan Sorular
WhatsApp Business API ile normal WhatsApp arasındaki fark nedir?
WhatsApp Business API, WhatsApp'ı Supsis Ai gibi sistemlere bağlayarak panel, chatbot, otomasyon ve CRM üzerinden yönetmenizi sağlar. Normal WhatsApp ağırlıklı olarak telefonda manuel kullanım içindir.
Cloud API ile Coexistence arasındaki fark nedir?
Cloud API: Numara yalnızca API'de; telefonda kullanılamaz.
Coexistence: Aynı hesap hem telefondan hem panelden kullanılabilir.
Not: CoEx'te 2 hafta telefondan giriş yoksa bağlantı kopabilir; yaklaşık %5 mesaj kaybı riski olabilir.
Kurulum için Facebook hesabı gerekli mi?
Evet. WABA kurulumunda Meta/Facebook hesabı ve işletme yetkileri kullanılır.
Meta Business hesabım yoksa ne olur?
Kurulum sırasında Meta Business oluşturulmalı veya uygun bir portföy seçilmelidir. Portföy adımları
İşletmem doğrulanmadı. Kurulum yapabilir miyim?
Evet. Ancak toplu mesaj gönderimi ve Meta incelemelerinde kısıtlama yaşanabilir. Doğrulama ban riskini azaltmak ve limitler için önerilir: Meta Business Doğrulama Rehberi
Doğrulama için hangi belgeler gerekir?
Vergi levhası veya kuruluş belgesi; adres için su/elektrik faturası gibi belgeler talep edilebilir.
Numaramı hem telefondan hem panelden kullanabilir miyim?
Coexistence ile evet. Cloud API ile telefondan kullanılamaz.
Müşteriye ilk mesajı ben gönderebilir miyim?
Evet; işletmenin başlattığı iletişimde onaylı şablon mesaj gerekir. Müşteri yazdıysa 24 saat içinde serbest yanıt verilebilir.
Şablon mesaj için ödeme yöntemi şart mı?
Evet. v2'de Meta Business, WhatsApp Business API modelinde Supsis Ai fatura/ödeme tanımlı olmalıdır.
WhatsApp V3 QR ile Business API / v2 arasındaki fark?
WhatsApp Business API ve WhatsApp Business API v2 resmi WABA altyapısıdır. WhatsApp V3 QR WhatsApp Web + QR ile çalışır; resmi API değildir.
Kurulum ne kadar sürer?
Supsis tarafı genelde kısadır. Uzama nedeni çoğunlukla Meta yetkileri, numara, doğrulama veya eksik işletme bilgileridir.
Duyuru / Kanal özellikleri hangi modelde var?
Hiçbir modelde WhatsApp Kanallar veya duyuru yönetimi yoktur.