WhatsApp Business API Rehberi: Kurulum, Ücretlendirme ve Kurallar

Müşterileriniz zaten WhatsApp'ta. Sipariş durumu, randevu hatırlatması, destek talebi ya da kampanya duyurusu için onlara en çok okudukları kanaldan ulaşmak cazip. Ancak bir telefona kurulu WhatsApp Business uygulaması, birkaç kişinin ötesine geçen ekipler ve otomasyon için yetersiz kalır. Bu noktada WhatsApp Business Platform, yaygın adıyla WhatsApp Business API devreye girer. Bu rehberde API'nin ne olduğunu, uygulamadan farkını, ücretlendirme mantığını ve doğru kurulum adımlarını anlatıyoruz.

Kısa cevap: WhatsApp Business API (WhatsApp Business Platform), işletmelerin WhatsApp'ı CRM, e-ticaret veya destek sistemine bağlayarak çok temsilcili, otomatik ve ölçeklenebilir mesajlaşma yapmasını sağlar. Meta'nın Cloud API'si veya bir iş ortağı üzerinden erişilir; şablon mesajlar kategoriye ve ülkeye göre mesaj başına ücretlendirilir ve kullanıcı onayı şarttır.

WhatsApp Business uygulaması ile API arasındaki fark

Not: Bir telefon numarası genellikle aynı anda hem uygulamada hem API'de kullanılamaz; numaranın taşınma koşullarını Meta'nın güncel dokümantasyonundan kontrol edin.

API'ye nasıl erişilir?

İki ana yol vardır:

• Cloud API (Meta tarafından barındırılan): Meta'nın sunduğu bulut altyapısı üzerinden doğrudan entegrasyon. Kendi yazılımınızı veya bir geliştirici ekibini doğrudan bağlarsınız.
• İş ortağı (BSP) üzerinden: Meta'nın iş çözümü sağlayıcıları, hazır panel, chatbot kurucusu ve destek sunar. Kolaylık sağlar, ancak sağlayıcının kendi ücretleri Meta ücretlerine eklenebilir.

Mesaj kategorileri ve ücretlendirme

Meta, 1 Temmuz 2025 itibarıyla konuşma bazlı ücretlendirmeden mesaj bazlı ücretlendirmeye geçti. Ücret, gönderilen şablon mesajın kategorisine ve alıcının ülkesine göre belirlenir. Tarifeler dönemsel olarak güncellendiği için rakam vermek yerine mantığı açıklıyoruz; güncel fiyatları Meta'nın fiyatlandırma sayfasından kontrol edin.

24 saatlik müşteri hizmetleri penceresi

Müşteri size mesaj attığında 24 saatlik bir pencere açılır. Bu pencere içinde şablon zorunluluğu olmadan serbest metinle yanıt verebilirsiniz. Pencere dışında müşteriye ilk mesajı ancak önceden onaylanmış bir şablonla gönderebilirsiniz.

Güncel değişikliklere dikkat

Meta, pencere içindeki hizmet ve utility mesajlarının ücretlendirmesinde 2026 itibarıyla değişiklikler duyurmuştur; tıkla-WhatsApp'a reklamlarla açılan konuşmalar için de ayrı ücretsiz pencere kuralları vardır. Bu ayrıntılar değişebildiği için bütçe planlamadan önce resmî fiyatlandırma sayfasını kontrol edin.

Kurulum adımları

1. Meta Business hesabı: İşletmeniz için bir Meta Business portföyü oluşturun ve mümkünse işletme doğrulamasını tamamlayın.
2. Telefon numarası: API için kullanılacak, SMS veya sesli arama ile doğrulanabilen bir numara belirleyin.
3. Görünen ad: WhatsApp'ta görünecek işletme adı Meta'nın görünen ad kurallarına uygun olmalıdır.
4. Erişim yöntemi: Cloud API ile doğrudan mı, yoksa bir iş ortağı üzerinden mi ilerleyeceğinize karar verin.
5. Webhook: Gelen mesajları ve mesaj durumlarını (iletildi, okundu) almak için sunucunuzda bir webhook adresi kurun.
6. Şablonlar: İlk mesaj olarak gönderilecek şablonları hazırlayıp onaya gönderin. Kategoriyi doğru seçin; yanlış kategorideki şablonlar Meta tarafından yeniden sınıflandırılabilir.
7. Ödeme yöntemi: Ücretli mesajlar için hesabınıza ödeme yöntemi ekleyin.
8. Test ve yayın: Kendi numaralarınızla test edin, ardından gerçek kullanıcılara açın.

