· 7 dk okuma · Webitro ekibi

WhatsApp Chatbot API Nedir? Kurulum, Kural ve Maliyet Mantığı

WhatsApp Chatbot API, bir işletmenin WhatsApp numarasına düşen mesajları kendi yazılımına taşıyıp otomatik yanıt ürettiği resmî arayüzdür. Meta bu kapıyı yalnızca işletmelere açar; personelin telefonundaki WhatsApp uygulaması bu iş için kullanılamaz. Numara doğrulanır, gelen mesaj bir webhook adresine düşer ve cevabı sizin sunucunuz yazar. Müşteri tarafında değişen tek şey, karşısında bekleyen birinin olmamasıdır. Bu yapıyı kurmak isteyen işletmeler genelde üç şeyi merak ediyor: nereden başlanır, hangi kurallara uyulur ve maliyet neye göre şekillenir.

WhatsApp Chatbot API ile müşteri mesajlarını yanıtlayan işletme paneli
  • WhatsApp Chatbot API'de müşteri yazdıktan sonra açılan 24 saatlik pencerede serbest metin gönderilebilir; pencere kapandığında yalnızca onaylı şablon mesajlarla konuşma başlatılabilir.
  • Meta'nın konuşma ücreti mesaj kategorisine göre değişir; pazarlama, fayda ve kimlik doğrulama mesajları aynı tarifeye girmez.
  • WhatsApp Chatbot API tek başına çalışmaz; numara doğrulaması ve mesajları karşılayan bir webhook sunucusu olmadan otomasyon kurulamaz.

Yazının video özeti

Videoyu ayrı sayfada izleyin

Videonun metni

WhatsApp Chatbot API, işletmenin numarasına gelen mesajları kendi yazılımına aktarıp otomatik yanıt ürettiği resmî arayüzdür.

WhatsApp Chatbot API, numaraya gelen mesajları yazılıma aktarıp otomatik yanıt üretir. Meta bu kapıyı yalnızca işletmelere açar. Numara doğrulanır, mesaj webhook adresine düşer ve cevabı sunucunuz yazar.

WhatsApp Business API mesajlaşma iznini ve numarayı verir. Chatbot API ise bu izinle çalışan otomasyon katmanıdır. Hangi seçenek seçilirse seçilsin, otomasyonun kalitesi yazılım tarafında belirlenir.

Kurulum Meta işletme hesabı, numara doğrulaması ve webhook bağlantısıyla tamamlanır. Numara normal WhatsApp uygulamasında kullanılmamalı. Test numarasıyla selamlama, sipariş sorgusu ve insana devretme denenir.

Müşteri yazdıktan sonra açılan 24 saatlik pencerede serbest metin gönderilir. Pencere kapandığında yalnızca onaylı şablon mesajlarla konuşma başlatılır. Şablonların kategorisi de maliyeti etkiler.

Maliyet Meta konuşma ücretleri, senaryo sayısı, entegrasyonlar ve dil modeli kullanımıyla şekillenir. Konuşma ücreti doğrudan Meta tarafına ödenir. Her mesajı modele göndermek yerine kurallı akış maliyeti düşürür.

Tüm ayrıntılar ve senaryolar yazıda yer alıyor.

Kanal başına bot kurmanın mantığını telegram discord botu nasıl yapılır yazısında adım adım anlattık; WhatsApp tarafında akış benzer ilerliyor.

WhatsApp Chatbot API nedir, ne işe yarar?

WhatsApp Chatbot API, işletmenin numarasına gelen mesajları kendi yazılımına aktarıp otomatik yanıt üretmesini sağlayan resmî arayüzdür.

WhatsApp Chatbot API, bir işletmenin numarasına düşen mesajları kendi yazılımına aktarıp otomatik yanıt ürettiği resmî arayüzdür. Meta bu kapıyı yalnızca işletmelere açar; çalışanların telefonundaki WhatsApp uygulaması bu iş için kullanılamaz.

Süreç sade bir akışla ilerler: numara Meta tarafından doğrulanır, gelen mesaj bir webhook adresine düşer, cevabı sizin sunucunuz yazar. Müşteri tarafında değişen tek şey, karşısında bekleyen birinin olmamasıdır.

Asıl değer, konuşmanın işletmenin kendi verisiyle birleşmesinde çıkar. Sipariş durumu, randevu takvimi, stok ve kargo kaydı bota bağlandığında cevaplar tahmine değil gerçek kayda dayanır.

