WhatsApp Business API Rehberi: Nedir, Ücret, Chatbot

WhatsApp Business API, işletmelerin WhatsApp mesajlarını telefondan elle değil, kendi yazılımları, CRM sistemleri ve otomasyon araçları üzerinden gönderip almasını sağlayan Meta arayüzüdür. Resmi adı WhatsApp Business Platform'dur ve telefondaki WhatsApp Business uygulamasından ayrı bir üründür. Uygulama tek bir hesapta, bir kişinin yazdığı mesajlarla çalışır. API ise sipariş bildirimi, randevu hatırlatma, chatbot ve toplu bilgilendirme gibi işleri sistemin yapmasına izin verir, ama kendi kurallarıyla. Müşteri size yazdığında 24 saatlik bir müşteri hizmetleri penceresi açılır, pencere dışında yalnız Meta'nın onayladığı şablon mesajlar gönderilebilir ve mesajlar kategoriye göre ücretlendirilir.

Bu kuralların en çok gözden kaçanı zamanlamadır. Müşteri akşam yazdı, siz ertesi gün öğleden sonra dönmek istediniz: pencere kapanmışsa ve elinizde onaylı bir şablon yoksa o sohbete serbest metinle geri dönemezsiniz, yalnız onaylı bir şablonla yazabilirsiniz. Ücret tarafında da yakın tarihli bir değişiklik var. 1 Ekim 2026 itibarıyla aylık ücretsiz kotayı aşan servis mesajları ve pencere içinde giden hizmet bildirimleri yeniden mesaj başına ücretlendiriliyor.

Bu yazıda WhatsApp Business API'nin ne olduğunu, uygulamadan farkını, Meta'nın Cloud API'sine doğrudan ya da bir iş ortağı üzerinden nasıl erişildiğini, şablonların ve ücretlendirmenin mantığını, WhatsApp otomatik mesaj ve chatbot senaryolarını ve işletmenin vermesi gereken kararları anlatıyorum. n8n ile adım adım kurulum arıyorsanız teknik ayrıntılar n8n ile WhatsApp Business otomasyonu rehberinde yer alıyor.

WhatsApp Business API Nedir?

WhatsApp Business API, işletmenin WhatsApp mesajlaşmasını bir yazılımın içine bağlayan resmi Meta arayüzüdür ve mesajları kişinin değil sistemin göndermesini sağlar.

WhatsApp Business API, resmi adıyla WhatsApp Business Platform, işletmelerin WhatsApp üzerinden mesaj göndermesini ve almasını kendi yazılımları, CRM sistemleri ya da otomasyon araçları aracılığıyla programla yönetmesini sağlayan Meta arayüzüdür. Meta'nın geliştirici belgelerine göre Cloud API, işletmelerin WhatsApp'ta programlı olarak mesajlaşmasını ve arama yapmasını sağlar ve bir işletme telefon numarası varsayılan olarak saniyede 80 mesaja kadar gönderebilir, daha yüksek kapasite için yükseltme mümkündür (Meta, Cloud API genel bakış). Platformu kullanmanın ön koşulu bir Meta işletme portföyüdür. Telefondaki WhatsApp Business uygulamasından farkı, mesajların bir kişinin elinde değil bir sistemin içinde akmasıdır. Örneğin sipariş yazılımı kargo çıktığında bildirimi kendisi gönderir, web sitesindeki form dolduğunda karşılama mesajı otomatik gider, gelen soru bir chatbota ya da doğru temsilciye yönlendirilir. API bir uygulama değildir, kendi ekranı da yoktur. Mesajları görmek ve yanıtlamak için ya kendi geliştirdiğiniz bir panel ya da bir iş ortağının sunduğu gelen kutusu kullanılır. Bu yüzden API kararı aslında bir altyapı kararıdır.

"WhatsApp API" ifadesi de aynı ürünü anlatır. Meta'nın geliştirici belgelerinde ürün Cloud API adıyla geçer, işletmelere dönük sayfalarda ise WhatsApp Business Platform adı kullanılır.

WhatsApp Business Nedir, Uygulama ile API Arasındaki Fark Ne?

WhatsApp Business, Meta'nın işletmeler için sunduğu iki ayrı ürünün ortak adıdır: biri telefona indirilen WhatsApp Business uygulaması, diğeri yazılımlara bağlanan WhatsApp Business Platform yani API'dir.

