Türkiye'de bir müşteri size ulaşmak istediğinde ilk açtığı uygulama büyük olasılıkla WhatsApp'tır. Peki bu kanalı, telefonunuzdaki yeşil uygulamadan mesaj yazan bir kişiye bağımlı olmaktan çıkarıp; 7/24 çalışan, yapay zekâ destekli, kendi arayüzünüzden yönettiğiniz bir müşteri destek sistemine nasıl dönüştürürsünüz? Cevap: WhatsApp Business Cloud API ve arkasına koyacağınız Claude (Anthropic) API.

Bu yazı, konuyu yüzeysel geçmiyor. "Yeni API tam olarak nedir", neden bu numarayı telefonunuzda kullanamazsınız, webhook ile kendi WhatsApp arayüzünüzü nasıl kurarsınız ve en çok karıştırılan konu olan mesaj şablonları (templates) ile 24 saat kuralını baştan sona anlatıyoruz. Ardından araya Claude'u koyup otonom bir destek asistanı kurmanın mimarisini gösteriyoruz.

"Yeni API" tam olarak ne? WhatsApp Business Cloud API

Karışıklığın ilk kaynağı isimler. Ortada üç farklı şey var:

  • WhatsApp (kişisel uygulama): Telefonunuzdaki normal WhatsApp.
  • WhatsApp Business App: Küçük işletmeler için, yine telefondan elle yönetilen uygulama.
  • WhatsApp Business Platform (Cloud API): Meta'nın kendi bulutunda barındırdığı, programatik API. "Yeni API" dediğimiz budur. Eski, kendi sunucunuza kurduğunuz On-Premises API'nin yerini aldı; artık altyapıyı Meta yönetiyor, siz sadece API'ye bağlanıyorsunuz.

Cloud API, bir yazılımın (sizin sisteminizin) WhatsApp üzerinden mesaj gönderip almasını sağlar. Yani insan değil, kod konuşur. İşte gücü de, kuralları da buradan gelir.

Kritik nokta: Bu numarayı telefonunuzda kullanmazsınız

En sık yapılan kavram hatası: "API'yi bağlayınca telefonumdaki WhatsApp'tan da bakarım." Hayır. Bir telefon numarasını Cloud API'ye kaydettiğinizde, o numara artık normal WhatsApp veya WhatsApp Business uygulamasında aynı anda kullanılamaz. Numara bir "API numarası" hâline gelir.

Bu yüzden pratikte şu yolu öneririz: müşteri iletişimi için ayrı, yalnızca API'ye adanmış bir numara kullanın. Mevcut kurumsal numaranızı elle de kullanmaya devam etmek istiyorsanız, onu API'ye taşımayın; yeni bir hat ayırın. Böylece "telefondan da bakayım" beklentisi yüzünden sistem bozulmaz.

Peki mesajları nerede göreceksiniz? Cevap bir sonraki bölümde: kendi arayüzünüzde.

Webhook ile kendi WhatsApp arayüzünüzü kurmak

Cloud API iki yönlü çalışır:

  • Gelen mesajlar (inbound): Bir müşteri size yazdığında Meta, olayı bir webhook ile sizin sunucunuza anında HTTP POST olarak gönderir. Yani mesajları "çekmeye" çalışmazsınız; Meta size iter. Aynı kanaldan teslim/okundu bildirimleri de gelir.
  • Giden mesajlar (outbound): Yanıt göndermek için Meta'nın Graph API'sindeki /messages uç noktasına bir istek atarsınız (telefon numarası kimliğiniz + erişim token'ı ile).

Bu iki uç sayesinde kendi WhatsApp arayüzünüzü kurabilirsiniz: gelen her mesajı webhook'ta yakalar, veritabanınıza (ve CRM'inize) kaydeder, kendi panelinizde bir "gelen kutusu" olarak gösterirsiniz. Temsilci oradan yanıtlar, geçmiş konuşma müşteri kartında birikir. Yeşil uygulamaya hiç ihtiyaç yok. Webhook'un doğrulanması (verify token) ve gelen isteklerin imza ile (app secret) kontrolü, güvenliğin temel adımlarıdır.

Şablonlar (templates) ve 24 saat kuralı — en çok karıştırılan konu

Burası herkesin takıldığı yer, o yüzden net anlatalım. WhatsApp, işletmelerin insanları spam'lemesini engellemek için katı bir kural koyar:

24 saatlik müşteri hizmetleri penceresi

Bir müşteri size mesaj attığı anda 24 saatlik bir pencere açılır. Bu pencere içinde ona serbest metin (istediğiniz içerikte) mesajlar gönderebilirsiniz — normal bir sohbet gibi. Müşteri her yeni mesaj attığında pencere yeniden 24 saate uzar.

Pencere kapandığında ya da hiç açılmadığında: sadece onaylı şablonlar

Şimdi kritik cümle: Size hiç yazmamış birine, API üzerinden serbest mesaj gönderemezsiniz. Aynı şekilde 24 saatlik pencere kapandıysa da serbest metin gönderemezsiniz. Bu iki durumda tek yol, önceden Meta tarafından onaylanmış bir mesaj şablonu (template) göndermektir.