İyi şablon yazmanın kuralları

• Mesajın amacını ilk cümlede söyleyin.
• Değişkenleri (müşteri adı, sipariş no) anlamlı yerlerde kullanın; şablonu sadece değişkenden oluşturmayın.
• Hizmet bildirimlerine pazarlama dili karıştırmayın; aksi hâlde şablon pazarlama olarak sınıflandırılabilir.
• Hızlı yanıt veya bağlantı butonları ile kullanıcının bir sonraki adımını kolaylaştırın.
• Kısa tutun; WhatsApp bir sohbet kanalıdır, bülten değil.

İzin, KVKK ve mesaj kalitesi

WhatsApp, işletmelerin kullanıcıya mesaj göndermeden önce onay (opt-in) almasını şart koşar. Türkiye'de ise ayrıca:

• Kampanya içerikli ticari elektronik iletiler için alıcının onayı gerekir ve bu izinlerin İleti Yönetim Sistemi (İYS) kapsamında değerlendirilmesi gerekebilir; hukukçunuzla netleştirin.
• Telefon numarası bir kişisel veridir; aydınlatma metninde WhatsApp üzerinden iletişim kurulacağını ve verinin yurt dışındaki altyapıda işlenebileceğini belirtin. Ayrıntılar için KVKK kontrol listemize bakın.

Kullanıcılar mesajlarınızı engellerse veya şikâyet ederse numaranızın kalite puanı düşer ve gönderim limitleriniz kısıtlanabilir. Bu yüzden sadece izin veren ve ilgilenen kişilere, değerli mesajlar gönderin.

Entegrasyon senaryoları

• E-ticaret: Sipariş onayı, kargo takip bağlantısı, teslimat bildirimi (e-ticaret altyapısı yazımız).
• Randevulu işletmeler: Randevu hatırlatma ve tek dokunuşla onay/iptal.
• Destek: Chatbot ile sık sorulan sorulara anında yanıt, karmaşık konularda temsilciye aktarma.
• Otomasyon: CRM'deki bir durum değişikliğinde otomatik bildirim; bu tür akışlar n8n gibi otomasyon araçlarıyla da kurulabilir.

Teknik mimari: mesajlar nasıl akar?

WhatsApp Business API'yi kendi sisteminize bağladığınızda temel akış şu şekildedir:

1. Giden mesaj: Sisteminiz (CRM, e-ticaret, panel) Cloud API'ye bir istek gönderir; istekte alıcı numarası, şablon adı ve değişkenler bulunur.
2. Durum bildirimleri: Mesajın gönderildi, iletildi, okundu veya başarısız olduğu bilgisi webhook ile sisteminize geri döner.
3. Gelen mesaj: Müşteri yanıt verdiğinde mesaj yine webhook ile sisteminize ulaşır; 24 saatlik pencere açılır.
4. Yanıt: Temsilci panelden veya chatbot otomatik olarak yanıt verir.

Bu yapıda webhook adresinizin sürekli erişilebilir, hızlı yanıt veren ve gelen isteklerin Meta'dan geldiğini imza ile doğrulayan bir servis olması gerekir. Erişim belirteçleri (access token) güvenli şekilde saklanmalı, asla ön yüz koduna veya mobil uygulamaya gömülmemelidir.

Gönderim limitleri ve kalite puanı

Yeni bir numara, başlangıçta belirli sayıda farklı kullanıcıya mesaj başlatabilir. Bu limit, numaranın kalitesi ve gönderim geçmişi iyi olduğu sürece kademeli olarak yükselir.

Limitlerin güncel değerleri ve kuralları Meta tarafından değiştirilebildiği için resmî dokümantasyonu takip edin.

Chatbot tasarlarken dikkat edilecekler

