Entegrasyon
WhatsApp Business API Entegrasyonu: Bildirimler, Destek ve Sistem Bağlantıları
WhatsApp Business API, mesajları telefondan değil yazılımınızdan gönderip almanızı sağlayan Meta'nın resmi arayüzüdür. Mağazanızı, CRM'inizi ve randevu sisteminizi bu arayüze Meta'nın kurallarına uygun biçimde bağlıyoruz.
WhatsApp Business API, işletmelerin WhatsApp mesajlarını bir yazılım üzerinden gönderip almasını sağlayan, Meta'nın resmi arayüzüdür. Telefondaki WhatsApp Business uygulaması elle yazışmak için tasarlanmıştır. API ise mesajlaşmayı mağazanıza, CRM'inize ya da randevu sisteminize bağlar: sipariş onayı ve kargo bildirimi kendiliğinden gider, müşteriden gelen mesaj doğru temsilcinin ekranına düşer.
Arama sonuçlarında WhatsApp Business API denince çoğunlukla mesaj paketi satan sağlayıcılar çıkar. Biz konuya entegrasyon tarafından bakıyoruz: hangi olayın hangi mesajı tetikleyeceğini, gelen mesajın hangi sisteme yazılacağını ve Meta'nın kurallarının bu akışa nasıl yansıyacağını tasarlıyor, bağlantıyı Laravel ile kuruyoruz. Diğer bağlantı türlerini entegrasyon hizmetleri sayfasında topladık.
Uygulama, hazır panel ya da doğrudan API entegrasyonu
WhatsApp'ı işletme için kullanmanın üç yolu var ve birçok işletme bunlardan birden fazlasını birlikte kullanır.
| Kriter | WhatsApp Business uygulaması | Sağlayıcının hazır paneli | Doğrudan API entegrasyonu |
|---|---|---|---|
| Nasıl çalışır | Telefonda elle yazışma | Web panelinden toplu gönderim ve ortak gelen kutusu | Mesajlar sizin sistemlerinizden gider ve gelir |
| Kendi sistemlerinize bağlantı | Yok | Sağlayıcının hazır bağlantıları kadar | Mağaza, CRM, ERP ve randevu sistemine doğrudan |
| Süren maliyet | Uygulama ücretsiz | Meta mesaj ücretleri ve sağlayıcı aboneliği | Meta mesaj ücretleri, barındırma ve bakım |
| Kayıtların durduğu yer | Telefonda | Sağlayıcının altyapısında | Sizin ya da sizin adınıza yönetilen sunucuda |
| Uygun olduğu durum | Az konuşma, küçük ekip | Pazarlama ekibinin kampanya gönderimi | Olaya bağlı bildirimler ve sistemlere bağlı destek |
Meta bu arayüzü Cloud API adıyla kendi altyapısında barındırır; bir ara sağlayıcı olmadan doğrudan bağlanmak mümkündür. İş ortağı sağlayıcılar (BSP) bu arayüzün üzerine panel ve toplu gönderim ekler. Kampanyalarınızı bir sağlayıcının panelinden yönetiyorsanız ve sağlayıcı API sunuyorsa, bildirimleri o API üzerinden de kurabiliriz.
İlk adım hesap ve doğrulama
API tarafında ilk iş kod yazmak değil, hesabı doğru kurmaktır. Bazı adımlar Meta'nın onayına bağlı olduğu için bunları projenin ilk haftasında başlatırız.
- Meta Business portföyü ve hesap şirketiniz adına açılır, biz geliştirici erişimiyle çalışırız.
- Başka bir WhatsApp hesabında kullanılan numaranın taşınması Meta'nın kurallarına bağlıdır. Bazen ayrı bir numara daha pratiktir.
- Müşterinin gördüğü işletme adı (görünen ad) Meta'nın incelemesinden geçer.
- İşletme doğrulaması şirket bilgileri ve alan adınızla yapılır. Doğrulanmamış hesaplar işletmenin başlattığı mesajları sınırlı sayıda kişiye gönderebilir.
- Mesaj ücretleri, tanımlanan ödeme yöntemiyle Meta'ya ya da sağlayıcınız üzerinden ödenir.
- Müşterinin WhatsApp'tan mesaj almayı kabul ettiği izin noktaları (ödeme sayfası, üyelik formu, randevu ekranı) baştan belirlenir.
Şablon mesajlar ve 24 saatlik pencere
Müşteri size yazdığında 24 saatlik bir müşteri hizmeti penceresi açılır; bu sürede serbest metin, görsel ya da belge gönderebilirsiniz. Konuşmayı siz başlatıyorsanız ya da pencere kapandıysa yalnızca Meta'nın önceden onayladığı şablonları kullanabilirsiniz.
Şablonlar üç kategoriye ayrılır. Pazarlama şablonları kampanya, indirim, yeni ürün ve sepet hatırlatma içindir. Hizmet (utility) şablonları sipariş onayı, kargo bilgisi, randevu hatırlatması ve ödeme bildirimini kapsar. Kimlik doğrulama şablonlarıyla da giriş ve onay için tek kullanımlık kodlar gönderilir.
Meta şablonu içeriğine göre inceler ve gerekirse kategorisini değiştirir. Sipariş bildirimine bir indirim cümlesi eklemek şablonu pazarlama kategorisine taşır; bu da hem ücreti hem izin şartını değiştirir. Şablondaki değişken alanlar (müşteri adı, sipariş numarası, takip bağlantısı) entegrasyon tarafından siparişten doldurulur. Engellenme ve şikâyet oranı yükselen şablonları Meta duraklatabilir, tekrarlanırsa devre dışı bırakabilir.
Ticari ileti, İYS ve yapay zeka kuralları
WhatsApp'ın kuralları, işletmenin başlattığı mesajlar için kişinin önceden izin vermesini ister. Türkiye'de kampanya ve indirim gibi ticari elektronik iletiler için ayrıca alıcının onayı ve bu onayın İleti Yönetim Sistemi'nde (İYS) kayıtlı olması gerekir. Alıcı ret verdiğinde bu bilgi hem sizin sistemlerinize hem İYS'ye işlenmelidir; ayrıntıları İYS ve SMS entegrasyonu sayfasında anlattık. Aynı kural e-posta kampanyaları için de geçerlidir (Klaviyo ve e-posta pazarlama). Sipariş ve kargo bildirimi gibi bilgilendirme mesajlarının sınırını hukuk danışmanınızla netleştirmenizi öneririz.
Yapay zeka tarafında da bir kısıt var: Meta'nın kuralları, işletmenin hizmetiyle ilgisi olmayan genel amaçlı yapay zeka sohbet asistanlarının WhatsApp Business API üzerinden sunulmasını kısıtlıyor. Sipariş, ürün, iade ve randevu sorularına cevap veren, kendi işinize odaklı bir asistan ise kurulabilir; nasıl kurduğumuzu yapay zeka chatbot geliştirme sayfasında anlattık.
WhatsApp API entegrasyonu ile kurulan akışlar
- Sipariş oluştuğunda hizmet şablonuyla bildirim gider, kargo firması takip numarasını ürettiğinde de takip bağlantısı iletilir. Kargo tarafını kargo entegrasyonu sayfasında anlattık.
- Kapıda ödemeli siparişlerde müşteriye düğmeli bir onay mesajı gider. Cevap siparişe işlenir ve onaylanmayan siparişler kargoya verilmeden ayrılır.
- Randevudan önce hatırlatma gider, müşteri düğmeyle onaylar ya da erteleme ister.
- Gelen mesaj CRM'e bağlanırken telefon numarasıyla müşteri kartı bulunur ve konuşma ilgili temsilciye atanır. Bu yapı özel CRM yazılımı projelerinde de kullanılabilir.
- Üyelik ve giriş adımlarında doğrulama için tek kullanımlık kod gönderilir.
- Sepet hatırlatma pazarlama kategorisindedir, bu yüzden yalnızca izni ve İYS kaydı olan kişilere gider.
Tetikleyici olay basit ve az sayıdaysa n8n gibi bir otomasyon aracı da yeterli olabilir; karşılaştırmayı iş akışı otomasyonu sayfasında yaptık.
Teknik yapıda webhook, kuyruk ve durum takibi
- Gelen mesajlar ve gönderilen mesajların durumu (gönderildi, iletildi, okundu, başarısız) Meta'dan webhook ile gelir. Her isteğin imzası doğrulanır.
- Gönderimler arka planda kuyruktan çıkar, geçici hatalarda yeniden denenir ve hız sınırına uyulur.
- Yapı tekrara dayanıklıdır. Aynı sipariş olayı iki kez gelse de müşteriye tek mesaj gider.
- Numara WhatsApp kullanmıyorsa ya da şablon duraklatıldıysa kritik bildirim yedek kanal olarak SMS ya da e-postayla gider.
- Hangi olayın hangi şablonu hangi dilde kullanacağı panelden değiştirilir.
- Kayıtlarda KVKK gözetilerek mesajların ne kadar saklanacağı, kimin görebileceği ve telefon numarasının maskelenmesi baştan belirlenir.
Hangi mesajların otomatik gideceğini birlikte çıkaralım
Kullandığınız mağaza, CRM ya da randevu sistemini ve bugün elle gönderdiğiniz mesajları paylaşın. Hangisinin şablonla, hangisinin temsilciyle yürüyeceğini birlikte belirleyelim.
Entegrasyon süreci
- Mesaj envanteri. Bugün elle gönderdiğiniz mesajları ve müşterilerden gelen soru türlerini listeleriz.
- Hesap ve doğrulama. Meta Business portföyü, WhatsApp hesabı, numara ve işletme doğrulaması başlatılır.
- Şablon tasarımı. Her olay için şablon metni ve kategorisi yazılır, Meta'nın onayına gönderilir.
- Geliştirme. Mağaza, CRM ya da randevu sistemine bağlantı, webhook alımı ve kuyruk kurulur.
- Test. Test numaralarıyla her olay, hata ve ret senaryosu denenir.
- Yayın ve izleme. İletim ve okunma oranları, başarısız mesajlar ve şablon durumları izlenir.
Tek bir bildirim senaryosuyla başlayan bir entegrasyon genellikle 2 ile 4 hafta sürer. İşletme doğrulaması ve şablon onaylarının süresi Meta'ya bağlıdır.
Maliyeti belirleyen kalemler
- Bağlanacak sistemler: mağaza, CRM, ERP, randevu sistemi
- Akış, şablon ve dil sayısı
- Gelen mesajlar için temsilci paneli gerekip gerekmediği
- Yapay zeka asistanı ve temsilciye devretme kuralları
- İzin ve İYS senkronu
- Barındırma, izleme ve bakım
Meta'nın mesaj ücretleri ve varsa sağlayıcı aboneliği geliştirme bedelinden ayrıdır ve kullanıma göre değişir. Yayından sonraki şablon ve akış değişiklikleri bakım ve destek kapsamında yürür.
Mesajları tetikleyecek sistemlerde canlı deneyimimiz
- Shopify siparişlerinin Yurtiçi Kargo'ya aktarımı, takip numarasının siparişe yazılması
- Meta Conversions API ile sunucu taraflı olay gönderimi
- Laravel kuyruklarıyla çalışan, hata olunca yeniden deneyen entegrasyonlar
SSS