WhatsApp Business API Nedir? İşletmeler İçin Rehber

Bir müşteri "siparişim nerede" diye WhatsApp'tan yazdığında, elle cevap veren biri mi var, yoksa sistem mi otomatik yanıtlıyor? Bu sorunun cevabı, işletmenizin WhatsApp Business App mı yoksa WhatsApp Business Platform (Cloud API) mi kullandığına bağlı. İkisi aynı isimle anılsa da farklı işler için tasarlandı — bu yazı ikisi arasındaki gerçek farkı, API'nin neyi mümkün kıldığını ve kurallarını Meta'nın kendi dokümantasyonuna dayanarak anlatıyor.

Özet

• WhatsApp Business App manuel kullanım içindir; Business Platform (API) sistemlere bağlanan, otomasyon için tasarlanmış bir altyapıdır.
• API üzerinden otomatik yanıt, sipariş/randevu bildirimi, CRM entegrasyonu ve kendi verinizden yanıtlayan chatbot kurulabilir.
• 24 saatlik müşteri hizmeti penceresinin dışına çıkan her mesaj, Meta onaylı bir şablon (template) gerektirir.
• Kullanıcıya mesaj göndermeden önce açık, kanal belirten bir opt-in şart — bu bir öneri değil, Meta politikası.
• Fiyatlandırma 1 Temmuz 2025'te konuşma bazlıdan şablon mesaj başına ücrete geçti; güncel oranlar için Meta'nın resmî sayfasına bakılmalı.

WhatsApp Business App ile WhatsApp Business Platform (API) arasındaki fark

WhatsApp Business App, küçük işletmelerin telefonlarına indirip kullandığı ücretsiz bir uygulama. İşletme profili, katalog, otomatik karşılama mesajı gibi temel özellikler sunuyor ama elle yönetiliyor — birileri telefonu açıp mesajlara bakmak zorunda.

WhatsApp Business Platform, Meta'nın kendi tanımıyla "işletmelerin WhatsApp üzerinden programatik olarak mesaj gönderip alabildiği" bir altyapı. Uygulama değil; CRM'inize, e-ticaret sisteminize veya bir yapay zekâ asistanına doğrudan bağlanan bir API. Bu, mesajın bir insan tarafından değil, önceden tanımlanmış bir kural veya bir yapay zekâ modeli tarafından gönderilebildiği anlamına geliyor.

Kriter	WhatsApp Business App	WhatsApp Business Platform (API)
Kullanım şekli	Telefondan manuel	Sisteme entegre, programatik
Maliyet	Ücretsiz	Şablon mesaj başına ücretli
Otomasyon	Sınırlı (temel karşılama/uzakta mesajı)	Tam otomasyon, kural veya AI tabanlı
Ekip erişimi	Tek cihaz / kısıtlı çoklu cihaz	Sınırsız sistem entegrasyonu
CRM / e-ticaret bağlantısı	Yok	Webhook ve API üzerinden doğrudan
Mesaj hacmi	Düşük-orta, elle takip edilebilir	Yüksek hacim, saniyede çok sayıda mesaj
Onay süreci	Yok	WABA kurulumu + şablon onayı gerekir
Hedef kitle	Tek kişi / küçük işletme	Büyüyen işletme, çok kanallı operasyon

API'nin işletmelere gerçekte kazandırdığı şeyler

Platform'un teknik detayları bir kenara, işletme için pratik karşılığı şu beş alanda toplanıyor:

• Otomatik yanıt. Sık sorulan sorular (çalışma saati, adres, kargo süresi) insan beklemeden anında yanıtlanır.
• Katalog ve sipariş akışları. Ürün kataloğu WhatsApp içinde gösterilebilir, sipariş durumu değiştiğinde ("kargoya verildi", "teslim edildi") tetikleyici bazlı otomatik mesaj gider.
• Randevu hatırlatmaları. Randevu tarihi yaklaşınca otomatik hatırlatma gönderilir — resepsiyonun elle arayıp hatırlatmasına gerek kalmaz.
• CRM entegrasyonu. Gelen ve giden mesajlar mevcut sipariş, stok veya müşteri sistemine webhook'lar üzerinden bağlanır; bilgi elle taşınmaz.
• Kendi verisinden yanıtlayan chatbot. Asistan, genel internet bilgisiyle değil sizin ürün kataloğunuzdan, SSS'inizden veya politikalarınızdan (RAG mimarisiyle) yanıt üretir; emin olmadığında konuşmayı bir insana devreder.