Yani "elimde 5.000 numara var, hepsine kampanya atayım" senaryosunda, o kişiler size daha önce yazmadıysa, ancak onaylı şablonla ve kişilerin izni (opt-in) varsa ulaşabilirsiniz. Şablonlar Meta onayından geçer ve kategorilere ayrılır:

  • Utility (hizmet): Sipariş durumu, randevu hatırlatması, kargo bilgisi gibi işlemsel mesajlar.
  • Marketing (pazarlama): Kampanya, duyuru, yeniden etkileşim mesajları.
  • Authentication (kimlik doğrulama): Tek kullanımlık şifre (OTP) mesajları.

Özetle mantık şu: Müşteri konuşmayı başlatırsa → 24 saat serbest konuşursunuz. Siz başlatmak istiyorsanız → onaylı şablon + izin şarttır. Bu kuralı bilmeden kurulan her sistem, ilk kampanyada duvara toslar.

Not: Meta'nın konuşma/şablon ücretlendirmesi kategori bazlıdır ve zaman zaman güncellenir; güncel fiyatlandırmayı başlamadan önce Meta'nın resmi dokümanından teyit edin.

Araya Claude API'yi koymak: otonom müşteri destek programı

Şimdi asıl güzel kısım. Gelen mesajı webhook'ta yakalıyorsunuz — peki cevabı kim yazacak? İşte burada Claude API devreye giriyor. Akış şöyle işler:

  • 1. Müşteri WhatsApp'tan yazar → Meta webhook ile mesajı sunucunuza iletir.
  • 2. Sunucunuz (ör. Laravel) mesajı alır, konuşma geçmişini ve müşteri bağlamını (CRM'den) toplar.
  • 3. Bu bağlamı bir sistem talimatı ile birlikte Claude'un Messages API'sine gönderirsiniz: "Sen X markasının destek asistanısın, şu kurallara uy, şu bilgilere sahipsin…"
  • 4. Claude yanıtı üretir. Gerekirse araç kullanımı (tool use) ile sisteminizdeki gerçek veriye erişir: sipariş sorgula, stok bak, randevu oluştur, iade başlat.
  • 5. Yanıtı, 24 saatlik pencere açıksa serbest mesaj olarak WhatsApp API'den geri gönderirsiniz. Pencere kapalıysa uygun bir şablonla devam edersiniz.

Bu mimariyle asistanınız sadece "hazır cevap veren bir bot" olmaktan çıkar; şirketinizin verisine bağlı, akıl yürütebilen bir destek katmanına dönüşür. Claude'un araç kullanımı sayesinde "siparişim nerede?" sorusuna gerçek kargo durumuyla, "yarın randevu var mı?" sorusuna gerçek takvimle cevap verir. Prompt caching ile tekrar eden sistem talimatını önbelleğe alıp maliyeti düşürürsünüz; insana devir (handoff) kuralları ile hassas konularda konuşmayı bir temsilciye aktarırsınız.

Bununla neler yapılabilir?

  • 7/24 birinci kademe destek: Sık sorulan soruları, sipariş/kargo takibini, iade sürecini gece yarısı bile anında yanıtlar.
  • Randevu ve rezervasyon: Klinik, kuaför, servis — müşteri WhatsApp'tan randevu alır, sistem takvime yazar.
  • Lead nitelendirme: Gelen talebi asistan sorularla olgunlaştırır, uygun olanı satışa yönlendirir.
  • Çok dilli destek: Türkçe, İngilizce, Almanca — Claude aynı asistanla dil değiştirir.
  • Sipariş bildirimleri: "Siparişiniz kargoya verildi" gibi işlemsel mesajlar (utility şablonlarıyla).

Dikkat edilmesi gerekenler

  • İzin (opt-in): Şablonla mesaj göndereceğiniz kişilerin iznini almış olmalısınız; aksi halde numaranızın kalite puanı düşer.
  • Kalite derecesi ve mesaj limitleri: Meta, numaranıza kalite derecesi verir ve gönderebileceğiniz günlük mesaj sayısını kademelendirir. Spam davranışı limiti düşürür.
  • KVKK / veri koruma: Müşteri verisini işlerken açık rıza, saklama ve silme süreçlerini doğru kurun.
  • Yapay zekâ güvenlik bantları: Asistana neyi yapıp neyi yapamayacağını net söyleyin; fiyat taahhüdü, hukuki tavsiye gibi konuları sınırlayın ve insana devredin.

Partnerfy ile kurulum

Bu sistemin dört ayağı var ve dördü de bizim uzmanlık alanımız: çok kanallı mesajlaşma altyapısı, API entegrasyonu (webhook + Graph API + şablon yönetimi), yapay zekâ ve otomasyon (Claude entegrasyonu, araç kullanımı, güvenlik bantları) ve CRM/ERP bağlantısı. Numaranın API'ye taşınmasından, kendi gelen kutusu arayüzünüze ve Claude destekli asistana kadar uçtan uca kurarız.

WhatsApp destek hattınızı yapay zekâyla otomatikleştirmek istiyorsanız bizimle iletişime geçin; senaryolarınızı çıkaralım ve size uygun mimariyi önerelim.

Kaynaklar