• Amacı daraltın: Chatbot her şeyi yapmaya çalışmasın; sipariş sorgulama, randevu alma veya sık sorulan sorular gibi net görevlere odaklansın.
• Butonlarla yönlendirin: Serbest metin yerine hızlı yanıt butonları ve listeler, kullanıcının doğru yola girmesini kolaylaştırır.
• İnsana aktarım: "Temsilciyle görüşmek istiyorum" seçeneği her zaman bulunmalıdır.
• Mesai dışı yanıt: Temsilcilerin çalışmadığı saatlerde ne zaman dönüş yapılacağını açıkça yazın.
• Yapay zekâ kullanımı: Dil modeli tabanlı yanıtlar esneklik sağlar; ancak fiyat, iade koşulu gibi kritik bilgileri doğrulanmış kaynaklardan almalı ve uydurma bilgi vermemesi için sınırlandırılmalıdır.

Ekip ve süreç

Teknik kurulum kadar, mesajlara kimin ve ne kadar sürede cevap vereceği de önemlidir.

1. Gelen mesajların hangi ekibe düşeceğini (satış, destek, muhasebe) belirleyin.
2. Hedef yanıt sürelerini tanımlayın ve izleyin.
3. Sık kullanılan yanıtlar için onaylı metinler hazırlayın.
4. Konuşma geçmişinin CRM'de müşteri kaydıyla eşleşmesini sağlayın.
5. Hassas bilgilerin (kart numarası, şifre) WhatsApp üzerinden istenmemesi kuralını ekibe bildirin.

Başarıyı ölçmek

Hangi şablonların okunduğunu, hangi bildirimlerin destek taleplerini azalttığını ve kampanya mesajlarının satışa dönüşüp dönüşmediğini izlemek için mesaj durum verilerini ve bağlantı tıklamalarını analiz edin. Bağlantılarda UTM parametreleri kullanmak, WhatsApp'tan gelen trafiği analiz aracınızda ayrı görmenizi sağlar. Pazarlama mesajlarının maliyetini, ürettikleri gelirle karşılaştırmak, bütçeyi doğru kanala yönlendirmenize yardımcı olur.

Sektörlere göre kullanım örnekleri

Uygulamadan API'ye geçiş planı

Şu anda WhatsApp Business uygulamasını kullanıyor ve API'ye geçmeyi düşünüyorsanız, kesintisiz bir geçiş için şu adımları izleyebilirsiniz:

1. Mevcut kullanımı çıkarın: Günde kaç mesaj geliyor, kim cevaplıyor, en sık sorulan sorular neler?
2. Hedefi belirleyin: Ortak gelen kutusu mu, otomatik bildirimler mi, chatbot mu, hepsi mi?
3. Sohbet geçmişini yedekleyin: Taşıma sırasında mevcut sohbetlerin etkilenebileceğini göz önünde bulundurun.
4. Şablonları önceden onaylatın: Geçiş günü bildirimlerin hazır olması için şablonları erken gönderin.
5. Ekibi eğitin: Yeni panelin kullanımı, etiketleme ve devretme kuralları.
6. Müşterileri bilgilendirin: Numara aynı kalsa bile yanıt süreleri ve mesai saatleri hakkında kısa bir bilgilendirme yapın.
7. İlk haftayı yakından izleyin: Teslim edilemeyen mesajlar, yanıt süreleri ve kalite puanı.

Geçişin teknik tarafını kendi sistemlerinizle entegre etmek veya otomasyon akışları kurmak için n8n otomasyon rehberimizden fikir alabilirsiniz.

Sık yapılan hatalar

• Onaysız kişilere mesaj göndermek: Hem politika ihlalidir hem de kalite puanını hızla düşürür.
• Her şeyi pazarlama şablonuyla göndermek: Gereksiz maliyet yaratır ve kullanıcıları rahatsız eder; hizmet bildirimlerini doğru kategoride tutun.
• Webhook'u güvensiz bırakmak: Gelen isteklerin imzasını doğrulamamak, sahte isteklerin sisteminize işlenmesine yol açabilir.
• Erişim belirteçlerini koda gömmek: Belirteçler sızarsa numaranız adına mesaj gönderilebilir; güvenli bir gizli bilgi deposunda saklayın.
• Yanıt süresini planlamamak: Müşteri WhatsApp'ta hızlı cevap bekler; mesai dışı ve yoğun saatler için plan yapın.
• Opt-out'u zorlaştırmak: Kullanıcının mesaj almayı bırakmasını kolaylaştırın; aksi hâlde engelleme ve şikâyet artar.
• Ölçüm yapmamak: Hangi şablonun işe yaradığını bilmeden bütçe harcamak, kaynakların verimsiz kullanılmasına neden olur.

Terimler sözlüğü

