WhatsApp Business API Nedir? Uygulamadan Farkı ve Nasıl Alınır

WhatsApp Business API, işletmelerin WhatsApp mesajlarını telefondaki uygulama yerine bir yazılım üzerinden gönderip almasını sağlayan resmî arayüzdür. Meta bugün bu ürüne WhatsApp Business Platform diyor; tek resmî sürümü Cloud API. Uygulama bir telefondan elle yazışmak için tasarlanmıştır. API ise ekip panellerinin, sipariş sistemlerinin ve yapay zekâ asistanlarının WhatsApp'a bağlanmasını sağlar ve kendi kurallarıyla gelir: işletmenin başlattığı ilk mesaj onaylı şablonla atılır, serbest metinli yanıtlar 24 saatlik pencereye bağlıdır ve işletmenin gönderdiği mesajlar Meta tarafından ücretlendirilir.

WhatsApp'ta müşterilerinize yapay zekânın yanıt vermesini istiyorsanız kurulum adımları için: WhatsApp yapay zekâ asistanı rehberi.

WhatsApp Business API nedir, uygulamadan farkı ne?

WhatsApp'ın işletmelere sunduğu iki ayrı ürün var. WhatsApp Business uygulaması telefonunuza indirdiğiniz ücretsiz uygulamadır; işletme profili, katalog, etiketler, hızlı yanıtlar, karşılama ve uzakta mesajları içinde gelir. WhatsApp Business Platform ise yazılımların kullandığı katmandır. Meta'nın belgeleri platformun ana parçalarını şöyle sıralıyor: mesajlaşma ve aramayı sağlayan Cloud API, hesap, numara ve şablon yönetimi için Business Management API, pazarlama mesajları için Marketing Messages API ve Meta'nın kendi yapay zekâ ajanı Meta Business Agent. Günlük dilde "WhatsApp Business API" denince kastedilen, bu platformun mesajlaşma parçası olan Cloud API'dir.

Kısacası uygulama "bir kişi, bir telefon", API ise "bir numara, birden çok kişi ya da yazılım" düzeni içindir.

Cloud API: bugün tek resmî WhatsApp API'si

Türkçe kaynakların bir kısmı WhatsApp API'yi hâlâ "büyük şirketlere uygun, kod bilmeden kullanılamayan" bir ürün olarak anlatıyor. Bu resim, API'nin işletmenin kendi sunucusuna kurulan On-Premises sürümüyle sunulduğu döneme ait ve artık geçerli değil:

• Meta, Mayıs 2022'de kendi altyapısında çalışan Cloud API'yi her ölçekten işletmeye açtı.
• 9 Ocak 2024'ten beri yeni özellikler yalnız Cloud API'ye geliyor; 1 Temmuz 2024'ten beri yeni numaralar yalnız Cloud API'ye kaydedilebiliyor.
• On-Premises API'nin son sürümü (v2.63) 23 Ekim 2025'te kullanım süresini doldurdu; bu tarihten sonra On-Premises'e kayıtlı numaralara mesaj teslim edilmiyor.

WhatsApp'ın kendi yazılımını sunucunuza kurmanız gerekmez: mesajlar Meta'nın altyapısında işlenir ve yazılımınıza webhook adı verilen bildirimlerle ulaşır. Kod yazmak da artık şart değil; iki erişim yolunu aşağıda anlatıyoruz.

Hangi işletmenin API'ye ihtiyacı var?

API'ye geçiş büyüklükten değil, belirli ihtiyaçlardan doğar. Aşağıdaki durumlardan biri size uyuyorsa API'yi değerlendirin:

• Aynı numarayı birden fazla kişi yanıtlıyor. Uygulamanın ücretsiz sürümünde bir ana telefon ve en çok dört bağlı cihaz var; kimin hangi konuşmaya baktığını izlemek zorlaşır.
• Mesajlar başka sistemlerle konuşmalı. Sipariş durumu, kargo bilgisi ya da müşteri geçmişi mesajın yanında görünsün istiyorsanız bu bağı API kurar.
• Yanıtları bir yapay zekâ asistanı versin istiyorsunuz. Uygulamadaki karşılama ve uzakta mesajı önceden yazılmış metinlerdir. Sipariş sisteminize bağlanıp mağaza verisiyle yanıt veren bir asistan WhatsApp'a API üzerinden bağlanır.
• Birden çok kanalı tek yerden yönetmek istiyorsunuz. Instagram DM ve Messenger konuşmalarını WhatsApp ile aynı gelen kutusunda toplayan ekip araçları WhatsApp'a genellikle API üzerinden bağlanır.
• Sistemden otomatik bildirim gidecek. Sipariş onayı ya da kargo bildirimi gibi işletmenin başlattığı mesajlar onaylı şablon ve API ister.

Günde birkaç mesaj alan, tek kişinin yanıt verdiği bir mağaza için uygulama hâlâ en sade yoldur. Müşteri hizmetlerinin hangi kısmının otomatikleştirilebileceğini e-ticaret müşteri hizmetleri otomasyonu rehberinde ayrıntılı anlattık.

WhatsApp Business API nasıl alınır: 5 adım

API'ye iki yoldan erişirsiniz: Meta'nın geliştirici araçlarıyla kendi entegrasyonunuzu yazarak ya da API bağlantısını hazır sunan bir yazılımın içinden. İkinci yolda genellikle Meta'nın Embedded Signup adlı resmî bağlantı penceresi açılır; adımlar Meta'nın kendi ekranlarında ilerler ve yazılım, erişim yetkisini sizden şifre ya da erişim anahtarı (token) istemeden Meta'dan alır. Adımların mantığı iki yolda da aynıdır:

1. İşletme portföyünü hazırlayın. Platformu kullanmak için Meta Business Suite'te bir işletme portföyü şarttır. Facebook hesabınızla giriş yapıp mevcut portföyü seçer ya da yenisini oluşturursunuz.
2. WhatsApp hesabını oluşturun ya da seçin. Numaranız, görünen adınız ve profiliniz bu hesapta durur; şablonlar ve faturalama ona bağlı mesajlaşma hesabında yönetilir.
3. Numarayı ekleyip doğrulayın. Numara size ait olmalı, ülke ve alan kodu taşımalı (kısa numara olmaz), SMS ya da sesli arama alabilmeli. WhatsApp'ta kullanılan bir numaranın oradaki hesabı önce silinmelidir; numarayı bırakmadan geçme seçeneği listenin altında.
4. Görünen adı girin. Müşterinin numaranız yerine göreceği işletme adıdır ve Meta'nın ad kurallarına uymalıdır. Mesaj sınırınız yükseldiğinde ad otomatik incelemeden geçer.
5. Ödeme yöntemini ve bağlantıyı tamamlayın. Meta'nın mesaj ücretleri için mesajlaşma hesabında bir ödeme yöntemi tanımlanır; ödeme yöntemi olmayan hesaplarda aylık ücretsiz kota dolunca servis mesajları teslim edilmez. Ödeme yönteminin sizin hesabınızda mı, çalıştığınız sağlayıcı üzerinden mi yönetileceğini sağlayıcınıza sorun. Son olarak yazılım numarayı Cloud API'ye kaydeder ve gelen mesajları dinlemeye başlar.

Mevcut numaranızı taşıyorsanız ya da aynı numarada uygulamayı da kullanmaya devam etmek (coexistence) istiyorsanız adımlar değişir; bu senaryoyu WhatsApp Business uygulamasından API'ye geçiş rehberinde anlattık.

Mesaj kuralları ve ücretlendirme kısaca

API'yi uygulamadan en çok ayıran şey kurallardır:

