WhatsApp Business API (Cloud API) nedir? Ücretler, Türkiye fiyatları, chatbot kuralları ve kurulum

WhatsApp Cloud API ile işletme numaranı kendi yazılımına bağlarsın: müşterinin mesajı sunucuna gelir, bot ya da temsilci yanıtlar; randevu hatırlatması gibi mesajları onaylı şablonla gönderirsin. Meta'nın resmî API'si. Ücret mesaj başına: Türkiye'de Ekim 2026 itibarıyla pazarlama mesajı 0,0109 $, hatırlatma (utility) ve servis mesajı 0,0009 $. Her numaraya ayda 1.000 servis mesajı ücretsiz. Kodsuz bir uygulama değil; Meta uygulaması, webhook ve şablon onayı gerekir. Bot yalnız işletmenin konusunda yanıt vermeli ve insana devir yolu olmalı.

Ne yapar: İşletme WhatsApp numarasını bota ya da yazılıma bağlar
Türkiye: Utility 0,0009 $ · Marketing 0,0109 $
Ücretsiz: Numara başına ayda 1.000 servis mesajı
Fatura: USD, EUR…; TRY yok
Kodsuz mu: Hayır; n8n ya da kod gerekir
Genel amaçlı bot: Şartlarla sınırlı
Ücret: Mesaj başına; aracı abonelik yok

Son gelişmeler

28 Ekim 2026Meta Muse Wonder: Meta AI'a Geldi mi, Türkiye'de Var mı?

Tüm YZ Gündemi

WhatsApp Cloud API ne işe yarar?

