WhatsApp Business API, işletmenizi WhatsApp'ın 2 milyar kullanıcısına profesyonel şekilde bağlayan köprüdür. WhatsApp botları ve AI asistanlar için temel olan bu teknoloji, müşteri iletişimini dijitale taşımanın en etkili yoludur. Normal WhatsApp Business uygulamasından çok daha güçlü, ölçeklenebilir ve otomasyon yeteneklerine sahip bu sistem, orta ve büyük ölçekli işletmelerin müşteri iletişimini dijitale taşımasının en etkili yoludur. Bu rehberde, WhatsApp Business API entegrasyonunu A'dan Z'ye, adım adım anlatacağız.
WhatsApp Business API Nedir?
WhatsApp Business API, Meta (Facebook) tarafından sağlanan, işletmelerin WhatsApp üzerinden müşterileriyle programatik olarak iletişim kurmasını sağlayan resmi bir çözümdür. Normal WhatsApp Business uygulamasından farklı olarak:
- Sınırsız sayıda eş zamanlı konuşma yapabilirsiniz
- Chatbot ve otomasyon entegrasyonu mümkündür
- CRM, ERP ve e-ticaret sistemlerinizle bağlantı kurabilirsiniz
- Birden fazla operatör aynı numarayı kullanabilir
- Yeşil tik (verified business) alabilirsiniz
- Toplu mesaj (broadcast) gönderebilirsiniz
- Detaylı analitik ve raporlama alabilirsiniz
Kısacası, WhatsApp Business API işletmenizin müşteri iletişimini profesyonel bir seviyeye taşıyan kurumsal çözümdür.
WhatsApp Business App vs WhatsApp Business API: Hangisi Size Uygun?
📱 WhatsApp Business Uygulaması (Ücretsiz)
Uygun olan işletmeler: Küçük işletmeler, bireysel girişimciler, düşük mesaj hacmi
Özellikler:
- ✅ Ücretsiz kullanım
- ✅ Kolay kurulum (5 dakika)
- ✅ İşletme profili
- ✅ Katalog özelliği
- ✅ Hızlı yanıtlar (manuel)
- ❌ Maksimum 5 cihaz
- ❌ Otomasyon yok
- ❌ CRM entegrasyonu yok
- ❌ Chatbot desteği yok
- ❌ Toplu mesaj sınırlı
⚙️ WhatsApp Business API (Ücretli)
Uygun olan işletmeler: Orta-büyük işletmeler, yüksek mesaj hacmi, otomasyon ihtiyacı
Özellikler:
- ✅ Sınırsız operatör ve cihaz
- ✅ Tam otomasyon ve chatbot
- ✅ CRM/ERP/E-ticaret entegrasyonu
- ✅ Yeşil tik (doğrulanmış işletme)
- ✅ Şablon mesajlar (template messages)
- ✅ Toplu mesaj gönderimi
- ✅ Detaylı analitik
- ✅ Webhook entegrasyonları
- ✅ İnteraktif mesajlar (buton, liste)
- 💰 Ücretli (konuşma bazlı)
Karar: Günlük 50+ mesaj alıyorsanız, otomasyon istiyorsanız veya CRM entegrasyonu gerekiyorsa → WhatsApp Business API seçmelisiniz.
WhatsApp Business API Başvuru Gereksinimleri
API başvurusu yapmadan önce aşağıdaki gereksinimleri karşılamanız gerekmektedir:
📋 Zorunlu Gereksinimler
1. Tüzel Kişilik
- Şirket veya şahıs şirketi (vergi levhası olan)
- Ticaret sicil belgesi
- Vergi levhası
- Şirket imza sirküleri
2. Doğrulanmış Meta Business Hesabı
- Facebook Business Manager hesabı
- İşletme doğrulaması (Business Verification) tamamlanmış
- Resmi belgeler Meta'ya yüklenmiş ve onaylanmış
3. Aktif Web Sitesi
- Çalışan, erişilebilir bir web sitesi
- Gizlilik politikası sayfası
- İletişim bilgileri
- Şirket hakkında bilgiler
4. WhatsApp Politikalarına Uygunluk
- WhatsApp Commerce Policy'ye uyum
- WhatsApp Business Policy'ye uyum
- Yasaklı sektörlerde olmama (silah, tütün, kumar vb.)
- Spam göndermeme taahhüdü
5. Telefon Numarası
- Henüz WhatsApp'ta kayıtlı olmayan bir numara (veya mevcut numaranızı migrate edebilirsiniz)
- SMS veya sesli arama ile doğrulanabilir numara
- Sabit hat veya mobil numara olabilir
⚠️ Yasaklı Sektörler
Aşağıdaki sektörler WhatsApp Business API kullanamaz:
- Silah ve mühimmat
- Tütün ve alkol
- Kumar ve bahis
- Yetişkin içerik
- İlaç ve tıbbi cihazlar (izinsiz)
- Kripto para (bazı kısıtlamalar)
- Politik kampanyalar (bazı ülkelerde)
WhatsApp Business API Entegrasyonu: Adım Adım Rehber
Adım 1: Meta Business Suite Hesabı Oluşturma (1-2 Gün)
1.1 Facebook Business Manager'a Gidin
business.facebook.com adresine gidin ve "Hesap Oluştur" butonuna tıklayın.
1.2 İşletme Bilgilerini Girin
- İşletme adı (resmi ticaret unvanı)
- Adınız ve soyadınız
- İş e-posta adresi
1.3 İşletme Doğrulaması (Business Verification)
Bu adım kritik ve genellikle 1-3 iş günü sürer:
- Vergi levhası veya ticaret sicil belgesi yükleyin
- İşletme adresini doğrulayın
- Telefon numarasını doğrulayın
- Domain doğrulaması yapın (web siteniz için)
💡 İpucu: Belgelerdeki şirket adı ile Business Manager'daki ad birebir eşleşmelidir. Aksi halde doğrulama reddedilebilir.
Adım 2: WhatsApp Business Hesabı Oluşturma (30 Dakika)
2.1 Meta Business Suite'te WhatsApp Ekleyin
- Business Settings → Accounts → WhatsApp Accounts
- "Add" butonuna tıklayın
- WhatsApp Business Account adını girin
2.2 Telefon Numarasını Kaydedin
- Kullanacağınız telefon numarasını girin
- SMS veya sesli arama ile doğrulayın
- Display name (görünen ad) belirleyin
2.3 İşletme Profilini Doldurun
- İşletme açıklaması
- Profil fotoğrafı (logo)
- Adres bilgileri
- Web sitesi
- E-posta adresi
- Sektör kategorisi
Adım 3: API Erişimi Alma (1-5 Gün)
İki farklı yol vardır:
Yol 1: Doğrudan Meta Cloud API
- Meta'nın kendi cloud sunucularını kullanırsınız
- Ücretsiz başlangıç (ilk 1000 konuşma/ay bedava)
- Teknik bilgi gerektirir
- Kendi sunucunuzda webhook yönetimi
Yol 2: Çözüm Ortağı (BSP) Üzerinden - ÖNERİLEN
- OctoChat gibi onaylı iş ortakları
- Hızlı kurulum (1-3 gün)
- Hazır dashboard ve arayüz
- Teknik destek
- Ek özellikler (chatbot, CRM entegrasyonu vb.)
🎯 OctoChat Avantajı: Meta'nın resmi iş ortağı olarak, onay süreçlerini hızlandırır ve teknik kurulumu sizin yerinize yaparız.
Adım 4: Webhook Entegrasyonu (Teknik)
Webhook, WhatsApp'tan gelen mesajları kendi sisteminize almanızı sağlar.
4.1 Webhook URL Tanımlama
- HTTPS zorunludur (SSL sertifikası)
- Örnek: https://api.siteniz.com/whatsapp/webhook
- Verify token belirleyin
4.2 Webhook Events
- messages: Gelen mesajlar
- message_status: Mesaj durumu (gönderildi, okundu vb.)
- message_template_status: Şablon onay durumu
4.3 Gelen Mesaj İşleme
Webhook'a gelen JSON formatındaki mesajları parse edin ve işleyin. Mesaj tiplerine göre farklı işlemler yapın (metin, görsel, lokasyon vb.).
💡 OctoChat Kullanıyorsanız: Webhook kurulumu otomatik yapılır, teknik detaylarla uğraşmazsınız.
Adım 5: Şablon Mesajlar (Template Messages) Oluşturma
WhatsApp Business API'de müşteriye ilk mesajı göndermek için onaylı şablon mesajlar kullanmanız gerekir.
Şablon Kategorileri:
- Marketing: Promosyon, kampanya duyuruları
- Utility: Sipariş bildirimi, randevu hatırlatması
- Authentication: OTP, doğrulama kodları
Şablon Oluşturma Kuralları:
- İçerik WhatsApp politikalarına uygun olmalı
- Değişkenler {{1}}, {{2}} formatında olmalı
- Onay süresi: 24-48 saat
- Reddedilirse düzenleyip tekrar gönderebilirsiniz
Örnek Şablon Mesaj:
"Merhaba {{1}}, {{2}} numaralı siparişiniz kargoya verildi. Kargo takip kodu: {{3}}. Tahmini teslimat: {{4}}. İyi günler dileriz!"
Adım 6: Test ve Canlıya Alma (1 Gün)
6.1 Sandbox Testi
- Test numarası ile tüm fonksiyonları deneyin
- Mesaj gönderme/alma
- Şablon mesajlar
- Medya gönderimi (fotoğraf, video, PDF)
- İnteraktif mesajlar (butonlar, listeler)
6.2 Hata Kontrolü
- Webhook yanıt süreleri (5 saniyeden az olmalı)
- Hata loglarını inceleyin
- Rate limiting kontrolü
6.3 Canlıya Alma
- Production numarasına geçiş
- İlk mesajları gönderin
- Müşteri tepkilerini izleyin
WhatsApp Business API Mesaj Tipleri
📝 Metin Mesajları
Basit metin içerikli mesajlar. Emoji ve link içerebilir.
🖼️ Medya Mesajları
- Fotoğraf: JPG, PNG (max 5MB)
- Video: MP4 (max 16MB)
- Ses: MP3, OGG (max 16MB)
- Belge: PDF, DOC, XLS vb. (max 100MB)
- Sticker: WebP formatı
📍 Lokasyon Mesajları
Konum paylaşımı. Adres, harita linki içerir.
👤 Kişi Kartı
vCard formatında kişi bilgisi paylaşımı.
🔘 İnteraktif Mesajlar
Butonlu Mesajlar:
- Quick Reply Buttons (max 3 buton)
- Call-to-Action Buttons (telefon arama, web sitesi)
Liste Mesajları:
- Menü tarzında seçenekler
- 10 kategoriye kadar
- Her kategoride 10 seçenek
WhatsApp Business API Fiyatlandırması
Konuşma Bazlı Ücretlendirme
WhatsApp, mesaj bazlı değil konuşma (conversation) bazlı ücretlendirme yapar. 24 saatlik pencere içindeki tüm mesajlar tek konuşma sayılır.
Konuşma Türleri ve Türkiye Fiyatları (2026):
- Marketing: ~0.25 TL / konuşma
- Utility: ~0.15 TL / konuşma
- Authentication: ~0.10 TL / konuşma
- Service (müşteri başlattı): ~0.12 TL / konuşma
Ücretsiz Konuşmalar:
- Her ay ilk 1.000 konuşma ücretsizdir
- Kullanıcı başlattığı konuşmalarda 24 saat ücretsiz mesajlaşma
💡 Maliyet Hesaplama Örneği:
- Aylık 5.000 müşteri konuşması
- %60'ı service (müşteri başlattı): 3.000 x 0.12 = 360 TL
- %30'u utility (bildirim): 1.500 x 0.15 = 225 TL
- %10'u marketing: 500 x 0.25 = 125 TL
- İlk 1.000 ücretsiz: -120 TL
- Toplam: ~590 TL/ay
WhatsApp Business API Güvenlik ve KVKK Uyumu
🔒 Güvenlik Önlemleri
- Uçtan Uca Şifreleme: Tüm mesajlar şifrelidir
- SSL/TLS: API iletişimi şifreli
- Access Token: Her istek için yetkilendirme
- IP Whitelist: Belirli IP'lerden erişim
- Two-Factor Authentication: Hesap güvenliği
📋 KVKK ve GDPR Uyumu
- Müşterilerden açık rıza alın
- Veri işleme amaçlarını bildirin
- Opt-out (abonelikten çıkma) seçeneği sunun
- Kişisel verileri güvenli saklayın
- Veri ihlali durumunda 72 saat içinde bildirim
Yaygın Hatalar ve Çözümleri
❌ Hata 1: İşletme Doğrulaması Reddedildi
Neden: Belgeler eksik, isim uyuşmazlığı, web sitesi yetersiz
Çözüm: Tüm belgeleri kontrol edin, şirket adının birebir eşleştiğinden emin olun
❌ Hata 2: Şablon Mesaj Reddedildi
Neden: Politika ihlali, spam içerik, yanıltıcı bilgi
Çözüm: WhatsApp politikalarını okuyun, içeriği düzenleyin, tekrar gönderin
❌ Hata 3: Mesajlar İletilmiyor
Neden: Webhook hatası, rate limiting, numara engelli
Çözüm: Webhook loglarını kontrol edin, hız limitlerini gözden geçirin
❌ Hata 4: Kalite Puanı Düşük
Neden: Çok fazla engelleme veya şikayet
Çözüm: Mesaj içeriğini iyileştirin, spam göndermekten kaçının, opt-out seçeneği sunun
WhatsApp Business API Başarı Öyküsü
📈 E-Ticaret Şirketi: %150 Dönüşüm Artışı
Öncesi: E-posta ile sipariş bildirimleri, %15 açılma oranı
Sonrası: WhatsApp ile bildirimler, %95 okunma oranı
Sonuç: Sepet terk hatırlatmalarında %150 dönüşüm artışı
🏥 Sağlık Kuruluşu: %40 No-Show Azalması
Öncesi: Telefon ile randevu hatırlatma, ulaşım oranı %60
Sonrası: WhatsApp hatırlatmaları, okunma %98
Sonuç: Randevuya gelmeme (no-show) oranı %40 azaldı
Sık Sorulan Sorular (FAQ)
❓ API entegrasyonu ne kadar sürer?
OctoChat ile 3-7 gün. Doğrudan Meta ile 2-4 hafta sürebilir.
❓ Mevcut WhatsApp numaramı kullanabilir miyim?
Evet, mevcut WhatsApp Business numaranızı API'ye migrate edebilirsiniz. Ancak bu işlem geri alınamaz.
❓ Birden fazla numara kullanabilir miyim?
Evet, aynı Business hesabına birden fazla numara ekleyebilirsiniz.
❓ Yeşil tik (verified) nasıl alınır?
İşletme doğrulaması yapılmış, belirli kalite standartlarını karşılayan hesaplara Meta tarafından verilir. OctoChat bu süreçte destek sağlar.
❓ Spam gönderebilir miyim?
Hayır! Opt-in almadan mesaj göndermek yasaktır ve hesabınızın askıya alınmasına neden olur.
❓ API masraflarını kim öder?
Konuşma ücretleri işletme tarafından ödenir. OctoChat paketlerine dahil veya kullanım bazlı faturalandırılır.
OctoChat ile WhatsApp Business API Entegrasyonu
OctoChat, Meta'nın resmi iş ortağı (Business Solution Provider) olarak WhatsApp Business API entegrasyonunu sizin için kolaylaştırır.
🚀 OctoChat Avantajları
- ✅ Hızlı Kurulum: 3-7 gün içinde canlıya alım
- ✅ Teknik Destek: 7/24 Türkçe destek ekibi
- ✅ Hazır Chatbot: AI destekli chatbot entegrasyonu
- ✅ Dashboard: Kullanıcı dostu yönetim paneli
- ✅ Entegrasyonlar: 50+ e-ticaret ve CRM entegrasyonu
- ✅ Şablon Yönetimi: Kolay şablon oluşturma ve onay takibi
- ✅ Analitik: Detaylı raporlar ve metrikler
- ✅ KVKK Uyumlu: Veri güvenliği garantisi
- ✅ Uygun Fiyat: Şeffaf, gizli maliyet yok
📞 Kurulum Süreci
- Demo Talebi: Formu doldurun, sizi arayalım
- İhtiyaç Analizi: İşletmenize özel çözüm planlayalım
- Belgeler: Gerekli belgeleri hazırlayın
- Kurulum: OctoChat ekibi entegrasyonu tamamlar
- Eğitim: Ekibinize kullanım eğitimi verilir
- Canlıya Alma: Sisteminiz aktif!
Sonuç: Dijital Dönüşümünüze Bugün Başlayın
WhatsApp Business API, müşteri iletişiminin geleceğidir. 2 milyar aktif kullanıcının olduğu platformda profesyonel varlık göstermek, rekabette öne geçmenizi sağlar.
Rakamlar:
- WhatsApp mesajlarının %98'i okunuyor (e-posta %20)
- Ortalama yanıt süresi 90 saniye (e-posta 90 dakika)
- Müşteri memnuniyeti %95+ (telefon %78)
- Dönüşüm oranı 3-5x daha yüksek
OctoChat ile WhatsApp Business API entegrasyonunu teknik karmaşıklık olmadan, hızlıca tamamlayabilirsiniz. Meta'nın resmi iş ortağı olarak size en iyi hizmeti sunuyoruz.
Müşterileriniz WhatsApp'ta. Siz de orada olun!
Ücretsiz Demo Talep Edin - Hemen Başlayın!
Demo görüşmesi tamamen ücretsizdir ve hiçbir yükümlülük getirmez. İşletmenize özel çözümü keşfedin.