WhatsApp'ın kendi tanıtım sayfasına göre uygulama "küçük işletme sahibi düşünülerek" tasarlanmıştır ve müşterilerle bağlantı kurmayı, ürünleri sergilemeyi, sohbet başladığında karşılama yapmayı sağlar (WhatsApp Business uygulaması). Platform ise potansiyel müşteri toplama, sohbet üzerinden ticaret ve etkileşim pazarlaması için "kurumsal düzeyde" API'ler olarak tanımlanır (WhatsApp Business Platform).

Ölçüt	WhatsApp Business uygulaması	WhatsApp Business API (Platform)
Kimin için	Küçük işletme sahibi	Mesajlaşmayı sistemlerine bağlamak isteyen işletme
Nasıl kullanılır	Telefondan ve bağlı cihazlardan elle	Yazılım, CRM, otomasyon aracı ya da iş ortağı paneli üzerinden
Arayüz	Uygulamanın kendisi	Kendi ekranı yok, panel ayrıca gerekir
Toplu gönderim	Yayın listeleri	Onaylı şablon mesajlar, mesajlaşma limitine bağlı
Otomatik yanıt	Karşılama ve uzaktayken mesajları	Chatbot, sistemden tetiklenen bildirimler, temsilciye yönlendirme

Günde birkaç düzine sohbeti tek kişi yönetiyorsa uygulama işinizi görebilir. Mesajların sipariş, randevu ya da CRM verisine göre kendiliğinden gitmesi, birden fazla temsilcinin aynı numarayı kullanması ya da bir chatbotun ilk karşılamayı yapması gerekiyorsa API'ye geçiş konuşulur. Aşağıdaki kısa test hangi tarafta durduğunuzu gösterir.

WhatsApp Business API'ye Nasıl Erişilir: Cloud API ve İş Ortakları

WhatsApp Business API'ye iki yoldan erişilir: Meta'nın platformuna doğrudan bağlanarak ya da bir iş ortağının kayıt akışıyla. WhatsApp'ın platform sayfası iki seçeneği eşit ağırlıkta sunar ve birini önermez, iş ortağı seçeneği sayfada önce gelir (WhatsApp Business Platform).

Yol	Meta'ya göre kimin için uygun	Ne anlama gelir
İş ortağı üzerinden	API'yi kendisi yönetmek istemeyen, hızlı başlamak isteyen, kurulum ve destek için bir iş ortağını tercih eden işletme	İş ortağı kayıt akışını ve teknik kurulumu yürütür, az kodla ya da kodsuz başlanır
Doğrudan bağlantı	Kendi numarasından göndermek isteyen, platformu entegre edebilecek geliştiricisi olan, deneyimi tamamen kendisi kontrol etmek isteyen işletme	Cloud API'ye kendi uygulamanız ya da n8n gibi bir otomasyon aracı bağlanır

Meta'nın geliştirici belgelerinde iş ortakları Solution Partner ve Tech Provider olarak anılır. Hangi yolu seçerseniz seçin, bir Meta işletme portföyü ve WhatsApp mesajları için kullanılacak gerçek ya da sanal bir işletme telefon numarası gerekir (Meta, Cloud API genel bakış). Doğrudan bağlantıyı n8n ile kurmak isterseniz n8n nedir rehberi ve kurulumu kendiniz mi yoksa bir uzmanla mı yapacağınızı tartan n8n otomasyonu: kendin mi, uzman mı yazısı iyi bir başlangıçtır.

Numaranız zaten WhatsApp'ta kayıtlıysa

Numaranız zaten normal WhatsApp'ta kayıtlıysa, Meta'nın kayıt belgesine göre önce o WhatsApp hesabının silinmesi gerekir. Numara WhatsApp Business uygulamasındaysa iki seçenek vardır: hesabı silmek ya da uygulama numaralarını kabul eden bir iş ortağı üzerinden bağlanmak. İş ortağı olmadan silip yeniden kaydederseniz mevcut mesaj geçmişi kaybolur (Meta, mevcut numarayı taşıma).