• 24 saatlik pencere. Müşteri size yazdığında 24 saatlik müşteri hizmeti penceresi açılır ve her yeni mesajında yeniden başlar. Pencere açıkken serbest metin, görsel ve etkileşimli mesaj gönderebilirsiniz; kapandıktan sonra yalnız onaylı şablonla yazabilirsiniz. Ayrıntılar: WhatsApp 24 saat kuralı.
• Şablonlar. Konuşmayı işletme başlatacaksa mesaj Meta'nın onayladığı bir şablon olmalı. Şablonlar pazarlama, hizmet (utility) ve kimlik doğrulama kategorilerine ayrılır; inceleme 24 saate kadar sürebilir.
• Mesaj sınırı. Pencere dışında, 24 saatlik kayan sürede ulaşabileceğiniz farklı kişi sayısı sınırlıdır. Yeni işletme portföyü 250 kişiyle başlar ve işletme doğrulaması gibi bir ölçekleme yoluyla 2.000'e çıkar. Sonrasında mesaj kalitesi yüksek kaldıkça ve son 7 günde sınırın en az yarısı kullanıldıkça sınır kendiliğinden 10.000, 100.000 ve sınırsıza yükselir. 8 Ekim 2025'ten beri mesaj sınırı numara başına değil, işletme portföyü başına hesaplanıyor. Pencere içinde verdiğiniz yanıtlar bu sınıra sayılmaz.
• Ücret. Meta 1 Temmuz 2025'ten beri konuşma başına değil, teslim edilen mesaj başına ücret alıyor; müşteriden gelen mesajlar ücretsiz. 1 Ekim 2026'dan itibaren pencere içindeki yanıtlar (servis mesajları) da yeniden ücretli, ancak her işletme numarasına ayda 1.000 servis mesajı ücretsiz. Kategori kategori rakamlar için: WhatsApp Business API fiyatları.
• İnsana ulaşma yolu. WhatsApp politikası pencere içinde otomatik yanıtlara izin veriyor; ama müşterinin yardıma hızlı ve doğrudan ulaşabileceği bir yol (temsilciye aktarma, telefon, e-posta ya da destek formu gibi) bulunmalı.

Mavi tik: resmî işletme hesabı şartları

Aramalarda hâlâ "WhatsApp yeşil tik" deniyor; ancak WhatsApp bugün doğrulanmış işletmeler için mavi onay işareti kullanıyor. API tarafında bu rozetin adı Official Business Account (OBA), yani resmî işletme hesabı. Meta'nın OBA şartları şöyle:

• İşletme WhatsApp Business Messaging Policy'ye uymalı.
• İşletme en az 30 gündür WhatsApp Business Platform'da kayıtlı olmalı.
• Numaranın bağlı olduğu işletme portföyü, işletme doğrulamasından (Business Verification) geçmiş olmalı.
• Numarada iki adımlı doğrulama açık olmalı.
• Numaranın görünen adı onaylanmış olmalı.

Başvuru WhatsApp Manager'dan ya da API ile yapılır; reddedilirseniz 30 gün sonra yeniden başvurabilirsiniz. WhatsApp Business uygulamasındaki numaralara, test hesaplarına ve işletme çalışanlarına OBA verilmez. Rozetin pratik bir faydası var: OBA olmayan bir işletme numarası, müşteri rehberine kaydetmedikçe WhatsApp aramasında çıkmaz.

Uygulama tarafında doğrulanmış rozet artık ücretli Meta One planlarıyla sunuluyor (Essential ve üstü, doğrulama başarılı olursa). Meta'ya göre plan içeriği, fiyat ve kullanılabilirlik bölgeye göre değişebiliyor; Türkiye'deki seçenekleri uygulamanın içinden kontrol edin.

Distrivo Müşteri Destek Asistanı ile WhatsApp Business API

Distrivo Müşteri Destek Asistanı, WhatsApp'a resmî WhatsApp Business Platform (Cloud API) bağlantısıyla bağlanır. Yukarıdaki adımları ayrı bir geliştirici projesi olarak yürütmeniz gerekmez:

• Panelden resmî bağlantı — bağlantı Meta'nın resmî bağlantı akışıyla kurulur; Meta'nın onay süreci tamamlanana kadar beta olarak hesap bazında açılıyor.
• Şifre ve token paylaşmazsınız — kanal resmî bağlantıyla (OAuth) eklenir; erişim anahtarları ayrıca AES-256-GCM ile şifrelenir.
• Kod ya da yapay zekâ anahtarı gerekmez — kayıt self-servistir, satış görüşmesi beklemezsiniz.
• Bağlamadan önce deneyin — test kanalında hiçbir kanal bağlamadan yanıtları ve üslubu denersiniz.
• Tek gelen kutusu — WhatsApp, Instagram DM ve Facebook Messenger konuşmaları geçmişleriyle birlikte aynı listede durur.
• Pencere kuralına uyar — 24 saatlik pencere kapalıysa serbest metinli takip mesajı gönderilemez; asistan bu durumda mesajı "gönderilemedi" olarak işaretler.
• Yetkili isteği her zaman insana gider — müşteri yetkili istediğinde konuşma insana aktarılır; bu eskalasyon hiçbir ayarla kapatılamaz.

Meta'nın mesaj ücretleri, Distrivo'nun kullanım bedelinden ayrı bir konudur. Asistanın WhatsApp'ta neleri üstlenebildiğini görmek için destek asistanını inceleyin.

Sık sorulan sorular

WhatsApp Business API ücretli mi?

Evet. Meta, işletmenin gönderdiği ve teslim edilen her mesaj için ücret alır; müşteriden gelen mesajlar ücretsizdir. 1 Ekim 2026'dan beri her işletme numarası ayda 1.000 servis mesajını ücretsiz gönderebilir; şablon mesajların ücreti kategoriye ve alıcının ülkesine göre değişir. Güncel rakamlar WhatsApp Business API fiyatları yazısında.

WhatsApp Business API için kod bilgisi gerekir mi?

API'yi kendi yazılımınıza doğrudan bağlayacaksanız evet: uygulama oluşturma, webhook ve erişim anahtarı yönetimi geliştirici işidir. API bağlantısını hazır sunan bir yazılım kullanıyorsanız gerekmez; adımları Meta'nın resmî penceresinde siz tamamlarsınız. Distrivo Müşteri Destek Asistanı'nda bu pencere panelden açılır. Bu bağlantı, Meta'nın onay süreci tamamlanana kadar beta olarak hesap bazında açılıyor.

Mevcut WhatsApp numaramı API'de kullanabilir miyim?

Evet, iki yolla: numaradaki WhatsApp hesabını silip numarayı yalnız API'de kullanmak (tam geçiş) ya da Meta'nın coexistence (birlikte kullanım) seçeneğiyle numarayı Business uygulamasında da tutmak. Şartları ve iki yolun farklarını geçiş rehberinde anlattık.

İşletme doğrulaması şart mı?

Başlamak için şart değil: doğrulanmamış bir işletme portföyü de API'yi kullanabilir; pencere dışı mesaj sınırı 250 kişiyle başlar. İşletme doğrulaması bu sınırı 2.000'e çıkaran yollardan biridir; onaylı görünen adla birlikte şablon sınırını da 250'den 6.000'e çıkarır. Mavi tik (OBA) için ise zorunludur.

WhatsApp'ta mavi tik nasıl alınır?

API kullanan bir numara için WhatsApp Manager'dan OBA başvurusu yapılır; şartlar işletme doğrulaması, iki adımlı doğrulama, onaylı görünen ad ve Platform'da en az 30 gündür. WhatsApp Business uygulamasında ise doğrulanmış rozet Meta One abonelik planlarıyla sunuluyor. "Yeşil tik" eski rozetin adıdır; rozet bugün mavidir.