Şablon mesajlar (template) ve 24 saatlik müşteri hizmeti penceresi

WhatsApp'ta iki tür mesaj var: serbest metin mesajları ve şablon mesajlar. Kullanıcı size son 24 saat içinde bir mesaj gönderdiyse, bu "müşteri hizmeti penceresi" açık demektir ve içinde istediğiniz serbest metni gönderebilirsiniz. Ama pencere kapandıysa ya da konuşmayı ilk siz başlatıyorsanız, Meta'nın kendi dokümantasyonuna göre "müşteri hizmeti penceresinin dışında WhatsApp kullanıcılarına gönderilebilecek tek mesaj türü şablon mesajlardır."

Şablonlar önceden Meta'ya gönderilip onaylanır ve üç kategoriden birine ayrılır:

1. Marketing (pazarlama) — kampanya, duyuru, yeniden hedefleme.
2. Utility (hizmet amaçlı) — kullanıcının bir eylemine bağlı takip mesajı: sipariş onayı, randevu hatırlatması, teslimat güncellemesi.
3. Authentication (kimlik doğrulama) — tek kullanımlık şifre (OTP), kimlik doğrulama kodu.

Kategori seçimi gösteriş değil — Meta, şablonun içeriğini kategoriyle karşılaştırıp doğruluyor; yanlış kategoriyle gönderilen bir şablon reddedilebiliyor veya sonradan yeniden sınıflandırılabiliyor.

Opt-in kuralları: kime, nasıl mesaj gönderebilirsiniz

Bu, çoğu işletmenin atladığı ama Meta'nın en sıkı denetlediği kural: resmî opt-in dokümantasyonuna göre işletmeler mesaj göndermeden önce kullanıcıdan açık onay almalı ve bu onay sürecinde işletmenin adını ve hangi amaçla WhatsApp üzerinden iletişim kurulacağını net şekilde belirtmeli. Kabul edilen opt-in yöntemleri arasında SMS, web sitesi formu, telefonla IVR akışı ve yüz yüze/kağıt üzerinde imzalanan onay sayılıyor.

Fiyatlandırma modeli nasıl işliyor

WhatsApp Business Platform'un fiyatlandırması son yıllarda değişti ve değişmeye devam ediyor; bu yüzden burada kesin rakam vermek yerine modeli anlatıyoruz. Meta'nın resmî fiyatlandırma sayfasına göre 1 Temmuz 2025'te ücretlendirme, "konuşma bazlı fiyatlandırmadan mesaj bazlı fiyatlandırmaya" geçti — yani artık 24 saatlik bir konuşma penceresi için değil, gönderilen her şablon mesaj için ücret alınıyor. Ücret, şablonun kategorisine (marketing, utility, authentication) ve alıcının ülke koduna göre değişiyor.

Aynı sayfaya göre bazı mesaj türleri ücretsiz: müşteri hizmeti penceresi içindeki serbest metin mesajları, açık pencere içinde gönderilen utility şablonları ve kullanıcının bir reklam veya sayfa CTA'sı üzerinden başlattığı konuşmalarda ilk 72 saat içindeki mesajlar. Fiyatlandırma modelinin kendisi son bir yılda birkaç kez değiştiği için, projenizin bütçesini planlarken güncel oranları doğrudan Meta'nın fiyatlandırma sayfasından teyit etmenizi öneriyoruz — biz de her yeni proje kapsamında bu adımı birlikte yapıyoruz.

Kurulum adımları

API'yi kurmak bir "hesap aç, hemen başla" işi değil; Meta'nın Cloud API başlangıç kılavuzuna göre sıra şöyle işliyor:

1. Meta Geliştirici hesabı ve bir Meta App oluşturmak, App'e WhatsApp ürününü eklemek.
2. WhatsApp Business Hesabı (WABA) oluşturmak veya mevcut birini App'e bağlamak.
3. Telefon numarası eklemek ve doğrulamak — bu numara artık WhatsApp Business App'te kullanılamaz hâle gelir, tek bir numara iki sistemde aynı anda çalışmaz.
4. Erişim token'ı üretmek ve gelen mesaj/durum bildirimleri için bir webhook (callback URL) tanımlamak.
5. Göndereceğiniz şablon mesajları hazırlayıp Meta onayına sunmak — onay süresi işletme doğrulama durumuna göre değişebiliyor.
6. Test numarasıyla ilk mesajı göndermek, ardından gerçek entegrasyona (CRM, sipariş sistemi, chatbot) geçmek.

Bu adımların her biri teknik olarak basit görünse de, WABA'nın hangi işletme hesabına bağlı olacağı, hangi numaranın kullanılacağı ve şablonların hangi kategoriyle onaya gönderileceği gibi kararlar sonradan değiştirmesi zor kararlar — baştan doğru planlanmalı.

Yaygın hatalar

1. Opt-in almadan toplu mesaj göndermek. En sık görülen ve en ağır sonuçlu hata; hesap kısıtlaması veya askıya almayla sonuçlanabiliyor.
2. Yanlış şablon kategorisi seçmek. Bir hatırlatma mesajını "marketing" olarak göndermek hem onay sürecini uzatıyor hem de maliyeti farklılaştırabiliyor.
3. Chatbot'u insana devir mekanizması olmadan kurmak. Asistan emin olmadığı bir soruda uydurma yanıt verirse, güven kaybı WhatsApp'ın sağladığı hız avantajından daha büyük bir maliyete dönüşüyor.
4. Business App numarasıyla API'yi karıştırmak. Aynı numara iki sistemde birden aktif olamıyor; geçiş öncesi hangi numaranın hangi tarafta kalacağı netleştirilmeli.
5. Fiyatlandırmayı eski modele göre bütçelemek. Model değiştiği için geçen yılın rakamlarıyla bugünün bütçesini kurmak yanıltıcı olabiliyor; güncel oranlar her zaman Meta'nın kendi sayfasından teyit edilmeli.

Piton Studios'ta bu nasıl kuruluyor

WhatsApp & Chatbot hizmetimizde bu süreci uçtan uca yürütüyoruz: kapsam ve onay planlaması, içerik/akış tasarımı, Twilio veya Meta Cloud API üzerinden entegrasyon, yanıt kalitesi testi ve yayın sonrası izleme. İki somut senaryo üzerinde çalışıyoruz — WhatsApp satış ve sipariş botu e-ticaret sitelerinde sipariş durumu, terk edilmiş sepet hatırlatması ve ürün sorularını otomatikleştirirken, klinikler için WhatsApp randevu botu randevu talebi toplama ve hatırlatmayı, hasta verisini KVKK'ya uygun bir çerçevede işleyerek otomatikleştiriyor.

Sonuç

WhatsApp Business API, WhatsApp Business App'in "büyümüş hâli" değil — farklı bir amaç için tasarlanmış, sistemlere bağlanan bir altyapı. Otomatik yanıt, sipariş/randevu bildirimi ve kendi verinizden yanıtlayan bir chatbot kurmak istiyorsanız ihtiyacınız olan taraf bu. Ama işin kuralları net: 24 saatlik pencerenin dışına çıkan her mesaj onaylı bir şablon gerektiriyor, her mesajın arkasında geçerli bir opt-in olmalı ve fiyatlandırma modeli değişken olduğu için bütçe kararını her zaman Meta'nın güncel sayfasına bakarak vermek gerekiyor.

Projenizin hangi kapsamda olduğundan emin değilseniz iletişime geçin — ihtiyaç analizini ve Meta onay sürecini birlikte planlayalım.

Kaynaklar ve ileri okuma

1. Meta for Developers — About the WhatsApp Business Platform
2. Meta for Developers — WhatsApp Cloud API Get Started
3. Meta for Developers — Pricing on the WhatsApp Business Platform
4. Meta for Developers — Message Templates Overview
5. Meta for Developers — Template Categorization
6. Meta for Developers — Get Opt-In for WhatsApp