WhatsApp Business uygulamasında zaten kullandığınız numara, uygulamadan vazgeçmeden API'ye de bağlanabilir. Meta'nın iş ortağı belgelerinde anlatılan birlikte kullanım akışında işletme, uygulamadan bire bir mesajlaşmaya devam ederken aynı numara Cloud API'ye de bağlanır. Bunun için uygulamanın 2.24.17 ya da üzeri sürümde olması ve kurulumun Embedded Signup akışını kullanan bir Solution Partner ya da Tech Provider üzerinden yapılması gerekir. Son 6 aydaki bire bir sohbetler ve WhatsApp numarası olan kişiler senkronize edilebilir, grup sohbetleri aktarılmaz. Bedeli de var: iki tarafta kullanılan numaranın kapasitesi saniyede 20 mesajla sabitlenir, uygulamadaki yayın listeleri kapanır, mevcut listeler salt okunur hale gelir ve kaybolan mesajlar bire bir sohbetlerde kapatılır (Meta, WhatsApp Business uygulaması kullanıcılarını bağlama). Yani mevcut numaranızı ve müşteri geçmişinizi korumak mümkün, ama yayın listesiyle toplu mesaj atma alışkanlığı bu geçişte sona erer. Karar vermeden önce bu listeyi iş ortağınızla birlikte gözden geçirin.

Numara platformda başka bir hesapta ya da başka bir sağlayıcıda kayıtlıysa, okuduğum Meta sayfası bu taşımanın adımlarını ayrıntılı anlatmıyor. Bu durumda geçişi mevcut sağlayıcınız ve yeni iş ortağınızla birlikte planlayın.

WhatsApp Mesaj Şablonları ve 24 Saatlik Pencere Nasıl Çalışır?

WhatsApp mesaj şablonları, müşteri hizmetleri penceresi kapalıyken kullanıcıya gönderilebilen tek mesaj türüdür ve gönderilmeden önce Meta incelemesinden geçip onaylanmış olmaları gerekir.

Pencere şöyle işler: bir kullanıcı size yazdığında ya da sizi aradığında 24 saatlik bir müşteri hizmetleri penceresi başlar ve kullanıcının her yeni mesajı süreyi baştan başlatır. İşletmeler şablon dışı, yani serbest metinli mesajları yalnız bu pencere açıkken gönderebilir (Meta, WhatsApp ücretlendirme belgesi). Pencere kapandıysa ya da müşteri size hiç yazmadıysa elinizde onaylı bir şablon olmalıdır.

Şablonlarla ilgili bilmeniz gerekenler (Meta, mesaj şablonları):

• Kategori: Her şablon pazarlama, hizmet bildirimi (utility) ya da kimlik doğrulama kategorisine ayrılır. Kategori, mesajın ücretini de belirler.
• İnceleme: Şablonlar oluşturulduğunda ya da düzenlendiğinde otomatik incelenir ve inceleme 24 saate kadar sürebilir. Gönderim için durumun onaylı olması gerekir.
• Sayı sınırı: İşletme portföyü doğrulanmamışsa her mesajlaşma hesabı 250 şablonla sınırlıdır. Portföy doğrulanmış ve onaylı görünen adı olan bir numara varsa sınır 6.000 şablona çıkar.
• Kalite durumu: Onaylı şablonlar yüksek, orta ya da düşük kalite olarak işaretlenir. Duraklatılmış ya da devre dışı bırakılmış şablonlar müşterilere gönderilemez.

Şablonu yazmadan önce hangi olayın onu tetikleyeceğini netleştirin: sipariş onayı, kargo çıkışı, randevudan bir gün önce hatırlatma gibi. Hangi süreçlerin önce otomasyona alınacağını seçmek için iş süreçleri otomasyonu rehberindeki önceliklendirme yöntemi işe yarar.

WhatsApp Business API Ücretlendirmesi Nasıl İşler?

WhatsApp Business API, Meta tarafından teslim edilen her mesaj için ayrı ayrı ücretlendirilir ve ücret mesajın kategorisine ve alıcının pazarına göre değişir.

WhatsApp Business API ücretlendirmesi, 1 Temmuz 2025'ten bu yana konuşma başına değil teslim edilen mesaj başına yapılır ve ücreti mesajın kategorisi ile alıcının bulunduğu pazar belirler. Meta'nın ücretlendirme belgesine göre şablon mesajlar pazarlama, hizmet bildirimi ve kimlik doğrulama kategorilerine ayrılır, şablon dışı mesajlar ise servis ya da Meta Business Agent kategorisine girer. Kullanıcının işletmeye yazdığı mesajlar ücretlendirilmez. 1 Ekim 2026 itibarıyla Meta, aylık ücretsiz kotayı aşan servis mesajlarını ve açık müşteri hizmetleri penceresi içinde giden hizmet bildirimlerini yeniden mesaj başına ücretlendirmeye başladı. Her işletme telefon numarası için ayda 1.000 servis mesajı ücretsizdir, ücret 1.001'inci servis mesajından itibaren başlar ve kullanılmayan hak sonraki aya devretmez. Click to WhatsApp reklamından gelen kullanıcıya yanıt verildiğinde açılan ücretsiz giriş noktası penceresi ise 7 güne kadar açık kalabilir ve bu pencerede pazarlama, hizmet bildirimi, kimlik doğrulama ve servis mesajları ücretlendirilmez (Meta, WhatsApp ücretlendirme belgesi). Güncel birim ücretler 47 pazarlık tabloda yayımlanır.

