"WhatsApp Business API" denince çoğu işletmenin aklına indirilecek bir uygulama geliyor. Oysa API bir uygulama değil, Meta'nın sunucularında çalışan bir mesajlaşma altyapısı. Bu rehber ne olduğunu, nasıl alındığını ve maliyet kalemlerini anlatıyor.
API tam olarak nedir?
WhatsApp Business Platform (yaygın adıyla WhatsApp Business API), işletmelerin kendi yazılımlarını WhatsApp'a bağlamasını sağlayan resmî arayüzdür. Telefonda çalışan bir uygulama yoktur; mesajlar sunucu üzerinden gider, gelen mesajlar webhook ile sisteminize düşer. Pratikte şunları sağlar:
- Aynı numarayı birden fazla personel aynı anda kullanabilir.
- Gelen mesajlar CRM, ERP veya kendi panelinizle eşleşir; sohbet geçmişi sunucuda kalır.
- Onaylı şablonlarla toplu bilgilendirme ve kampanya gönderilebilir.
- Otomatik yanıt, yönlendirme ve raporlama kurulabilir.
Uygulama mı, API mi? Hızlı karşılaştırma
| Konu | WhatsApp Business uygulaması | WhatsApp Business Platform (API) |
|---|---|---|
| Kullanıcı sayısı | 1 telefon + sınırlı bağlı cihaz | Çok kullanıcılı panel |
| Toplu gönderim | Yayın listesiyle sınırlı | Onaylı şablonlarla, hacimli |
| Entegrasyon | Yok | CRM / ERP / e-ticaret / webhook |
| Mesaj ücreti | Yok | Meta tarifesine göre mesaj başına |
| Kurumsal arşiv | Telefonda | Sunucuda |
Kimler aracılık eder: BSP ve Tech Provider
Meta, API'yi işletmelere doğrudan değil, yetkilendirdiği iş ortakları üzerinden açar. İki rol vardır:
- BSP (Business Solution Provider): Mesaj trafiğini kendi hesabı üzerinden taşır; mesaj başına fiyatı genellikle kendisi belirler.
- Tech Provider: Yazılım ve entegrasyonu sağlar; müşteri kendi Meta Business hesabını bağlar, mesaj ücretleri doğrudan müşterinin hesabından işler.
Veri Merkezi, Tech Provider (yetkili yazılım partneri) modelinde çalışır. WhatsApp Business hesabı ve numara Meta'da işletmeniz adına açılır; Meta'nın mesaj ücreti, WhatsApp hesabınıza eklediğiniz karttan doğrudan Meta'ya ödenir. Ayrıntı: WhatsApp Business API.
Başvuru adımları
- Meta Business hesabı: Şirketiniz adına bir Business Manager hesabı açılır.
- İşletme doğrulaması: Meta, şirketin gerçekliğini resmî evrakla doğrular. Web sitesi, kurumsal e-posta ve vergi bilgilerinin tutarlı olması süreci hızlandırır.
- Numara bağlama: Kullanılacak numara WhatsApp Business hesabına tanımlanır. Numaranın mevcut WhatsApp kaydı varsa önce kaldırılır; bazı senaryolarda Coexistence ile uygulama ve API birlikte çalışabilir.
- Görünen ad onayı: Panelde görünecek işletme adı Meta politikalarına göre incelenir.
- Şablonlar: İlk mesaj şablonlarınız oluşturulup onaya gönderilir.
- Canlıya geçiş: Test gönderimi yapılır, limitler ve kalite takibi başlar.
Embedded Signup akışıyla bu adımların büyük kısmı tek ekranda tamamlanır; süreyi en çok uzatan kısım genelde işletme doğrulamasıdır.
Maliyet kalemleri
Teklif alırken üç kalemi ayrı ayrı sorun; toplamı gizleyen fiyatlandırmalar genelde burada şişer:
- Meta mesaj ücreti: Mesaj başına; kategoriye (pazarlama / işlem / doğrulama) ve alıcının ülkesine göre değişir. 1 Temmuz 2025'ten itibaren mesaj başına modele geçilmiştir. Güncel tarifeyi Meta yayımlar.
- Yazılım / panel ücreti: Kullanıcı sayısı, otomasyon ve entegrasyon kapsamına göre sağlayıcıdan sağlayıcıya değişir.
- Kurulum ve destek: Bazı sağlayıcılar tek seferlik kurulum bedeli alır.
Tech Provider modelinde birinci kalem doğrudan Meta'ya, ikinci kalem yazılım sağlayıcısına gider. Veri Merkezi'nde yazılım tarafı yıllık mesaj kredisi paketiyle ücretlendirilir; Meta hesabı kurulumu için ek ücret alınmaz. Paketler ve +KDV fiyatlar için WhatsApp Business API paketlerine bakabilirsiniz.
Sık karşılaşılan engeller
- Doğrulama reddi: Şirket adı, adres veya web sitesi bilgileri resmî kayıtlarla uyuşmadığında yaşanır. Evrak tutarlılığı çözer.
- Görünen ad reddi: Genel ifadeler ("Kampanya", "İndirim") veya marka olmayan adlar reddedilir; tescilli marka adı kullanın.
- Düşük gönderim limiti: Yeni hesaplarda normaldir; kaliteli gönderimle kademeli yükselir.
- Ödeme yöntemi eksikliği: Meta tarafında geçerli bir ödeme yöntemi tanımlı değilse gönderimler başarısız olur. "Yazılım bozuk" demeden önce hata koduna ve ödeme ayarlarına bakın.
Özet
API, WhatsApp'ı bir telefon uygulamasından kurumsal bir kanala dönüştürür. Doğru kurulum sırası: Meta Business hesabı → işletme doğrulaması → numara → şablon → kontrollü canlıya geçiş. Bu sırayı atlayan kısayollar, sonradan numara kaybı olarak geri gelir.
Sıkça sorulan sorular
WhatsApp Business uygulaması ile API arasındaki fark nedir?
WhatsApp Business uygulaması tek telefonda, tek kullanıcıyla çalışan ücretsiz bir uygulamadır. WhatsApp Business Platform (API) ise sunucu tabanlıdır; çok kullanıcılı panel, otomasyon, CRM/ERP entegrasyonu ve onaylı şablonlarla toplu gönderim yapılabilir.
API'yi almak için şirket olmak zorunda mıyım?
Meta Business hesabı ve işletme doğrulaması gerekir. Şahıs şirketleri de başvurabilir; doğrulamada vergi levhası, faaliyet belgesi gibi resmî evraklar istenir.
Numaram WhatsApp'ta kayıtlıysa API'ye taşıyabilir miyim?
Evet. Numara mevcut WhatsApp hesabından silinerek API'ye taşınabilir; Coexistence özelliği ile bazı senaryolarda uygulama ve API birlikte de kullanılabilir. Taşımada geçmiş sohbetler aktarılmaz.
Tech Provider ne demek?
Meta'nın, müşterileri adına WhatsApp Business Platform entegrasyonu kurmaya yetkilendirdiği yazılım sağlayıcısıdır. Veri Merkezi, Tech Provider olarak bağlantıyı kurar; mesaj ücretleri müşterinin kendi Meta hesabından işler.
