WhatsApp Business API 2026 Türkiye rehberi

Neden WhatsApp Business API (uygulama değil)?

WhatsApp Business uygulaması (Play Store / App Store) küçük işletmeler için ücretsiz, tek cihazda çalışır. Otomasyon sınırlı, çoklu agent yok, broadcast hacmi düşük.

WhatsApp Business API (WABA) programlı erişim sağlar:

• Bot ile otomatik cevap (LeadsUp gibi)
• Multi-agent inbox (5+ kişi aynı anda yönetir)
• Template mesajı broadcast (binlerce müşteriye)
• Webhook event handling (sipariş geldi → otomatik DM)
• Çoklu telefon numarası

SMB üstü (günde 50+ mesaj alan) işletme için WABA zorunlu.

5 adım kurulum

Adım 1: Meta Business Manager hesabı (10 dakika)

business.facebook.com adresinden açın. Gerekli:

• Şirketinizin Facebook sayfası (yoksa yeni aç)
• Vergi numarası
• Şirket adresi
• Banka hesabı (ileride faturalama için)

İpucu: "Verified Business" badge için (Meta sayfanızı doğrulamış) ek belge gerekir — vergi levhası, ticaret sicil kaydı. Süreç ~3-5 iş günü. Zorunlu değil ama trust artırır.

Adım 2: BSP seçimi (1 saat — kritik karar)

WhatsApp API'ye direkt erişim yok. Meta'nın onayladığı BSP (Business Solution Provider) üzerinden çalışırsınız.

Uluslararası BSP'ler

• Twilio ($0.005-0.015/conv + Studio Flow ek $) — geliştirici ekibi gerek
• 360dialog (~$5/ay + $0.005/conv) — sade ama TR desteği zayıf
• MessageBird / Vonage (enterprise tier) — pahalı

Yerli BSP'ler (TR pazar odaklı)

• LeadsUp — KVKK + iyzico + Türkçe destek + AI bot motoru
• Wati — sadece WhatsApp, AI yok
• AiSensy — Hindistan merkezli, TR desteği zayıf

Seçim kriterleri:

1. KVKK uyumu var mı? (Türkiye/AB veri yerleşim)
2. iyzico ödeme entegrasyonu var mı?
3. Türkçe destek + Türkçe karakter doğru handle ediliyor mu?
4. AI bot motoru entegre mi? Yoksa ayrı çözüm bulman gerekir.

Adım 3: Telefon numarası seçimi (30 dakika)

WABA için ayrı numara gerekli. Mevcut WhatsApp uygulamanızdaki numara olamaz (önce orada silmelisiniz — uygulama tarafında).

Hangi numara?

• Mobil — kolay alınır, ama "iş hattı" görüntüsü zayıf
• Sabit (landline) — kurumsal hisse veri, doğrulama SMS yerine sesli arama ile yapılır
• VOIP / sanal — Meta bu numaraları reject ediyor; gerçek operatör hattı şart

SMS veya sesli arama ile 6 haneli kod doğrulama (~2 dakika).

"Green tick" (yeşil tik) verified badge

Numara onaylandıktan sonra Meta'dan "Verified Business" badge başvurusu yapabilirsiniz. Süreç 3-7 gün, gerekenler: ticaret sicil, kurumsal sayfa traffic'i, web site varlığı. Zorunlu değil; B2B trust için faydalı.

Adım 4: Template mesajı onayı (24 saat — zorunlu)

WhatsApp 24 saat penceresi kuralı: müşteri size mesaj attıktan sonra 24 saat içinde serbest cevap atabilirsiniz. 24h sonra sadece onaylı template mesajları gönderilir.

3 kategori

1. Marketing (promosyon, yeni ürün) — onay %20-30, dikkatli yazılmalı
2. Utility (sipariş onayı, randevu hatırlatma, kargo bildirim) — onay %90+
3. Authentication (OTP, doğrulama kodu) — hızlı onay

Onay süreci

Template metni + variable placeholder ({{1}}, {{2}} gibi) → BSP üzerinden Meta'ya submit → 2-48 saat içinde onay/red.

Reddedilme sebepleri

• Spammy dil ("Acil!!!", "Şimdi Tıklayın!!!")
• Hediye/şans oyunu vaadi ("Bedava iPhone kazandın")
• Politik içerik
• Rakip ürün adı geçmesi

Tavsiye: template metnini sade, somut, eylem-odaklı yazın. Örnek:

Sayın {{1}}, {{2}} no'lu siparişiniz kargoya verildi. Takip: {{3}}

Adım 5: BSP üzerinden bağlantı (15 dakika)

BSP portal'ında "WhatsApp Business Account ekle" akışı:

1. Facebook ile giriş (Meta App üzerinden permission)
2. Phone Number ID + Access Token alımı (BSP otomatik)
3. Webhook URL yapılandırma (BSP otomatik)
4. Test mesajı — kendinize SMS atın, BSP'de görmeli

LeadsUp Setup Wizard bunu 3 tıkla halleder — Facebook Login + permission approve + done.

24 saat penceresi pratiği

Müşteri 2 Pazartesi 14:00'te size yazdı. Siz 2 Salı 13:59'a kadar free-form mesaj atabilirsiniz. 14:00'ten sonra ancak utility/marketing template ile devam edebilirsiniz.

Best practice: müşteri konuşması başladığında session aktif olur, her yeni mesaj geldikçe 24 saat yenilenir. Aktif konuşmada free-form mesaj OK. 24 saat sessizlik = template gerekir.

Hatalar — sık yapılan

1. Mevcut numarayı silmeyi unutmak — Meta "telefon zaten kullanılıyor" der, BSP onboarding takılır.
2. Şirket Facebook sayfası olmadan başlamak — Meta Business Manager sayfa istiyor.
3. Template metnini test etmeden submit — red sayısı artıyor, Meta hesap güvenilirliği düşüyor.
4. 24 saat penceresi ihlal — Meta otomatik rate limit uyguluyor; gönderim oranı düşer.

LeadsUp ile entegrasyon

LeadsUp portal'da /dashboard/integrations/whatsapp-setup adresine git. 5 adım wizard:

1. Meta Business Manager onayı
2. Phone Number ID ekleme (auto-detect)
3. Access Token (BSP otomatik)
4. İlk template oluştur (örnek şablon hazır)
5. Sandbox testi → canlıya alın

İlk müşteri mesajınızı 24 saat içinde alacak şekilde tamamlandı.

Maliyet özeti

Meta'nın WhatsApp conversation fee'leri (Türkiye 2026):

• Service (kullanıcı-initiated, 24h içi): ücretsiz
• Utility (sipariş onayı): $0.005-0.010/conv
• Marketing (broadcast): $0.05-0.08/conv
• Authentication (OTP): $0.0006/conv

Tipik SMB ayda 2.000 konuşma (mix utility + service) → ~$15 Meta fee + BSP plan ücreti.

LeadsUp Starter ₺900/ay Meta fee dahil + AI bot motoru + KVKK uyumu = en uygun TR pazar paketi.