Makaleler
WhatsApp Business API rehberi: erişim, şablonlar, maliyetler ve CRM kurulumu
WhatsApp Business API, bir numarayı telefon yerine yazılıma bağlamanın Meta'daki resmî yoludur. Neye ihtiyacınız olduğunu, ne kadara mal olduğunu ve günlük işte nelerin değiştiğini anlatıyoruz.
WhatsApp Business API nedir?
Bir uygulama değil, bir arayüzdür. İndirilecek bir şey yoktur, giriş yapılacak bir ekran da yoktur. Yazılımınız (bir CRM, bir destek masası ya da kendi yazdığınız bir betik) WhatsApp ile bu arayüz üzerinden konuşur: gelen mesajlar bir webhook adresine düşer, yanıtlar API çağrıları olarak gider.
Meta'nın bugün belgelediği arayüz, sunucuları Meta'da duran Cloud API'dir. "whatsapp api", "whatsapp business api nedir" ya da "whatsapp cloud api" diye arama yapanların aradığı şey budur. "WhatsApp Business Platform" ise Meta'nın işletmelere yönelik mesajlaşma hizmetinin genel adıdır; Cloud API bu platformun içindeki arayüzdür.
Telefona göre kazancınız: tek numaraya birkaç kişi yanıt verebilir, mesajları yazılım gönderebilir ve her sohbet bir kişi kartının ve bir fırsatın yanında durur. Karşılığında kabul ettikleriniz ise şablon kuralları, 24 saatlik pencere ve mesaj başına ücrettir; hepsini aşağıda anlatıyoruz.
WhatsApp Business uygulaması, WhatsApp Business Web ve API arasındaki fark nedir?
- WhatsApp Business uygulaması. WhatsApp'ın küçük işletme sahipleri düşünülerek geliştirildiğini söylediği bir telefon uygulamasıdır. Tek işletme, çoğu zaman da başında tek kişi.
- WhatsApp Business Web. Aynı işletme hesabını tarayıcıda açmak için aratılan ifadedir. Yine uygulamanın sohbet penceresidir, bir entegrasyon değildir: fırsatlara, görevlere ya da raporlara hiçbir şey bağlanmaz.
- WhatsApp Business API (Cloud API). Bir programlama arayüzüdür. Numara platforma kaydedilir ve sohbetleri bir telefon değil, bir program yönetir.
Dizüstü bilgisayardan birkaç kişiye yanıt vermeniz yetiyorsa uygulama ve tarayıcı sürümü işinizi görebilir. Numarayı birkaç çalışan paylaşıyorsa, mesajların otomatik gitmesi gerekiyorsa ya da konuşmaların bir CRM'e akması isteniyorsa API'ye geçin.
Kimler erişebilir ve neler gerekir?
Meta'nın başlangıç kılavuzu bir Facebook hesabı ya da yönetilen bir Meta hesabı, geliştirici kaydı ve test mesajları için WhatsApp kurulu bir cihaz ister. Aynı akışta bir Meta işletme portföyü seçer ya da oluşturur, WhatsApp kullanım senaryosuyla bir uygulama açar ve bir telefon numarası eklersiniz.
Meta'nın telefon numaraları belgelerine göre numaranın da kuralları vardır:
- WhatsApp'ta zaten kullanılan bir numara, önce WhatsApp'tan silinmeden kaydedilemez.
- Numara size ait olmalı, ülke ve alan kodunu içermeli, doğrulama için SMS ya da sesli arama alabilmelidir.
- Kayıt sırasında bir görünen ad (display name) zorunludur. Bu ad, numaranın WhatsApp profilinde görünür.
Teste başlamak için şablon gerekmez: Meta'nın kendi hızlı başlangıç rehberi hazır bir hello_world şablonu gönderir. Müşteriye ilk siz yazdığınızda ya da pencere kapandıktan sonra yanıt verdiğinizde ise kendi onaylı şablonlarınız gerekir.
24 saatlik pencere nasıl işler?
Bir müşteri size yazdığında ya da sizi aradığında 24 saatlik bir pencere açılır. Müşterinin her yeni mesajı süreyi baştan başlatır. Pencere açıkken serbest metinli mesaj gönderebilirsiniz. Kapandığında yalnızca şablon mesajlara izin verilir (bu kural Meta'nın fiyatlandırma sayfasında yazar).
Şablonlar üç kategoriye ayrılır: pazarlama, bilgilendirme (utility) ve kimlik doğrulama. Şablonu WhatsApp Manager'da oluşturursunuz, Meta da inceler; yeni bir şablonun kullanıma girmesi için bir süre beklemeyi hesaba katın.
Meta, WhatsApp Business API için nasıl ücret alır?
Meta'nın fiyatlandırma sayfasına göre (18 Kasım 2026'da kontrol edildi):
- Meta, 1 Temmuz 2025'ten beri konuşma başına değil, iletilen mesaj başına ücret alır. Fiyat, mesajın kategorisine ve alıcının ülke telefon koduna göre değişir.
- Müşterilerin size gönderdiği mesajlar ücretlendirilmez.
- Şablonlar pazarlama, bilgilendirme ya da kimlik doğrulama kategorisindedir; pencere içinde şablonsuz verilen yanıtlar ise müşteri hizmetleri (service) mesajıdır. Meta ayrıca Meta Business Agent'ı da listeler.
- Her işletme telefon numarasına ayda 1.000 ücretsiz müşteri hizmetleri mesajı tanınır ve bu kota her ay yenilenir. 1 Ekim 2026'dan itibaren 1.001'inci mesajdan sonraki müşteri hizmetleri mesajları ücretlidir.
- Mesajlaşma hesabında ödeme yöntemi yoksa Meta, müşteri hizmetleri mesajlarını yalnızca ücretsiz kota dahilinde iletir.
- Açık pencere içinde gönderilen bilgilendirme şablonları 30 Eylül 2026'ya kadar ücretsizdi; 1 Ekim 2026'dan itibaren ücretlendiriliyor.
- Müşteri mobil uygulamada bir Click to WhatsApp reklamından size yazar ve siz pencere içinde yanıt verirseniz, pazarlama, bilgilendirme, kimlik doğrulama ve müşteri hizmetleri mesajları için 7 güne kadar süren ücretsiz bir giriş penceresi açılır.
Dolar cinsinden tarifeler, Meta'nın bu sayfada bağlantısını verdiği ücret tablosu dosyalarında yer alır ve ülkeye ve kategoriye göre değişir. Bütçe yapmadan önce kendi ülkeleriniz için dosyaya bakın; bu yazıda hiçbir tarife verilmiyor.
Meta'nın ücretleri, bağladığınız WhatsApp hesabına yansır. CRM ya da başka bir yazılım sağlayıcısı bunun üstüne kendi ücretini alır.
Bu yolla pazarlama mesajı göndermek ve bot kullanmak mümkün mü?
Evet, Meta'nın kuralları içinde: pazarlama şablonları kendi fiyatı olan bir mesaj kategorisidir; bot ise aynı API'yi aynı pencere ve şablon kurallarıyla kullanan bir yazılımdır.
"WhatsApp API ile mesaj gönderme" pratikte iki tür çağrı demektir: pencere içinde serbest metinli bir mesaj ya da pencere dışında bir şablon mesaj. Hangisinin kullanılabileceğini müşterinin son mesajının zamanı belirler.
NeuroCRM, WhatsApp Business API'ye nasıl bağlanır?
NeuroCRM, WhatsApp'ı bağlamanın iki yolunu destekler. İkisinin daha ayrıntılı karşılaştırması için WhatsApp CRM: resmî API mi QR geçidi mi yazısına bakın. Bu sayfa API tarafını ayrıntısıyla anlatıyor.
Cloud API'yi elle bağlamak
Ayarlar → Entegrasyonlar bölümünde WhatsApp Business Cloud API'yi seçer ve dört alanı doldurursunuz:
- Telefon Numarası Kimliği (Phone Number ID): Meta'daki API Setup ekranından alınır.
- Kalıcı Erişim Belirteci (Sistem Kullanıcısı) (Permanent Access Token): Business Settings → System Users bölümünde oluşturulur.
- Uygulama Gizli Anahtarı (App Secret): gelen webhook'ların imzasını doğrulamak için kullanılır.
- WhatsApp Business Hesap Kimliği (WABA ID).
Ardından "Doğrula ve bağlan"a tıklayın. NeuroCRM size bir Geri Çağırma URL'si (Callback URL) ve bir Doğrulama Belirteci (Verify Token) gösterir; ikisini Meta uygulamanızda WhatsApp → Configuration → Webhooks bölümüne yapıştırır ve messages alanına abone olursunuz. Birden fazla numara ekleyebilirsiniz.
Tek tıkla bağlanma yoktur. Meta uygulamasını, sistem kullanıcısını ve belirteci kendiniz oluşturursunuz; ilk bağlantının biraz zaman alacağını baştan bilin. İşe başlamadan önce Meta tarafını hazırlayın.
Operatörler ne görür?
Her WhatsApp sohbeti, diğer kanallarınızla aynı gelen kutusuna kişi kartıyla birlikte düşer. NeuroCRM 24 saati müşterinin gönderdiği en yeni gerçek WhatsApp mesajından itibaren sayar ve pencereyi beş dakika erken kapanmış kabul eder.
Pencere kapalıyken NeuroCRM sizin metniniz yerine onaylı bir şablon gönderir: sizin seçtiğiniz şablonu, çalışma alanının varsayılan şablonunu ya da değişken ve medya içermeyen onaylı bir şablonu. Taslağınız, müşteri yanıt verene kadar yazma alanında bekler. Onaylı şablon yoksa gönderim reddedilir; müşteri yanıt vermeden ikinci bir şablon ancak siz listeden yeniden seçerseniz gider.
Kurallar, otomasyonlar ve yapay zekâ
- Otomasyonlar. Pencere dışında otomasyon mesaj göndermez, şablon da seçmez: adım "gönderilmedi" olarak işaretlenir. Fırsat olaylarında mesaj, kanalı ne olursa olsun kişinin en eski görüşmesine gider.
- Satış dizileri. WhatsApp adımı, o adımda adını yazdığınız onaylı şablonu gönderir.
- Yapay zekâ yanıtları. Nöro İletişim Merkezi (AI Contact Center) ücretli bir ek modüldür: ayda $200 artı başarılı her diyalog için $0.50; kendi yapay zekâ anahtarınızla %0 ek ücretle ya da NeuroCRM üzerinden +%20 ile çalışır. 24 saatlik pencerenin dışında yanıt vermez ve şablon da göndermez. Randevuyu kendi başına oluşturmaz.
Alternatif yol: GREEN-API
GREEN-API resmî olmayan bir geçittir. Kişisel bir numarayı GREEN-API konsolunda QR koduyla bağlar, ardından NeuroCRM'e idInstance ve apiTokenInstance değerlerini girersiniz. Entegrasyonun kendi açıklaması, bu yolun "resmî WhatsApp Business API'nin mevcut olmadığı durumlar" için uygun olduğunu söyler. Meta'nın platformu olmadığı için yukarıdaki şablon ve pencere kuralları bu geçit için geçerli değildir.
NeuroCRM, WhatsApp Business API ile neleri yapmaz?
- Tek tıkla bağlantı yok. Meta kimlik bilgileri elle girilir; Meta'nın Embedded Signup akışı bir düğme olarak sunulmaz.
- Coexistence yok. WhatsApp Business uygulamasında ve API'de aynı anda kullanılan bir numara NeuroCRM üzerinden çalışmaz.
- Meta'nın mesaj ücretleri kullanıcı fiyatına dahil değildir ve bunları NeuroCRM belirlemez; Meta, bağladığınız hesabı faturalar.
- Otomatik şablon seçimi yok: 24 saatlik pencere dışında ne otomasyonlar ne de yapay zekâ kendiliğinden şablon seçer.
NeuroCRM'de WhatsApp kullanmanın maliyeti nedir?
Kullanıcı başına ayda $13, yıllık ödemede $10.40; ücretsiz plan yoktur. 14 günlük deneme sınırsız kullanıcıyla her şeyi içerir, ardından çalışma alanı yalnızca okunur hale gelir. Ayrıntılar için fiyatlara bakın. Nöro İletişim Merkezi, yukarıda anlatılan ayrı ek modüldür. Meta'nın mesaj başına ücretleri ise Meta'nın faturaladığı üçüncü bir kalemdir.
Sistemleri karşılaştırmak için NeuroCRM karşılaştırmalarına ve Kommo alternatifleri rehberine bakın. WhatsApp'ın diğer kanallarınızla birlikte nasıl çalıştığını ortak gelen kutusu yazısında bulabilirsiniz.
Bağlamadan önce kontrol listesi
- Size ait olan ve doğrulama SMS'i ya da araması alabileceğiniz bir numara seçin. Numara zaten WhatsApp'ta kullanılıyorsa, önce oradan silmeyi planlayın.
- Meta işletme portföyünü, WhatsApp kullanım senaryolu uygulamayı ve kalıcı belirteci olan bir sistem kullanıcısını oluşturun.
- Görünen adı belirleyin.
- Meta tarafında bir ödeme yöntemi ekleyin; aksi halde ücretsiz kotayı aşan müşteri hizmetleri mesajları iletilmez.
- WhatsApp Manager'da en az bir bilgilendirme şablonunu onaya gönderin ve canlıya geçmeden önce Meta'nın onayını bekleyin.
- API Setup ekranından Phone Number ID ve WABA ID değerlerini not alın.
- NeuroCRM'de bağlantıyı kurun, geri çağırma URL'sini ve doğrulama belirtecini Meta'ya kopyalayın,
messagesalanına abone olun. - Kendinize bir mesaj gönderin ve yanıtlayın; sonra pencerenin kapanmasını bekleyip bir şablonu deneyin.
Sık sorulan sorular
WhatsApp Business API ücretsiz mi?
Tamamen değil. Meta iletilen her mesaj için ücret alır; müşterilerden gelen mesajlar, her numara için ayda ilk 1.000 müşteri hizmetleri mesajı ve ücretsiz giriş penceresindeki mesajlar bunun dışındadır.
WhatsApp API ile Cloud API arasındaki fark nedir?
Yeni bir kurulum için pratikte aynı şeydir: Cloud API, Meta'nın barındırdığı ve belgelediği sürümdür; NeuroCRM'in WhatsApp Business Cloud API entegrasyonu da bunu kullanır.
WhatsApp Business uygulamasındaki numaramı API ile kullanabilir miyim?
Meta'ya göre WhatsApp'ta zaten kullanılan bir numaranın kayıttan önce WhatsApp'tan silinmesi gerekir. NeuroCRM üzerinden aynı numarayı hem uygulamada hem API'de aynı anda kullanmak (coexistence) çalışmaz.
Mesajım müşteriye neden ulaşmadı?
İki yaygın neden vardır: 24 saatlik pencere kapanmıştı ve mesaj bir şablon değildi ya da ücretsiz müşteri hizmetleri mesajları bittiğinde Meta hesabında ödeme yöntemi yoktu. Kapalı pencerede NeuroCRM düz metninizi göndermez; önce onaylı bir şablon gönderir, metninizi de yazma alanında tutar.
Tek API numarasından birkaç kişi yanıt verebilir mi?
Evet. Tek numaranın sohbetleri NeuroCRM'de ortak bir gelen kutusuna düşer; birden fazla numara da bağlayabilirsiniz.
Kaynaklar
- Meta, WhatsApp Business Platform fiyatlandırması — https://developers.facebook.com/docs/whatsapp/pricing (18 Kasım 2026'da kontrol edildi)
- Meta, Cloud API ile başlangıç — https://developers.facebook.com/docs/whatsapp/cloud-api/get-started (18 Kasım 2026'da kontrol edildi)
- Meta, telefon numaraları — https://developers.facebook.com/docs/whatsapp/cloud-api/phone-numbers (18 Kasım 2026'da kontrol edildi)
- WhatsApp Business uygulaması — https://whatsappbusiness.com/products/business-app/ (18 Kasım 2026'da kontrol edildi)
Bu yazı nasıl hazırlandı: NeuroCRM ekibi tarafından yapay zekâ desteğiyle yazıldı; ürünle ilgili ifadeler NeuroCRM kodu ve yardım belgeleriyle karşılaştırıldı; fiyatlar güncelleme tarihindeki yayımlanmış fiyat listesine göre verilmiştir.