Telefonla ulaşılamayan saatlerde gelen sorular sabaha kadar beklerken, bot aynı soruları anında yanıtlar. Bu yüzden WhatsApp chatbot API, müşteri desteğini büyütmek isteyen işletmeler için en somut adımlardan biri.

WhatsApp Business API ile chatbot API aynı şey mi?

Hayır; WhatsApp Business API mesajlaşma iznini ve numarayı verir, chatbot API ise bu izinle çalışan otomasyon katmanını tanımlar.

İkisi sık karıştırılıyor. WhatsApp Business API, Meta'nın işletmeye açtığı mesajlaşma altyapısıdır; numara doğrulaması, şablon mesaj onayı ve gönderim kuralları burada tanımlanır.

Chatbot API ise o altyapının üstünde çalışan katmandır. Gelen mesajı yorumlayan, veritabanına bakan, gerekirse bir yapay zekâ modeline soran ve cevabı yazan kısım sizin yazılımınızdır.

Meta'nın Cloud API seçeneği kurulumu hızlandırır; barındırmayı Meta üstlenir. Şirket içi sunucuda çalışan sürüm ise veriyi kendi ortamında tutmak isteyen ekipler için tercih edilir.

Hangi seçenek seçilirse seçilsin, otomasyonun kalitesi yazılım tarafında belirlenir. Aynı altyapıyı kullanan iki işletmeden biri müşteriyi memnun ederken diğeri aynı soruyu tekrar tekrar sorabiliyor.

WhatsApp chatbot API nasıl kurulur?

Kurulum, Meta işletme hesabının açılması, numaranın doğrulanması ve mesajları karşılayacak webhook adresinin bağlanmasıyla tamamlanır.

İlk adım işletme doğrulamasıdır. Meta Business hesabı açılır, şirket bilgileri ve vergi belgeleri yüklenir, kullanılacak telefon numarası hesaba bağlanır. Bu numara normal WhatsApp uygulamasında kullanılmamalı.

Ardından webhook adresi tanımlanır. Meta, gelen mesajları bu adrese gönderir; sizin sunucunuz da cevabı aynı kanaldan geri yazar. Adresin HTTPS olması ve erişim anahtarlarının doğru saklanması şart.

Test numarasıyla birkaç senaryo denenir: selamlama, sipariş sorgusu, bilinmeyen soru, insana devretme. Bu denemeler canlıya çıkmadan önce hangi cevabın nerede takıldığını gösterir.

Kanal başına bot kurmanın mantığını telegram discord botu nasıl yapılır yazısında adım adım anlattık; WhatsApp tarafında akış benzer ilerliyor.

Son adım ölçüm. Hangi soruların bota geldiğini, hangilerinin insana kaldığını görüyorsanız sistemi büyütmek kolaylaşır. Aksi hâlde bot çalışıyor görünür ama nerede tıkandığı belirsiz kalır.

Webhook ve 24 saat kuralı pratikte ne anlama gelir?

Müşteri yazdıktan sonra açılan 24 saatlik pencerede serbest metin gönderebilirsiniz; pencere kapandığında yalnızca onaylı şablon mesajlarla geri dönebilirsiniz.

WhatsApp'ta otomasyonun sınırını kural belirler, teknik değil. Müşteri size yazdığı anda başlayan 24 saatlik pencerede serbest metinle cevap verebilirsiniz; bu süre dolduğunda yalnızca Meta'nın onayladığı şablonlarla konuşma başlatabilirsiniz.

Bu ayrım sipariş hatırlatması, kargo bildirimi ve randevu onayı gibi akışlarda belirleyici oluyor. Şablon onayı geciken bir işletme, kampanyasını planladığı gün gönderemeyebilir.

Şablonların kategorisi de maliyeti etkiler. Pazarlama, fayda ve kimlik doğrulama mesajları aynı kefeye girmiyor; Meta hangi kategoride ne kadar konuşma ücreti alacağını kendi tarifesinde yayınlıyor.

Bu yüzden şablon metinlerini kurulumun ilk günlerinde hazırlayıp onaya göndermek, ileride takvime sıkışmamak için iyi bir alışkanlık.

Hazır platform mu, özel yazılım mı?

Görüşme hacmi düşük ve akış basitse hazır platform yeterli olur; işletmeye özel veri, ödeme ve kayıt sistemleri işin içine girdiğinde özel yazılım daha esnek çalışır.

Hazır araçların en büyük avantajı hız. Şablon bir akış seçip kısa sürede yayına geçebiliyorsunuz. Karşılığında arayüz, kurgu ve entegrasyon konusunda aracın sınırlarına bağlı kalıyorsunuz.