WhatsApp Business uygulaması telefondan elle yazışmak içindir. Cloud API ise aynı işi programla yapar: müşterinin mesajı webhook ile (Meta'nın senin sunucuna gönderdiği anlık bildirim) yazılımına gelir, yazılım yanıtı API üzerinden geri yollar. Böylece bot, CRM, randevu sistemi ya da e-ticaret paneli WhatsApp'la konuşur. Meta sunucularda barındırır; kendi WhatsApp sunucunu kurmazsın.

WhatsApp mesajlarına bot yanıt versinNe alırsın: Otomatik yanıtAyrı kurulum gerekir Randevu hatırlatması ve sipariş bildirimiNe alırsın: Şablon mesajıAyrı kurulum gerekir Şablon oluşturup onay almakNe alırsın: Onaylı şablonUygulamada hazır

Müşteri yazarsa: 24 saat boyunca serbest metin, görsel, buton, konum gibi mesajlarla yanıt verirsin (servis mesajı).
Sen başlatırsan: yalnız Meta'nın onayladığı şablon ile yazarsın: pazarlama (marketing), işlem bildirimi (utility), doğrulama kodu (authentication).
Meta Business Agent: Meta'nın kendi yapay zekâ ajanı da var; ayrı ücretlidir (1 milyon token başına 2 $). Bu sayfa kendi botunu bağlamayı anlatır.

Kime yarar: randevu hatırlatması, sipariş ve kargo bildirimi, sık sorulan soruları otomatik yanıtlama isteyen işletmeler ve onlara kurulum yapan geliştiriciler.

WhatsApp Cloud API'ye nasıl başlanır? API anahtarı nasıl alınır?

Meta geliştirici hesabı aç ve uygulama oluştur. developers.facebook.com/apps › Create App › "Connect with customers through WhatsApp" kullanım senaryosu.
İşletme portföyünü seç ya da akışta yeni aç. Messaging hesabı (WhatsApp Business Account) bu portföyün altında oluşur.
Test numarasıyla dene. API Setup ekranında test numarası ve geçici erişim jetonu (token) otomatik verilir. Kendi telefonunu alıcı olarak ekleyip hello_world şablonunu gönder, sonra yanıt ver.
Gerçek numarayı ekle. Numara sana ait olmalı, ülke ve alan kodu taşımalı, SMS ya da arama alabilmeli. Kayıtta iki adımlı doğrulama PIN'i ve görünen ad (display name) istenir.
Kalıcı erişim jetonu ve webhook kur. Kendi işletmen için kullanıyorsan Meta'nın önerdiği uzun ömürlü sistem kullanıcısı jetonunu (System User access token) oluştur. Gelen mesajlar için uygulamaya tek bir webhook adresi kaydedilir.
Ödeme yöntemi ekle. Billing Hub'dan. Ödeme yöntemi yoksa ayda 1.000 ücretsiz servis mesajı bitince yanıtların teslim edilmez.

İşletme doğrulaması şart mı? Limit nasıl büyür?

Başlamak için şart değil. Yeni portföy, pencere dışında 24 saatte 250 farklı kişiye yazabilir. İşletme doğrulaması (ya da 30 günde 2.000 kaliteli şablon teslimatı) limiti 2.000'e çıkarır; sonra kalite yüksekse ve son 7 günde limitin yarısı kullanıldıysa 10.000, 100.000 ve sınırsıza kendiliğinden çıkar. Doğrulama ayrıca kayıtlı numara sınırını 2'den 20'ye yükseltir.

Aracı firma (BSP, "Solution Partner") şart değil: kendi işletmen için Cloud API'yi doğrudan kullanırsın. Başka işletmeleri kendi uygulamanla bağlamak (Tech Provider olmak) için işletme doğrulaması ve App Review gerekir.

Numaram WhatsApp'ta kayıtlı: taşıyabilir miyim, uygulamayla birlikte kullanabilir miyim?

Doğrudan kayıt

WhatsApp'ta (normal ya da Business uygulamasında) kullanılan numara, oradaki hesap silinmeden Cloud API'ye kaydedilemez. Kayıtlı numara arama ve SMS için kullanılmaya devam eder ama WhatsApp uygulamasında açılamaz.

Uygulamayla birlikte (coexistence)

WhatsApp Business uygulamasındaki numarayı uygulamada da kullanmaya devam ederek API'ye bağlamak mümkün; ama bu akışı yalnız Meta'nın Solution Partner ya da Tech Provider olarak tanıdığı firmalar sunabilir. Uygulama 2.24.17 ve üstü olmalı; son 6 ayın birebir sohbetleri aktarılabilir, gruplar aktarılmaz, yayın listeleri kapanır, aynı numarada hız saniyede 20 mesajla sınırlanır. Uygulamadan gönderdiğin mesajlar ücretsiz kalır.

Görünen ad

Kayıtta zorunlu. Daha yüksek mesaj limitine ulaşınca otomatik doğrulamadan geçer; reddedilirse Meta'nın ad kurallarına göre düzeltirsin. 30 günde en çok 10 kez değiştirilir; onaydan sonra 14 gün içinde numara yeniden kaydedilmeli.

Numara silme

Yalnız portföy yöneticisi WhatsApp Manager'dan siler; son 30 günde ücretli mesaj gönderilmiş numara silinemez. API ile silinemez.

WhatsApp chatbot nasıl kurulur? n8n ya da kendi kodla akış

Müşteri yazarMesaj webhook ile n8n'deki WhatsApp Trigger'a ya da kendi sunucuna gelir.

Bot yanıtı hazırlarYapay zekâ ya da kural tabanlı akış; gerekirse temsilciye aktarır.

Yanıt API'den gider24 saat içinde serbest metin; dışında onaylı şablon.

Bir Meta uygulamasına tek webhook kaydedilir; test ve canlı adres arasında geçince eskisi silinir.

n8n'de WhatsApp Trigger düğümü ekle; Meta uygulamasının App ID ve App Secret'ıyla kimlik bilgisi oluştur, "Messages" olayını seç.
Gelen metni yapay zekâ düğümüne ver; sistem talimatına aşağıdaki örneği koy.
Yanıtı WhatsApp Business Cloud düğümünün Send işlemiyle gönder. Pencere kapalıysa Send Template kullan.
Desteklenmeyen bir işlem için aynı kimlik bilgisiyle HTTP Request düğümü kullanılır.

Webhook adresini Meta uygulamasında doğrula: Meta'nın GET isteğine 200 ve hub.challenge değeriyle yanıt ver.
Gelen POST'ta mesaj metnini ve gönderenin numarasını al; aynı mesajı iki kez işlememek için mesaj kimliğini sakla.
Yanıtı Graph API'nin /<PHONE_NUMBER_ID>/messages uç noktasına gönder.

Metin mesajı gönderme (örnek istek)

› curl -X POST https://graph.facebook.com/<SURUM>/<PHONE_NUMBER_ID>/messages -H "Authorization: Bearer <ERISIM_JETONU>" -H "Content-Type: application/json" -d '{"messaging_product":"whatsapp","to":"90XXXXXXXXXX","type":"text","text":{"body":"Merhaba, nasıl yardımcı olabilirim?"}}'

Bot sistem talimatı (örnek)"Sen [İşletme adı] adlı diş kliniğinin WhatsApp asistanısın. Yalnız kliniğin hizmetleri, çalışma saatleri, adresi ve randevu işlemleri hakkında yanıt ver. Bu konuların dışındaki sorulara "Bu konuda yardımcı olamıyorum" de. Sağlık durumu, ilaç, teşhis, ödeme itirazı ya da para iadesi sorulursa yanıt verme; "Sizi bir çalışanımıza aktarıyorum" yaz ve sohbeti insana devret. Kendini yapay zekâ asistanı olarak tanıt. Fiyat ve tarih uydurma; bilmiyorsan insana aktar. Kısa, nazik ve Türkçe yaz."Bu metin bir örnek; kendi işine göre uyarla. Konu sınırı ve insana devir, WhatsApp kurallarıyla da uyumlu olmanı sağlar.

Şablon (template) nasıl onaylatılır?

WhatsApp Manager › Message Templates'te ya da API ile oluşturursun; kategori seçersin: marketing, utility, authentication.
İnceleme 24 saate kadar sürebilir. Onaylanmadan şablon gönderilemez.
Utility, belirli bir işlemle ilgili olmalı (ör. "{{1}} tarihli randevunuz yarın saat {{2}}'de"). İndirim, kampanya, "yeniden gel" içeriği marketing sayılır.
Utility seçip pazarlama içeriği yazarsan şablon reddedilmez, marketing olarak onaylanır ve pahalı fiyattan ücretlenir. Onaylı şablonlar da sonradan bir gün önceden bildirimle marketing'e çevrilebilir. İtiraz için 60 gün var.

WhatsApp API ücretli mi? Türkiye mesaj fiyatları (Ekim 2026)

Evet, ücretli ama abonelik yok: Meta yalnız senin gönderdiğin ve teslim edilen mesaj için, mesajın kategorisine ve alıcının ülke koduna göre ücret alır. Müşteriden gelen mesaj ücretsiz. Aşağıdaki fiyatlar alıcı Türkiye'deki (+90) bir numara olduğunda geçerli.

Kategori	Ne için	Türkiye fiyatı (mesaj başına)
Marketing (şablon)	Kampanya, indirim, ürün önerisi, sepet hatırlatma	0,0109 $
Utility (şablon)	Randevu hatırlatması, sipariş ve kargo bildirimi	0,0009 $ (ayda 100.000'den sonra kademeli indirim)
Authentication (şablon)	Tek kullanımlık doğrulama kodu	0,0009 $
Service (şablonsuz)	Müşteri yazdıktan sonra 24 saat içindeki yanıtlar	Numara başına ayda ilk 1.000 ücretsiz, sonra 0,0009 $
Meta Business Agent	Meta'nın kendi yapay zekâ ajanının yanıtı	1 milyon token başına 2 $ (Meta'ya göre mesaj başına ~4-5 sent)

1 Ekim 2026'da ne değişti?

Servis mesajları yeniden ücretli: her işletme numarasına ayda 1.000 ücretsiz servis mesajı, devretmez; 1.001.'den itibaren ücret.
Müşteri yazdıktan sonra açık pencerede gönderilen utility şablonları da artık ücretli (Temmuz 2025'ten beri ücretsizdi).
Ödeme yöntemi yoksa ücretsiz kademe bitince servis mesajları teslim edilmez.

Müşteri hizmeti penceresi (24 saat)

Reklamdan gelen ücretsiz pencere (7 güne kadar)

Şema: müşteri her yazdığında 24 saatlik pencere yeniden başlar; bu sürede şablonsuz yazabilirsin. WhatsApp'a tıklatan reklamdan gelen kişiye pencere içinde yanıt verince ücretsiz giriş penceresi açılır ve bu sürede Meta Business Agent dışındaki mesajlar ücretsizdir.

Ücretsiz giriş penceresinin süresi iki resmî sayfada farklı: geliştirici fiyat sayfası "7 güne kadar", business.whatsapp.com fiyat sayfası "3 gün (72 saat)" diyor. Aynı tanıtım sayfası servis mesajlarının hâlâ ücretsiz olduğunu da yazıyor; güncel kural geliştirici sayfasında. Faturadaki gerçek tutarı WhatsApp Manager › Insights'tan kontrol et.

Fatura para birimi Messaging hesabı açılırken seçilir ve sonradan değiştirilemez (Meta'nın taşıma API'si var). 16 para birimi arasında TRY yok; Türkiye'den çoğunlukla USD ya da EUR seçilir. Fiyat sayfası KDV ya da vergi durumunu yazmıyor; bunu Billing Hub'daki faturadan ve muhasebecinden kontrol et. Fiyatlar her çeyreğin ilk günü değişebilir.

Resmî fiyat sayfası en son 28 Ekim 2026 tarihinde kontrol edildi.

Türkiye'den kullanım ve Türkçe

Türkiye'deki numaralara mesajVar	Türkiye fiyat kartında ayrı pazar olarak listeli.
Türkçe mesaj ve şablonVar	Şablonlar dil koduyla oluşturulur; mesaj metnini Türkçe yazarsın.
TL ile faturaYok	16 para birimi arasında TRY yok.
Türkçe belge ve panelNet değil	Geliştirici belgeleri İngilizce; panelin Türkçe dil seçeneği resmî kaynakta yazmıyor.

WhatsApp'ta yapay zekâ botu kuralları: genel amaçlı asistan yasağı ve insana devir

Meta'nın WhatsApp Business Platform şartlarına 15 Ocak 2026'da eklenen 4.7 maddesi, genel amaçlı yapay zekâ asistanını (her konuda sohbet eden bir bot) ürünün asıl işlevi olarak sunanları "AI Provider" sayar ve platformdan men eder. Yapay zekânın işletmenin kendi hizmetine yardımcı, yan işlev olduğu kullanım bu yasağın kapsamında değildir: kliniğin randevu botu, mağazanın sipariş botu gibi.

Yapabilirsin

İşletmenin kendi ürün ve hizmetleri hakkında yanıt veren bot
Randevu, sipariş, kargo sorularını yapay zekâyla yanıtlamak
Platform verisiyle yalnız kendi kullanımın için bir modeli ince ayarlamak

Yasak

Asıl ürünü genel amaçlı yapay zekâ sohbeti olan bir hizmeti WhatsApp'ta sunmak
WhatsApp verisiyle başka yapay zekâ modellerini eğitmek ya da geliştirmek
İnsana devir yolu olmayan tam otomatik destek

İnsana devir zorunlu: otomasyon kullanıyorsan hızlı ve açık bir devir yolu sunmalısın: sohbet içinde temsilciye aktarma, telefon, e-posta, web desteği, mağaza ya da destek formu.
Onay (opt-in) zorunlu: yalnız numarasını sana veren ve senden mesaj almayı kabul eden kişiye yazabilirsin. Onay yönteminin yasaya uygunluğu senin sorumluluğunda.
Türkiye istisnası: Meta, Türkiye'yi (+90) yasa gereği genel amaçlı yapay zekâ sağlayıcılarına izin vermek zorunda olduğu pazarlar arasında sayıyor (15 Ekim 2026). Bu yalnız "AI Provider"lar için; işletme botlarının kuralı değişmez.

Kaynak: Meta Terms for WhatsApp Business Platform, 4.7 (son değişiklik 23 Eylül 2026); WhatsApp Business Messaging Policy; Meta "AI Providers" fiyat politikası. Hukuki görüş değildir.

WhatsApp Web'i QR ile bağlayan otomatik mesaj programları güvenli mi?

WhatsApp Web'i QR kodla bağlayıp normal hesaptan otomatik ya da toplu mesaj atan programlar ve kütüphaneler resmî API değildir. WhatsApp Şartları toplu mesaj, otomatik mesaj ve izinsiz ticari (kişisel olmayan) kullanımı yasaklar. WhatsApp yardım merkezi de hesabı resmî olmayan sürümlere bağlamanın şartlara aykırı olduğunu ve hesabın geçici ya da kalıcı olarak yasaklanabileceğini yazar.

İşletme numarası kapanırsa müşteri sohbetlerin ve numaraya bağlı itibarın gider. Otomasyon için resmî Cloud API'yi ya da onu kullanan bir aracı kullan.

İYS ve KVKK: WhatsApp'tan kampanya mesajı için onay gerekir mi?

6563 sayılı Kanun

Ticari elektronik ileti alıcının önceden onayıyla gönderilir (md. 6). Kanundaki araç listesi "telefon, … kısa mesaj hizmeti gibi vasıtalar" diye açık uçludur. Aldığın mal ya da hizmetle ilgili kullanım ve bakım iletisi için ayrıca onay gerekmez; esnaf ve tacire onaysız gönderilebilir.

İYS kaydı

İYS izinleri arama, mesaj ve e-posta kanalları için tutar; İYS'nin resmî sayfaları WhatsApp'ı ayrıca anmıyor. WhatsApp kampanya mesajı için İYS'ye ayrı kayıt gerekip gerekmediği resmî kaynakta net değil: onayı yazılı ya da elektronik olarak ispatlanabilir biçimde al, İYS ve avukatınla kontrol et.

Meta'nın kuralı

Yasadan bağımsız olarak WhatsApp politikası her mesaj için önceden opt-in ister ve onayı mesaj türüne göre (sipariş güncellemesi, kampanya) ayrı almayı önerir.

KVKK yurt dışı aktarım

Mesajlar Meta altyapısında işlenir; WhatsApp veri işleme şartlarına göre alt işleyenler başka ülkelerde olabilir. KVKK md. 9'a göre yurt dışı aktarım yeterlilik kararı ya da uygun güvence (ör. standart sözleşme; imzadan sonra 5 iş günü içinde Kurul'a bildirim) ister. Aydınlatma metninde WhatsApp kanalını belirt.

Kaynak: 6563 sayılı Kanun md. 2 ve 6, 6698 sayılı KVKK md. 9 (mevzuat.gov.tr), iys.org.tr SSS, WhatsApp Business Data Processing Terms. Bu bölüm hukuki görüş değildir.

Sık sorunlar ve çözümleri

Ne oluyor	Ne yapmalı
Şablonum marketing oldu	İçerik indirim, kampanya ya da genel bir çağrı içeriyorsa Meta onu marketing sayar. Belirli bir işleme bağla (sipariş no, randevu tarihi) ve gerekirse 60 gün içinde inceleme iste.
Şablon reddedildi	Red e-posta ve WhatsApp Manager uyarısıyla bildirilir. Kategoriyi düzeltip yeniden gönder ya da inceleme iste; sık red nedenleri Meta'nın Template review sayfasında.
Numara zaten WhatsApp'ta kayıtlı	Doğrudan kayıtta önce o numaradaki WhatsApp hesabını sil. Uygulamayı bırakmak istemiyorsan coexistence sunan bir Solution Partner ya da Tech Provider kullan.
24 saatten sonra yanıt gitmiyor	Pencere kapandı; yalnız onaylı şablonla yazabilirsin. Müşteri yeniden yazınca pencere açılır.
Günde 250 kişiden fazlasına yazamıyorum	Limit portföy düzeyinde ve yalnız pencere dışı mesajları sayar. İşletme doğrulamasını tamamla ya da kaliteli şablonla 2.000 teslimata ulaş.
1.000 mesajdan sonra servis yanıtları gitmiyor	Billing Hub'a ödeme yöntemi ekle; 1 Ekim 2026'dan beri ödeme yöntemi olmayan hesapta ücretsiz kademe sonrası teslimat durur.
Webhook test ve canlıda karışıyor	Bir uygulamaya tek webhook kaydedilir; adres değişince öncekinin üzerine yazılır. Test için ayrı Meta uygulaması kullan.

Kodsuz alternatifler

Kod yazmadan WhatsApp mesajlarını ekiple yanıtlamak istiyorsan, WhatsApp'ı arka planda yine bu resmî API ile bağlayan bir gelen kutusu aracı kullanabilirsin. Meta'nın mesaj ücreti onlarda da ayrıca işler.

Sık sorulan sorular

WhatsApp Business API nedir?

Meta'nın işletme numarasını bir yazılıma bağlayan resmî API'si. Gelen mesajlar sunucuna gelir; bot ya da temsilci yanıtlar, hatırlatma ve bildirimler onaylı şablonla gönderilir.

WhatsApp API ücretli mi?

Evet, mesaj başına ücretli; abonelik yok. Türkiye'de Ekim 2026 itibarıyla marketing 0,0109 $, utility, authentication ve servis mesajı 0,0009 $. Her numaraya ayda 1.000 servis mesajı ücretsiz; müşteriden gelen mesaj ücretsiz.

WhatsApp API ücretleri hangi para biriminde ödenir?

Fatura para birimi hesap açılırken seçilir ve sonradan değiştirilemez. Listede TRY yok; USD, EUR gibi 16 para birimi var. KDV durumu fiyat sayfasında yazmıyor.

WhatsApp API anahtarı nasıl alınır?

developers.facebook.com'da WhatsApp kullanım senaryolu bir uygulama oluşturursun; API Setup ekranı test numarası ve geçici erişim jetonu verir. Canlı kullanımda sistem kullanıcısı jetonu oluşturulur.

WhatsApp Cloud API ile chatbot kurulur mu?

Evet. Gelen mesaj webhook ile n8n'e ya da kendi koduna gelir, yapay zekâ yanıtı hazırlar, yanıt 24 saat içinde API'den gönderilir. Bot işletmenin konusunda kalmalı ve insana devir yolu olmalı.

WhatsApp'ta yapay zekâ botu yasak mı?

İşletmenin kendi hizmeti için yardımcı bot yasak değil. 15 Ocak 2026'dan beri asıl ürünü genel amaçlı yapay zekâ sohbeti olan hizmetler platformu kullanamıyor; Türkiye bu kural için Meta'nın istisna pazarları arasında.

WhatsApp'ta kayıtlı numaramı API'ye taşıyabilir miyim?

Doğrudan kayıtta önce numaradaki WhatsApp hesabını silmen gerekir. Business uygulamasını kullanmaya devam ederek bağlamak (coexistence) yalnız Meta'nın Solution Partner ya da Tech Provider firmaları üzerinden mümkün.

Günde kaç kişiye mesaj atabilirim?

Yeni hesap pencere dışında 24 saatte 250 farklı kişiye yazabilir. İşletme doğrulamasıyla 2.000'e, sonra kaliteye göre 10.000, 100.000 ve sınırsıza çıkar. Müşterinin yazdığı sohbetlere yanıt bu limite girmez.

WhatsApp otomatik mesaj gönderme programları güvenli mi?

WhatsApp Web'i QR ile bağlayan programlar resmî değil. WhatsApp Şartları toplu ve otomatik mesajı yasaklar; resmî olmayan sürümlere bağlanan hesaplar yasaklanabilir.

WhatsApp kampanya mesajı için İYS gerekir mi?

6563 sayılı Kanun ticari elektronik ileti için önceden onay ister. İYS'nin WhatsApp için ayrı kayıt isteyip istemediği resmî kaynakta net değil; onayı ispatlanabilir biçimde al ve avukatına danış. Hukuki görüş değildir.

Şablon onayı ne kadar sürer?

Meta'nın belgesine göre inceleme 24 saate kadar sürebilir. Utility seçilip içeriği pazarlama olan şablon marketing olarak onaylanır.

İlgili rehberler

Kaynaklar

Resmî kaynaklarda net olmayanlar: WhatsApp mesajları için İYS'ye ayrı kayıt gerekip gerekmediği · Türkiye fiyatlarında KDV ve vergi durumu · ücretsiz giriş penceresinin süresi (7 gün ve 72 saat, iki resmî sayfa) · doğrudan kullanımda coexistence · panelin Türkçe dil seçeneği. Her biri ilgili bölümde ne yapabileceğinle birlikte yazılı.