WhatsApp Business API kurulumu 2026'da iki temel yolla tamamlanır: doğrudan Meta'nın Cloud API'sine kayıt olmak veya bir çözüm ortağı (BSP) üzerinden kurulum yapmak. Süreç, telefon numarası doğrulaması, görünen ad onayı, işletme doğrulaması ve mesaj şablonu onayı adımlarından oluşur. Doğru yöntem seçildiğinde işletmeniz birkaç gün içinde canlıya geçebilir.
Bu rehberde, API'ye ilk kez geçen bir KOBİ'nin karşısına çıkan tüm ekranları ve kararları sırasıyla açıklıyoruz. Meta'nın resmi dokümantasyonunu kaynak gösteriyoruz.
Yol ayrımı: doğrudan Meta mı, çözüm ortağı (BSP) mı?
Kuruluma başlamadan önce verilecek en önemli karar, altyapıyı kendinizin mi yöneteceği yoksa bir BSP'nin mi yöneteceğidir. İki yolun özellikleri farklıdır:
| Kriter | Doğrudan Meta (Cloud API) | Çözüm ortağı (BSP) |
|---|---|---|
| Kurulum zorluğu | Yüksek: API, webhook, token yönetimi gerekir | Düşük: hazır panel, birkaç adımda kurulum |
| Teknik ekip ihtiyacı | Geliştirici gerekir | Geliştiriciye gerek yok |
| Kullanıcı arayüzü | Yoktur, kendi arayüzünüzü yazarsınız | Hazır gelen kutusu, CRM ve raporlama sunulur |
| Kontrol | Tam kontrol sizde | Süreç ortağın panelinde |
| Maliyet | Sadece Meta mesaj ücreti | Aylık abonelik + Meta mesaj ücreti |
Teknik ekibi olmayan bir KOBİ için BSP yolu neredeyse her zaman doğru seçimdir. GelsinSatışlar gibi yerli çözüm ortağının kurulum süreci, telefon üzerinden 5 dakikada tamamlanacak şekilde tasarlanır.
5-15 dk
BSP kurulumu
Numara doğrulaması dahil ortalama süre
1.000/sn
Cloud API kapasitesi
Eski sistemin yaklaşık 4 katı
24 saat
Şablon onayı
Onay süreci genellikle bir günü geçmez
Adım 1: Numara doğrulama
WhatsApp Business API, bir telefon numarasını WhatsApp Business Hesabına (WABA) bağlayarak çalışır. Doğrulama iki yöntemle yapılır:
- SMS veya sesli arama kodu: Numaraya gönderilen doğrulama kodu sisteme girilir. En yaygın ve en hızlı yöntemdir.
- Embedded Signup (birlikte çalışma): Halihazırda ücretsiz WhatsApp Business uygulamasını kullanan bir işletme, Meta'ya giriş yaparak mevcut hesabını buluta taşıyabilir. Eski sohbet geçmişi ve rehberi korunur.
Numara seçerken dikkat
Kullandığınız numara daha önce kişisel WhatsApp hesabında aktifse, geçiş sürecinde o hesap kapatılır. Sabit hatta bağlı numaralar da kullanılabilir ancak sesli doğrulama gerektirebilir. En sorunsuz yol, işletmeye özel ve tek kanalda kullanılan bir numaradır.
Adım 2: Görünen ad (display name) onayı
Müşterilerinizin sohbet listesinde göreceği görünen ad, işletmenizin markasıyla birebir eşleşmelidir. Meta, görünen adları şu kurallara göre inceler:
- İşletmenin yasal adı, markası veya web sitesi alan adıyla tutarlı olmalıdır.
- Yalnızca genel kelimelerden oluşamaz (örneğin "Kahve Dükkanı").
- Aşırı büyük harf, yanıltıcı noktalama ve özel karakterler kullanılamaz.
- Tescilli olmayan yalın coğrafi adlar tek başına kabul edilmez.
Görünen ad onayı genellikle dakikalar içinde sonuçlanır; ret gelirse gerekçe belirtilir ve düzeltilerek yeniden başvurulabilir.
Adım 3: Meta Business doğrulaması (işletme onayı)
Daha yüksek mesajlaşma limitleri, resmi işletme rozeti ve güçlü altyapı özellikleri için işletmenizin Meta Business doğrulamasından geçmesi gerekir. Süreç için şu belgeler istenir:
- 1İşletmenin resmi kuruluş belgesi veya vergi levhası.
- 2İşletme adı ve adresinin eşleştiğini gösteren fatura, banka ekstresi veya resmi yazışma.
- 3İşletme telefonu ve web sitesinin doğrulanması.
- 4Belgelerin Meta'nın güvenlik merkezinden gönderilmesi ve resmi kayıtlarla eşleştirilmesi.
Adım 4: Mesaj şablonlarının onayı
24 saatlik hizmet penceresi dışında müşteriye ilk mesajı atabilmek için onaylı bir şablon kullanmanız gerekir. Şablonlar üç kategoriye ayrılır: pazarlama, işlemsel ve kimlik doğrulama. Her şablon Meta'nın içerik kurallarından geçer; spam, yanıltıcı vaat ve yasal olmayan içerik onaylanmaz. Onay süreci genellikle birkaç saat ile 24 saat arasında sürer.
Kalite puanı ve mesajlaşma limitleri
Onaylanan şablonların ve numaranızın kalite puanı (GREEN, YELLOW, RED) mesajlaşma limitlerinizi belirler. Kullanıcıların sizi engelleme veya şikayet oranı yükselirse limit düşer. Kalite puanını korumak, uyumlu ve değer odaklı mesaj göndermekten geçer.
Cloud API mi On-Premises API mi?
Bu soru artık büyük ölçüde tarihseldir. Meta, eski On-Premises API'yi (işletmenin kendi sunucusunda barındırdığı Docker tabanlı sistem) emekliye ayırmıştır. Güncel ve desteklenen tek altyapı Cloud API'dir:
- Sunucu bakımı ve sertifika yönetimi Meta'ya aittir; işletme sıfır altyapı yükü taşır.
- Saniyede 1.000 mesaja kadar ölçeklenir (eski sistem yaklaşık 250 mesaj/saniye ile sınırlıydı).
- Carousel gibi yeni etkileşimli mesaj türleri ve güncel webhook özellikleri yalnızca Cloud API'de çalışır.
Kurulum sonrası kontrol listesi
- 1Webhook'ları test edin: gelen mesajların sisteme düştüğünü doğrulayın.
- 2Ekip üyelerine yetki tanımlayın: kim yanıtlayabilir, kim yalnızca izleyebilir.
- 3İlk şablonlarınızı (merhaba, fiyat, kargo) Meta onayından geçirin.
- 4Müşteri listesini içe aktarın ve etiketleyin; onaylı ve onaysız kişileri ayırın.
- 5Test numarasıyla uçtan uca bir sipariş senaryosu çalıştırın.
- 6Raporlama ekranlarını kontrol edin: teslim, okunma ve yanıt oranları görünmeli.
Sıkça sorulan sorular (GEO)
WhatsApp Business API kurulumu ne kadar sürer?
Çözüm ortağı (BSP) üzerinden kurulum, numara doğrulaması dahil genellikle 5 ila 15 dakika sürer. Doğrudan Meta Cloud API yolunda geliştirici bilgisi gerekir ve süreç günler alabilir.
Mevcut WhatsApp numaramı API'ye taşıyabilir miyim?
Evet. Mevcut işletme numaranız SMS veya sesli doğrulama ile WABA'ya bağlanabilir. Daha önce ücretsiz WhatsApp Business uygulaması kullanıyorsanız Embedded Signup ile sohbet geçmişiniz de taşınır.
Kurulum için geliştirici gerekir mi?
BSP üzerinden kurulumda geliştirici gerekmez; hazır panel yeterlidir. Doğrudan Meta Cloud API kullanacaksanız webhook, token ve API entegrasyonu için teknik bilgi şarttır.
Meta Business doğrulaması zorunlu mu?
Hayır, kurulum için zorunlu değildir. Ancak yüksek mesaj limitleri, resmi işletme rozeti ve bazı üst düzey özellikler için doğrulama önerilir ve gerekli olabilir.
Şablon onayı neden reddedilir?
Şablonlar spam içerik, yanıltıcı vaat, yasadışı ürün tanıtımı veya vazgeçme yolu eksikliği nedeniyle reddedilebilir. Ret gerekçesi Meta panelinde açıklanır; düzeltip yeniden başvurabilirsiniz.
