WhatsApp Business API Türkiye: Kurulum Rehberi
WhatsApp Business API Türkiye işletmelerinde çoğu ekip aynı noktada takılır: müşteri 22:40’ta “siparişim nerede?” yazar, temsilci mesaide değildir, cevap sabaha kalır. O boşluk tek bir mesaj gibi görünür; aslında ertesi gün ikinci mesaj, bazen de iptal talebi demektir.
Aşağıda WhatsApp entegrasyonu için API yolunu — Meta onayı, BSP seçimi, numara, şablon ve fiyat mantığı — adım adım yazıyorum. Amaç genel ChatGPT botu değil; kendi katalog ve politikanızla konuşan bir iş asistanı kurmak.
Uygulama ile API aynı şey değil
WhatsApp Business uygulaması tek telefonda, sınırlı otomasyonla çalışır. Chatbot, çoklu temsilci, CRM kaydı ve toplu bildirim için resmi yol WhatsApp Business API’dir. API’nin arayüzü yoktur; yazılımınıza veya bir platforma bağlanır.
Erişim doğrudan Meta’dan değil, onaylı iş ortakları (BSP) üzerinden alınır. Günde onlarca mesaj alıyorsanız karar pratikte netleşir: chatbot veya AI asistan istiyorsanız API şart. Uygulamayla bu teknik olarak mümkün değil.
Bir de şu karışıklık var: “Business uygulamasına bağlı chatbot eklentisi” diye satılan üçüncü parti araçlar bazen uygulama sınırını zorlar. Resmi, ölçeklenebilir ve Meta politikasına oturan yol API’dir. Şüphede kalırsanız BSP’ye “bu numara Cloud API / On-Prem hangisi?” diye sorun; cevabı net olmayan partnerle ilerlemeyin.
WhatsApp Business API Türkiye: kurulum adımları
Türkiye’de süreç kağıt üzerinde “birkaç tık” gibi anlatılır. Sahada yedi adım çıkar; sırayı bozmak genelde onay veya numara aşamasında geri tepiyor.
Meta Business Manager ve işletme doğrulaması. Ticaret sicil, vergi levhası veya D-U-N-S ile doğrulama birkaç iş günü sürebilir. Beklerken bilgi bankası ve senaryoyu hazırlayın — boş beklemeyin.
BSP seçimi. Meta onaylı mı, Türkçe destek var mı, veri işleme taahhüdü KVKK’ya uyuyor mu, AI/webhook destekliyor mu? Fiyatı sadece “mesaj başı” diye okumayın; kurulum ve destek kalemi ayrı bakın.
Numara bağlama. Yeni numara veya mevcut iş numarası olur. Numara başka WhatsApp hesabında aktif olmamalı. Taşımada eski sohbet geçmişi API’ye gelmez — bunu ekibe önceden söyleyin, sürpriz olmasın.
AI modelini bağlama. Mesaj → webhook → model → yanıt → API. Hazır platform hızlıdır ama karmaşık iş kuralında dar kalır; özel webhook esnektir ama bakım ister. Trade-off’u baştan seçin.
Bilgi bankası. SSS, kargo/iade, ürün bilgisi yoksa bot genel konuşur. Bu adımı “sonra”ya bırakmak en pahalı kısayoldur.
Şablonlar ve 24 saat penceresi. İşletmenin ilk mesajı Meta onaylı şablon ister. Müşteri yazınca 24 saatlik pencere açılır; bot bu pencerede serbest formatta yanıtlar.
Test, yayın, ölçüm. Handover’ı mutlaka deneyin. Beklenmedik soruya “bilmiyorum, bağlayayım” diyebiliyor mu? Kurup unutulan bot üç ayda eskir.
WhatsApp müşteri hizmetleri tarafında otomasyon senaryolarını WhatsApp müşteri hizmetleri kurulum yazısında topluyoruz. Satış hunisi için mevcut WhatsApp AI asistan satış hunisi rehberi de işe yarar. Sipariş alma akışı için otomatik sipariş alma yazısına bakın.
Fiyat mantığı: neye para ödersiniz?
WhatsApp tarafında fatura “bot ücreti” ile karışmasın. Üç katman var ve her biri ayrı satırda görünür:
Meta konuşma ücreti: müşterinin başlattığı ve işletmenin başlattığı konuşmalar farklı fiyatlanır. Kategori (pazarlama / fayda / kimlik) şablonda seçilir.
BSP / platform ücreti: numara barındırma, panel, webhook, bazen AI katmanı.
AI / bilgi bankası maliyeti: model çağrısı veya yönetilen asistan paketi.
Pratikte en sık sürpriz: pazarlama şablonunu “ucuz bilgilendirme” sanıp yüksek hacimde yakmak. Sipariş onayı ve kargo güncellemesi fayda kategorisine oturur; kampanya duyurusu pazarlamaya. Karıştırmayın.
İkinci sürpriz: 24 saat penceresi kapandıktan sonra “hatırlatma” diye serbest mesaj atmaya çalışmak. Şablon zorunlu; onay beklerken müşteri soğur. Bu yüzden kritik bildirimleri (kargo çıktı, randevu yarın) pencere içinde veya onaylı fayda şablonuyla planlayın.
Hacim eşiği de fiyat kadar önemli. Günde beş mesaj alıyorsanız standart uygulama yeter; API sözleşmesi erken olur. Ama gece mesajları sabaha kalıyor ve aynı “kargo nerede” on kez yazılıyorsa beklemenin kendisi maliyet.
2026 kuralı: ne yasak, ne değil
Meta, genel amaçlı AI asistanlarının WhatsApp Business API üzerinden dağıtımını kısıtladı. İşletmenin kendi müşteri hizmeti, sipariş, randevu veya destek botu bu yasağın dışında — kanalın tasarlandığı kullanım tam olarak bu.
“ChatGPT’yi WhatsApp’a bağlayayım” ile “kendi katalogumla sipariş alan asistan” aynı şey değil. İlki politika riski; ikincisi iş kanalı. Chatbot’tan AI asistana geçişin ürün tarafını WhatsApp yapay zeka chatbot yazısında ayrıca işliyoruz.
KVKK ve sahada kırılan yerler
WhatsApp uçtan uca şifreli olsa da API’de işlediğiniz veri sizin sorumluluğunuzda. İlk temasta kısa aydınlatma, gerektiğinde açık rıza, “dijital asistan” olduğunu baştan söylemek. Veriyi gerekenden fazla toplamayın — doğum tarihi istemeden kargo sorgusu yapılabiliyorsa istemeyin.
Sahada en sık kırılan iki yer: +90 / 0 numara eşleşmesi (CRM’de çift kayıt) ve handover’sız bot (müşteri duvara çarpar). Staging’de çalışan webhook’un prod’da sessizce düşmesi de klasik; log yoksa “bot cevap vermiyor” diye üç gün kaybedersiniz.
Bir de şablon reddi. Meta “indirim”, “son şans”, agresif CTA dilini pazarlama şablonunda sık geri çevirir. Metni yazarken abartılı vaat cümlesini kesmek, onay süresini kısaltır.
Ne zaman kurun
Mesaj hacmi ekibi yormuyor, yanıtlar dakikalar içinde gidiyorsa API yatırımı erken. Eşiği geçtiyseniz zincir: doğru BSP → KVKK’sı düşünülmüş kurulum → bilgi bankası → ölçülen handover.
AI Agent TR tarafında WhatsApp dahil kurulum genelde 48 saatte ayağa kalkar; kendi senaryonuzu test etmek için ücretsiz demo talep edin. Yanıt süresi hedefi 0,3 sn civarında tutulabilir; Türkçe dahil 5 dil desteği planlanıyorsa bunu kurulumda söyleyin. Başlamak için /kur üzerinden ilerleyin.
Örnek akış: e-ticaret gece siparişi
Müşteri 23:12’de yazar: “Bu tişört M var mı, yarın kargo?” Bot stok API’sine bakar, beden varsa görseli ve fiyatı (sistemden) gönderir, sipariş formunu başlatır. Ödeme linki veya kapıda ödeme seçeneği işletme kuralınıza göre açılır. Onaydan sonra fayda şablonuyla “sipariş alındı” düşer.
Stok yoksa bot uydurmaz: “M şu an yok, L ve S var; haberdar olayım mı?” der. Haberdar listesi CRM’e düşer. Bu akışın çalışması için stok servisinin timeout’u ve hata mesajı talimata yazılmış olmalı. Servis 3 saniye cevap vermezse bot “biraz bekleyin” deyip tekrar dener veya insana bırakır — sonsuz “bir saniye” döngüsü müşteriyi kaçırır.
Sağlık/estetik tarafta aynı iskelet randevuya döner: slot sor, teyit al, hatırlatma şablonu. Yurt dışı hasta için İngilizce veya Arapça cevap, bilgi bankasında çeviri tutarlılığı ister. Dil karıştırmak (bir cümle TR bir cümle EN) güven kırar; dil seçimini ilk mesajda kilitleyin.
Kontrol listesi (yayın öncesi)
Meta Business doğrulandı, yeşil tik / resmi ad tutarlı mı?
BSP sözleşmesinde veri lokasyonu ve alt işleyenler yazılı mı?
En az üç fayda şablonu onaylı mı (sipariş, kargo, randevu)?
Handover: mesai içi kuyruk, mesai dışı mesaj kaydı test edildi mi?
CRM’de +90 normalizasyonu var mı?
Fallback ve çözüm oranı paneli ilk günden açık mı?
Liste sıkıcı duruyor. Sahada “bot cevap vermiyor” krizinin yüzde çoğu bu maddelerin birinden çıkar. Yayın günü heyecanına kurban etmeyin.
Sıkça Sorulan Sorular
WhatsApp Business API Türkiye’de nasıl alınır?
Meta Business doğrulaması + onaylı bir BSP üzerinden. Doğrudan Meta’dan “API anahtarı” alıp başlamıyorsunuz; BSP paneli üzerinden başvuru ve numara bağlama yapılır.
WhatsApp entegrasyonu için teknik ekip şart mı?
Hazır AI platformunda hayır. Kendi webhook’unuzu yazacaksanız sunucu, imza doğrulama ve hata log’u bilmeniz gerekir. Doküman okumadan anahtar yapıştırmak en pahalı kısayol.
Maliyet neye göre değişir?
Konuşma kategorisi (Meta), BSP/platform ücreti ve AI katmanı. Pazarlama şablonunu yüksek hacimde kullanmak faturayı şişiren klasik hatadır.
2026’da WhatsApp’ta AI chatbot yasal mı?
İşletmeye özel müşteri hizmeti, sipariş ve randevu botları uygun kullanım. Yasak genel amaçlı AI dağıtımını hedefliyor.
Mevcut numaramı taşıyabilir miyim?
Evet; sohbet geçmişi aktarılmaz ve numara bir süre standart WhatsApp’ta kullanılamaz. BSP süreçte yol gösterir.
