WhatsApp Business API, standart WhatsApp Business uygulamasının ötesine geçen, işletmelere programatik mesajlaşma ve otomasyon imkânı tanıyan bir geliştirici platformudur. 2026'da müşterilerinin büyük çoğunluğu WhatsApp kullanan Türk işletmeler için bu API, satış ve müşteri hizmetlerini 7/24'e taşımanın anahtarıdır.
Bu rehber, WhatsApp Business API'yi teknik detaylarıyla — ama anlaşılır bir dille — adım adım açıklıyor.
WhatsApp Business Uygulama vs. API: Fark Ne?
Önce temel ayrımı netleştirelim:
WhatsApp Business Uygulaması (ücretsiz):
- Manuel kullanım, tek cihaz (artık çoklu cihaz destekli)
- Otomatik yanıt çok sınırlı
- Ölçekleme yok; müşteri sayısı arttıkça başa çıkmak zorlaşır
- Küçük ve tek kişilik işletmeler için uygun
WhatsApp Business API:
- Programatik erişim: bot, otomasyon, CRM entegrasyonu
- Sınırsız kullanıcı ve mesajlaşma kapasitesi
- Çoklu temsilci desteği: birden fazla kişi aynı numaradan mesajlaşabilir
- Şablon mesajları (template messages): onaylı şablonlarla müşteri bildirimi
- Orta ve büyük ölçekli işletmeler için
API'ye Erişim: Meta İş Ortağı veya Doğrudan Entegrasyon
WhatsApp Business API'ye erişmek için iki yol vardır:
Yol 1: Meta Business Suite Üzerinden (Doğrudan)
Meta'nın kendi geliştirici portalı üzerinden API erişimi alabilirsiniz. Bu yol ücretsiz (mesaj ücretleri hâlâ geçerli) ancak teknik kurulum tamamen size aittir.
Gereksinimler:
- Doğrulanmış Meta Business hesabı
- Aktif bir Facebook sayfası
- +90 ile başlayan Türk telefon numarası (veya başka ülke numarası) — bu numara artık WhatsApp personal olarak kullanılamaz
Yol 2: Meta İş Ortağı (BSP) Üzerinden
Meta'nın onaylı iş ortakları (Business Solution Providers — BSP'ler) API erişimini hazır paket olarak sunar. Türkiye'de çeşitli BSP'ler mevcuttur.
BSP'nin avantajları:
- Teknik kurulum BSP tarafından yapılır
- Panel üzerinden yönetim kolaylaşır
- Destek ve sorun giderme sağlanır
BSP'nin dezavantajı:
- Ek aylık platform ücreti
- Bazı özellikler için API üzerine kısıtlama koyabilir
M.U.G.E gibi AI destekli çözümler, bu teknik karmaşıklığı tamamen ortadan kaldırır; API entegrasyonunu ve AI katmanını tek bir pakette sunar.
Adım Adım Kurulum (Meta Doğrudan Entegrasyon)
Adım 1: Meta Business Hesabını Hazırlayın
- business.facebook.com adresine gidin
- İşletme hesabınızı oluşturun veya mevcut hesabınıza giriş yapın
- İşletme doğrulama sürecini tamamlayın (kimlik belgesi ve/veya vergi belgesi gerekebilir)
- Doğrulama genellikle 1–5 iş günü sürer
Adım 2: WhatsApp İş Hesabı (WABA) Oluşturun
- Meta Business Suite > "Ayarlar" > "WhatsApp Hesapları"
- Yeni WABA oluşturun
- İşletme adınızı ve kategorinizi belirleyin
- Telefon numaranızı ekleyin — SMS veya sesli arama ile doğrulama kodu alırsınız
Not: Bu numarayı normal WhatsApp'a kaydetmek artık mümkün olmayacak. Müşteri iletişimi için ayrı bir numara kullanmanız önerilir.
Adım 3: Geliştirici Uygulaması Oluşturun
- developers.facebook.com adresine gidin
- "Uygulama Oluştur" > "İşletme" tipini seçin
- WhatsApp ürününü uygulamanıza ekleyin
- Access Token ve Phone Number ID bilgilerini not edin — API çağrılarında gerekli
Adım 4: Webhook Kurun
Webhook, WhatsApp'tan gelen mesajları sunucunuza iletir.
Gereksinimler:
- HTTPS destekli bir sunucu URL'si
- Meta'nın hub.verify_token doğrulama mekanizmasını destekleyen endpoint
- Gelen mesajları parse eden ve yanıt üreten uygulama mantığı
Temel webhook yapısı:
GET /webhook?hub.verify_token=YOUR_TOKEN&hub.challenge=CHALLENGE_STRING → Sunucunuz CHALLENGE_STRING değerini döndürmeli
POST /webhook → Mesaj JSON'ını alıp işleme ve yanıt mantığı
Adım 5: İlk Mesajı Gönderin
API ile mesaj göndermek için messages endpoint'ini kullanırsınız:
POST https://graph.facebook.com/v18.0/{PHONE_NUMBER_ID}/messages
Header: Authorization: Bearer {ACCESS_TOKEN}
Body: messaging_product: "whatsapp", to: "+905xxxxxxxxx", type: "text", text.body: "Merhaba!"
Adım 6: Şablon Mesajları (Template) Onaylayın
WhatsApp, kullanıcının konuşmayı başlatmadığı durumlarda yalnızca önceden onaylanmış şablon mesajları göndermenize izin verir. (24 saat penceresi kuralı: kullanıcı mesaj gönderirse 24 saat içinde serbest metin yanıtlayabilirsiniz.)
Şablon örneği:
- İsim: randevu_hatirlatma
- İçerik: "Merhaba {{1}}, {{2}} tarihindeki randevunuzu hatırlatmak istedik."
- Kategori: UTILITY veya MARKETING
- Onay süresi: 1–3 iş günü
Ölçekleme ve Mesaj Limitleri
WhatsApp API'de katmanlı mesajlaşma limitleri vardır:
- Tier 1: Günlük 1.000 benzersiz kullanıcıya mesaj
- Tier 2: Günlük 10.000 benzersiz kullanıcı
- Tier 3: Günlük 100.000 benzersiz kullanıcı
- Tier 4: Sınırsız
Tier atlama, iyi kalite skoru ve düzenli kullanımla otomatik gerçekleşir.
API Kurulum Yerine Hazır Çözüm: M.U.G.E
Yukarıdaki adımlar teknik bilgi gerektiriyor ve kurulum birkaç günü bulabiliyor. Eğer amacınız API tekniğini öğrenmek değil, WhatsApp'ı satış ve müşteri hizmetine dönüştürmek ise, M.U.G.E bu teknik yükü tamamen üstlenir:
- API kurulum ve bakım M.U.G.E tarafından yapılır
- Yapay zeka ile doğal dil anlama ve yanıt üretme dahildir
- Özelleştirilmiş senaryolar (ürün sorusu, randevu, tekrar satış) hazır gelir
- Raporlama ve analitik panel dahildir
Sonuç
WhatsApp Business API, işletmenizi gerçek anlamda 7/24 hale getirir. Kurulum teknik görünse de adımlar nettir. Teknik ekibiniz varsa doğrudan entegrasyon mümkün; yoksa M.U.G.E gibi hazır bir çözüm hem hızı hem kaliteyi garanti eder.
Ücretsiz demo için bize ulaşın ve WhatsApp otomasyonunuzu bu hafta başlatın. Ayrıca WhatsApp ile müşteri hizmetleri rehberimize ve satış otomasyonu rehberimize göz atın.