Birim ücretleri bu yazıda vermiyorum, çünkü pazara, kategoriye ve hacme göre değişiyor ve Meta tabloyu güncelliyor. Türkiye'ye giden mesajların güncel ücretini WhatsApp'ın resmi ücret tablosundan kontrol edin. İş ortağı üzerinden çalışıyorsanız ortağın kendi hizmet bedeli bu tabloya ek olarak ayrıca konuşulur.

Mesaj maliyetini düşüren üç kaldıraç

Meta'nın kendi kuralları içinde maliyeti etkileyen üç somut kaldıraç var:

1. Pencere kapanmadan yanıt verin. Pencere dışında yalnız şablon gönderilebilir ve şablonlar kategorisine göre ücretlidir. Pencere içindeki servis mesajlarının ilk 1.000'i her numara için her ay ücretsizdir (Meta, WhatsApp ücretlendirme belgesi).
2. Click to WhatsApp reklamlarını kullanın. Bu reklamdan gelen kullanıcıya yanıt verildiğinde açılan ücretsiz giriş noktası penceresi 7 güne kadar sürebilir ve bu sürede Meta Business Agent dışındaki mesajlar ücretlendirilmez.
3. Hizmet bildirimi ve kimlik doğrulama hacmini izleyin. Bu iki kategoride ay içinde gönderilen mesaj sayısı arttıkça daha düşük kademeli ücretler açılır, sayaç her ayın başında sıfırlanır.

WhatsApp Otomatik Mesaj ve Chatbot Kullanım Senaryoları

WhatsApp otomatik mesaj, bir olay gerçekleştiğinde ya da müşteri yazdığında insan müdahalesi olmadan giden mesajdır. WhatsApp chatbot ise bu yanıtları soruya göre seçen ya da üreten bir sohbet akışıdır.

Senaryoları mesaj kategorisiyle birlikte düşünmek, hem şablon hazırlığını hem de ücret beklentisini netleştirir:

Senaryo	Nasıl tetiklenir	Mesaj türü
Karşılama ve sık sorulan sorular	Müşteri yazar, chatbot yanıtlar	Pencere içinde servis mesajı
Temsilciye yönlendirme	Chatbot çözemediği soruyu devreder	Pencere içinde servis mesajı
Sipariş ve kargo bildirimi	E-ticaret ya da sipariş yazılımı	Hizmet bildirimi şablonu
Randevu hatırlatma	Takvim ya da randevu sistemi	Hizmet bildirimi şablonu
Tek kullanımlık giriş kodu	Üyelik ya da giriş sistemi	Kimlik doğrulama şablonu
Kampanya ve yeni ürün duyurusu	Pazarlama listesi, izin vermiş kişiler	Pazarlama şablonu

Chatbotun gücü yanıt hızındadır. Müşteri gece yazdığında bile ilk yanıt pencere içinde gider ve konuşma onaylı şablona ihtiyaç duymadan ilerler. Yapay zeka destekli bir chatbotun hangi işleri devralabileceğini yapay zeka otomasyonu nedir yazısında ayrıntılı anlattım.

WhatsApp Toplu Mesaj Gönderirken Nelere Dikkat Edilir?

WhatsApp toplu mesaj, API'de onaylı şablonlarla ve yalnızca izin vermiş kişilere gönderilir ve Meta'nın gönderim limitlerine tabidir.

• İzin şartı: Meta, işletmelerin WhatsApp'ta kişilere mesaj göndermeden önce izin almasını zorunlu tutar. İzin metni, kişinin bu işletmeden mesaj almayı kabul ettiğini ve işletmenin adını açıkça belirtmelidir. İzin web sitesi, SMS, sesli yanıt sistemiyle telefon ya da yüz yüze veya kağıt üzerinde alınabilir (Meta, izin alma).
• Mesajlaşma limiti: Pencere dışında 24 saatlik kayan bir dönemde mesaj ulaştırabileceğiniz farklı kullanıcı sayısının üst sınırı vardır ve bu sınır işletme portföyü düzeyinde belirlenir (Meta, mesajlaşma limitleri).
• Aynı kişiye sıklık: Bir işletme numarası aynı kullanıcıya 6 saniyede 1 mesaj gönderebilir (Meta, Cloud API genel bakış).
• Şablon kalitesi: Düşük kaliteli şablon duraklatılabilir ya da devre dışı kalabilir. Bu yüzden toplu gönderimde içerik kadar hedef listenin doğruluğu da önemlidir.

