WhatsApp Business API Entegrasyonu: Kurulum ve En İyi Pratikler

01WhatsApp Business API Entegrasyonu: Kurulum ve En İyi Pratikler

WhatsApp, Türkiye'de müşterilerin en yoğun kullandığı mesajlaşma kanalıdır. WhatsApp Business uygulaması küçük işletmeler için yeterli olsa da; sipariş bildirimi, randevu hatırlatma, destek hattı ve kampanya gibi akışları yazılıma bağlamak için WhatsApp Business Platform (Cloud API) gerekir. Bu rehber entegrasyonun ön koşullarını, mesaj türlerini, kural ve maliyet yapısını ve tasarım önerilerini özetler.

02Ön Koşullar

• Meta Business hesabı: İşletmenin doğrulanmış bir Meta Business (Business Manager) hesabı olmalıdır; kurumsal doğrulama için ticari belgeler istenir.
• Telefon numarası: API'ye bağlanan numara, kişisel WhatsApp ya da WhatsApp Business uygulamasında aktif olmamalıdır. Sabit hat ya da sanal numara kullanılabilir; numara SMS ya da sesli aramayla doğrulanır.
• Erişim yolu: Doğrudan Meta Cloud API ya da bir çözüm ortağı (BSP) üzerinden. Cloud API, altyapı barındırma gerektirmez ve resmî dokümantasyonla doğrudan entegre edilebilir; BSP'ler ek panel, raporlama ve destek sunar.
• Görünen ad ve profil: İşletme adı Meta onayından geçer; profil, açıklama, adres ve web sitesi bilgileri doldurulur.

03Mesaj Türleri ve Kurallar

Servis Penceresi (24 Saat)

Müşteri size mesaj gönderdiğinde 24 saatlik bir servis penceresi açılır; bu süre içinde serbest metin (oturum mesajı) gönderebilirsiniz. Pencere dışında yalnızca önceden onaylanmış şablon mesajlar gönderilebilir. Yazılımınız her konuşma için pencerenin açık olup olmadığını izlemeli, kapalıysa şablon kullanmalıdır.

Şablon Mesajlar

Şablonlar; pazarlama, yardımcı (utility) ve kimlik doğrulama kategorilerinde Meta onayına sunulur. Değişken alanlar ({{1}}, {{2}}) sipariş numarası, tarih gibi verilerle doldurulur. Düğmeler (hızlı yanıt, bağlantı, arama) ve başlık görseli eklenebilir. Onay genellikle kısa sürede tamamlanır; reddedilen şablonlar için gerekçe döner. Kategoriye göre ücretlendirme farklıdır; yardımcı şablonlar pazarlama şablonlarından daha ekonomiktir.

Etkileşimli Mesajlar

Servis penceresi içinde liste mesajı, yanıt düğmeleri, ürün kataloğu ve konum gibi etkileşimli türler kullanılabilir. Menü tabanlı destek akışları (ör. "1 - Sipariş durumu, 2 - İade") bu türlerle daha kullanışlı hâle gelir.

04Teknik Entegrasyon

Gönderim

Mesajlar, Cloud API'nin REST uç noktasına telefon numarası kimliği ve erişim belirteciyle gönderilir. Kalıcı sistem kullanıcısı belirteci (system user token) üretilmeli, belirteç güvenli biçimde saklanmalı ve yazılım tarafında asla istemciye (tarayıcı, mobil uygulama) verilmemelidir.

Webhook

Gelen mesajlar ve durum güncellemeleri (gönderildi, iletildi, okundu, başarısız) webhook ile uygulamanıza düşer. Webhook uç noktası HTTPS olmalı, doğrulama belirteciyle kaydedilmeli ve gelen her isteğin imzası (X-Hub-Signature) kontrol edilmelidir. Webhook işleyici hızlı yanıt vermeli, asıl işi kuyruğa devretmelidir; aksi hâlde Meta yeniden gönderim yapar ve mükerrer işlem oluşabilir.

Kalite Puanı ve Sınırlar

Numaranın mesajlaşma sınırı (günlük benzersiz alıcı sayısı) kalite puanına ve doğrulama durumuna göre kademeli artar. Kullanıcıların engellemesi ve şikâyeti kalite puanını düşürür; puan düşerse şablonlar askıya alınabilir. İstenmeyen mesaj göndermemek, opt-out isteklerine anında uymak ve içerik kalitesi bu nedenle teknik bir gereklilik hâline gelir.

05KVKK ve İzinli Pazarlama

• Açık rıza (opt-in): Pazarlama mesajı göndermeden önce kullanıcının açık rızası alınmalı ve kayıt altına alınmalıdır; sipariş bildirimi gibi işlemsel mesajlar sözleşmenin ifası kapsamında değerlendirilebilir, ancak aydınlatma yükümlülüğü devam eder.
• İYS: Ticari elektronik ileti gönderimi için İleti Yönetim Sistemi kaydı ve ret bildirimlerinin işlenmesi zorunludur.
• Veri yerleşimi: Mesaj içerikleri Meta altyapısında işlenir; aydınlatma metninde yurt dışına aktarım ve sağlayıcı bilgisi yer almalıdır.
• Saklama: Konuşma kayıtlarının hangi amaçla, ne kadar süre saklanacağı belirlenmeli; destek kayıtları ile pazarlama verisi ayrı ele alınmalıdır.

06Yaygın Kullanım Senaryoları

• Sipariş ve teslimat bildirimleri: Sipariş alındı, kargoya verildi, teslim edildi şablonları; kargo takip bağlantısı düğmesi.
• Randevu ve hatırlatma: Onay ve hatırlatma şablonları; "Onayla / Yeniden planla" hızlı yanıt düğmeleri.
• Destek hattı: Gelen mesajların destek sistemine talep olarak düşmesi, temsilci ataması ve servis penceresi içinde yanıt.
• Doğrulama kodları: Kimlik doğrulama şablonlarıyla tek kullanımlık kod gönderimi.
• Yapay zeka asistanı: Sık sorulan soruların otomatik yanıtı, karmaşık konuların insana devri.

07Tasarım Önerileri

• Her konuşmayı sisteminizde tek bir kayıtta tutun; servis penceresi zamanını ve son mesaj yönünü saklayın.
• Şablonları kategori ve dil bazında sürümleyin; onay durumunu ve reddedilme gerekçelerini kayıt altına alın.
• Durum güncellemelerini işleyip "iletilemedi" mesajlarını operasyon ekibine görünür kılın.
• Opt-out ("DUR", "İPTAL" gibi) mesajlarını otomatik tanıyıp rıza kaydını güncelleyin.
• Gönderim hacmini kademeli artırın; kalite puanını düzenli izleyin.

08Sonuç

WhatsApp Business API entegrasyonu; doğru numara ve hesap kurulumu, şablon ve servis penceresi kurallarına uyum, güvenli webhook işleme ve KVKK/İYS yükümlülükleriyle birlikte planlandığında müşteri iletişiminin en etkili kanallarından biri olur. Mevcut CRM, e-ticaret ya da destek sisteminize WhatsApp entegrasyonu eklemek için ücretsiz ön değerlendirme talep edebilirsiniz.