Akış karmaşıklaştığında tablo dönüyor. Kendi stok, muhasebe ve kargo sisteminizle konuşan bir bot, paket bir araçla genelde yarım yamalak bağlanır; özel yazılımda bu bağlantı doğrudan kurulur.

Sektörünüze uygun bir çözüm arıyorsanız yapay zekâ chatbot hizmetimiz, numara kurulumundan senaryo tasarımına kadar süreci birlikte yürütüyor.

Otomasyonun başka kanallarla nasıl birleştiğini merak edenler için yapay zeka otomasyonu nedir yazısı iyi bir başlangıç.

Maliyet neye göre değişir?

Maliyet; Meta'nın konuşma ücretleri, senaryo sayısı, entegre edilecek sistemler ve yapay zekâ modeli kullanımı olmak üzere dört kalemde şekilleniyor.

İlk kalem Meta tarafındaki konuşma ücreti. Bu tutar mesaj kategorisine göre değişiyor ve doğrudan Meta'ya ödeniyor; yazılım firmasının payı değil. Kategori dağılımını bilmeden sağlıklı bir bütçe çıkmaz.

İkinci kalem senaryo sayısı. Tek bir soru-cevap akışı ile sipariş, iade, randevu ve teknik destek akışını yönetmek aynı emek değil. İş büyüdükçe test yükü de artıyor.

Üçüncü kalem entegrasyonlar. CRM, ERP, e-ticaret altyapısı ve kargo takibi bağlandıkça işin büyüklüğü belirgin biçimde değişir. Dördüncü kalem ise dil modeli kullanımı; her mesajı modele göndermek yerine kurallı akışla çözmek maliyeti düşürür.

Bütçe hesabının mantığını özel yazılım maliyeti yazımızda ayrıntılı anlattık; oradaki kalemler chatbot projelerinde de birebir geçerli.

En sık yapılan üç hata

Botu her soruya cevap vermeye zorlamak, insana devretme yolunu kapatmak ve senaryoları test etmeden yayına almak en sık görülen üç hatadır.

Birinci hata, botu bilmediği konuda da konuşturmak. Model emin olmadığı bir soruya kendinden emin bir cevap yazabiliyor; bunun yerine "bu konuyu ekibe aktarıyorum" demesi çok daha güvenli.

İkinci hata, insana devretme kapısını kapatmak. Müşteri iki turdur aynı soruyu soruyorsa ya da kızgın yazıyorsa konuşma gerçek bir kişiye geçmeli; aksi hâlde bot şikâyeti büyütür.

Üçüncü hata, testi atlamak. Yanlış fiyat, yanlış kargo durumu ya da yanlış şube bilgisi veren bir bot, hiç bot olmamasından daha çok zarar verir. Yayın öncesi onlarca senaryo denenmeli.

Tek tek kural yazmak yerine hedefi verip konuşmayı planlayan bir yapay zekâ ajanı kurmak, değişen sorulara karşı daha dayanıklı bir bot ortaya çıkarıyor.

Sektörünüze uygun bir çözüm arıyorsanız yapay zekâ chatbot hizmetimiz, numara kurulumundan senaryo tasarımına kadar süreci birlikte yürütüyor.

Sıkça Sorulan Sorular

WhatsApp Chatbot API için ayrı bir numara mı gerekiyor?

Evet. İşletmeye ait ve normal WhatsApp uygulamasında kullanılmayan bir numara bağlanmalı; aynı numarayı hem telefondaki uygulamada hem API tarafında kullanmak mümkün değil.

Kurulum ne kadar sürer?

Meta tarafındaki işletme doğrulaması ve numara onayı birkaç günü bulabiliyor. Senaryolar hazırsa teknik kurulum genelde bu onay sürecinden daha kısa sürüyor.

Bot, insan gibi mi konuşmak zorunda?

Zorunda değil ama kısa ve net cevap veren bir ton müşteriyi daha az yoruyor. Gereksiz uzun yanıtlar konuşmayı uzatıp çözümü geciktiriyor.

WhatsApp chatbot API'yi kendim kurabilir miyim?

Teknik ekibiniz varsa evet. Webhook sunucusunu ayakta tutmak, erişim anahtarlarını yönetmek ve şablon onaylarını takip etmek gerekiyor.

Aynı bot Instagram Direct'te de çalışır mı?

Mantık benzer ama kanal kuralları ve yanıt penceresi farklı işliyor. Instagram için ayrı bir bağlantı kurmak gerekiyor.