WhatsApp Business uygulamasındaki yayın listesi alışkanlığını API'ye taşımak isteyenler için not: yukarıda anlattığım birlikte kullanım akışına geçen numarada uygulamanın yayın listeleri kapanır, toplu gönderim şablonlar üzerinden yürür.

İşletme İçin Karar Adımları

WhatsApp Business API'ye geçiş kararı beş soruyla verilir: hangi süreç otomatikleşecek, hangi numara kullanılacak, hangi erişim yolu seçilecek, hangi şablonlar gerekecek ve izin nasıl toplanacak.

1. Süreci seçin. Günde en çok tekrarlanan WhatsApp işini yazın: sık sorulan sorular mı, sipariş bildirimi mi, randevu hatırlatma mı?
2. Numarayı belirleyin. Mevcut uygulama numarasını birlikte kullanım akışıyla mı bağlayacaksınız, yoksa yeni bir numara mı açacaksınız?
3. Erişim yolunu seçin. Geliştiriciniz varsa doğrudan Cloud API, yoksa iş ortağı. İki seçeneğin Meta'ya göre kime uyduğu yukarıdaki tabloda.
4. Şablonları hazırlayın. Her tetikleyici olay için kategorisi belli, incelemeye hazır bir şablon yazın.
5. İzni toplayın ve ölçün. İzin metnini web formuna ya da sipariş adımına ekleyin, ilk ayın mesaj sayılarını kategori bazında izleyin.

Sıkça Sorulan Sorular

WhatsApp Business API ücretsiz mi?

Tamamen ücretsiz değildir. Meta teslim edilen mesaj başına, kategoriye ve pazara göre ücret alır. Kullanıcının işletmeye yazdığı mesajlar ücretlendirilmez, her işletme numarası için ayda 1.000 servis mesajı ücretsizdir ve Click to WhatsApp reklamından açılan pencerede Meta Business Agent mesajları dışındaki mesajlar ücretlendirilmez.

WhatsApp API ile toplu mesaj gönderebilir miyim?

Gönderebilirsiniz, ancak yalnızca onaylı şablonlarla ve sizden mesaj almayı kabul etmiş kişilere. Pencere dışında ulaşabileceğiniz farklı kullanıcı sayısı Meta'nın mesajlaşma limitiyle sınırlıdır ve düşük kaliteli şablonlar duraklatılabilir.

WhatsApp Business uygulamasındaki numaramı API'de kullanabilir miyim?

Kullanabilirsiniz. Uygulama 2.24.17 ya da üzeri sürümdeyse, bu akışı destekleyen bir iş ortağıyla numara hem uygulamada hem API'de çalışabilir. Bu durumda numaranın kapasitesi saniyede 20 mesajla sabitlenir ve uygulamadaki yayın listeleri kapanır.

WhatsApp chatbot kurmak için yazılımcı gerekir mi?

Erişim yoluna bağlıdır. WhatsApp'ın platform sayfasına göre iş ortağı üzerinden başlamak az kodla ya da kodsuz mümkündür. Doğrudan bağlantı ise platformu entegre edebilecek bir geliştirici ya da n8n gibi bir otomasyon aracını kurabilecek biri ister.

Şablon onayı ne kadar sürer?

Meta şablonları oluşturulduğunda ya da düzenlendiğinde otomatik inceler ve inceleme 24 saate kadar sürebilir. Onaylanmayan şablon gönderilemez, bu yüzden kampanya ya da bildirim akışını yayına almadan önce şablonları hazırlamak gerekir.

Sonuç

WhatsApp Business API, mesajlaşmayı bir kişinin telefonundan alıp işletmenin sistemlerine bağlayan altyapıdır. Karar üç kuralı anlamakla başlar: pencere açıkken serbest yanıt, pencere dışında onaylı şablon ve mesaj başına ücret. Erişim yolunu ekibinizin teknik kapasitesine göre seçin, mevcut numaranın durumunu baştan netleştirin, tek bir süreçle başlayıp ölçün.

Bu rehberi kaydedin, geçiş planınızı yaparken kontrol listesi olarak işinize yarayacak. Kurulumun teknik tarafı için n8n ile WhatsApp Business otomasyonu rehberine geçebilirsiniz.