• WhatsApp Business Platform: Meta'nın işletmeler için sunduğu, API tabanlı WhatsApp mesajlaşma altyapısı.
• Cloud API: Meta tarafından barındırılan, doğrudan entegre edilebilen WhatsApp API sürümü.
• BSP: Meta'nın onaylı iş çözümü sağlayıcısı; panel, chatbot ve destek sunan iş ortağı.
• Mesaj şablonu: Meta onayından geçmiş, 24 saatlik pencere dışında ilk mesaj olarak gönderilebilen kalıp mesaj.
• Müşteri hizmetleri penceresi: Kullanıcının son mesajından itibaren 24 saat süren, serbest yanıt verilebilen dönem.
• Opt-in: Kullanıcının işletmeden mesaj almayı kabul etmesi.
• Kalite puanı: Kullanıcı tepkilerine göre belirlenen ve gönderim limitlerini etkileyen numara puanı.

Özetle: akılda kalması gerekenler

• API; çok temsilcili, otomatik ve entegre WhatsApp iletişimi için tasarlanmıştır.
• Ücretlendirme mesaj bazlıdır; şablon kategorisi ve alıcı ülkesi fiyatı belirler.
• 24 saatlik pencere dışında ilk mesaj onaylı bir şablonla gönderilir.
• Kullanıcı onayı (opt-in) şarttır; Türkiye'de İYS ve KVKK gerekliliklerini de değerlendirin.
• Webhook ve erişim belirteçlerinin güvenliğini ihmal etmeyin.
• Kalite puanını korumak için sadece ilgili ve beklenen mesajlar gönderin.

Sık Sorulan Sorular

WhatsApp Business API ücretsiz mi?

API'ye erişim için ayrı bir abonelik ücreti yoktur; ancak şablon mesajlar kategoriye ve ülkeye göre ücretlendirilir. Bir iş ortağı kullanıyorsanız onun ücretleri de eklenir.

Mevcut WhatsApp numaramı API'ye taşıyabilir miyim?

Genellikle evet, ancak taşıma sırasında numaranın uygulamadaki kullanımı ve sohbet geçmişi etkilenebilir. Meta'nın güncel taşıma koşullarını okuyun ve önce yedek alın.

Herkese toplu mesaj gönderebilir miyim?

Hayır. Yalnızca onay vermiş kullanıcılara, onaylı şablonlarla mesaj gönderebilirsiniz. Onaysız toplu gönderim hem politika ihlalidir hem de numaranızın kısıtlanmasına yol açar.

Chatbot şart mı?

Şart değil. Birçok işletme için ortak gelen kutusu ve otomatik bildirimler yeterlidir. Soru hacmi arttıkça chatbot eklemek mantıklı hâle gelir.

Mesaj şablonlarının onayı ne kadar sürer?

Çoğu şablon kısa sürede değerlendirilir; ancak süre değişebilir ve bazı şablonlar reddedilebilir. Yayın tarihinden önce şablonları onaya göndermek sürpriz yaşamamanızı sağlar.

WhatsApp'tan gelen müşteri verisini CRM'e aktarabilir miyim?

Evet, webhook ile gelen mesajlar ve müşteri numarası CRM'inize kaydedilebilir. Bu işlem kişisel veri işleme olduğu için aydınlatma yükümlülüğünü yerine getirmeniz gerekir.

Birden fazla temsilci aynı numarayı kullanabilir mi?

API ile kurulan ortak gelen kutusu çözümlerinde aynı numaraya gelen mesajlar birden fazla temsilciye dağıtılabilir.

Sonuç

WhatsApp Business API, müşterilerinizle en çok kullandıkları kanalda ölçeklenebilir ve otomatik iletişim kurmanızı sağlar. Başarının anahtarı doğru kategori seçimi, izin yönetimi ve sisteminizle sağlam bir entegrasyondur. WhatsApp'ı CRM'iniz, e-ticaret siteniz veya randevu sisteminizle entegre etmek isterseniz özel yazılım hizmetimizi inceleyebilir, bizimle iletişime geçebilirsiniz.

Kaynaklar

• Meta for Developers – WhatsApp Business Platform fiyatlandırması
• Meta for Developers – WhatsApp Cloud API
• Meta for Developers – Mesaj şablonları
• WhatsApp Business Mesajlaşma Politikası
• İleti Yönetim Sistemi (İYS)