WhatsApp Business Entegrasyonu
Çok yakında — şu an kapalı beta. WhatsApp entegrasyonu üretimde çalışıyor ancak Purvisor’ın Meta uygulaması henüz genel erişime açılmadı. Bu yüzden bugün yalnızca beta erişimi tanımlanmış hesaplar kendi WhatsApp Business hesabını bağlayabilir; diğer hesaplarda bağlantı adımı Meta tarafında hata verir. Erişim için destek@purvisor.ai.
Müşterilerin WhatsApp üzerinden arayıp asistanınla konuşması da kapalı betada: bkz. WhatsApp Araması.
Bu entegrasyon, Purvisor’ın senin kendi WhatsApp Business numaranızdan müşterilere takip mesajı göndermesini sağlar — bir görüşme bittikten sonra otomatik özet/randevu bilgisi, ya da bir kadansın “WhatsApp” adımı olarak. Müşteri tanıdığı bir numaradan, gerçek bir konuşma akışında mesaj alır.
İki gönderim yolu var ve kuralları farklı — karıştırmak sessiz başarısızlık üretir.
- Aksiyonlar → WhatsApp Mesaj: onaylı şablon gönderir. Müşteri sana hiç yazmamış olsa bile ulaşır. Görüşme sonrası mesaj için doğru yol budur.
- Kadans adımı → WhatsApp: serbest metin gönderir, şablon değil. Meta serbest metne yalnızca müşterinin son mesajından itibaren 24 saat içinde izin verir. Bu pencerenin dışında mesaj Meta tarafından reddedilir ve adım sessizce başarısız olur — kadans akmaya devam eder, müşteriye bir şey gitmez.
Yani: müşteri sana yazmadıysa kadansın WhatsApp adımı çalışmaz. Soğuk temas için Aksiyonlar’daki şablonlu yolu kullan.
Ne yapar / ne yapmaz
| Yapar | Yapmaz |
|---|---|
| Onaylı şablonlarla takip mesajı gönderir (Aksiyonlar) | Gelen mesajları okumaz — entegrasyon tek yönlüdür |
| Kadans adımıyla serbest metin yollar (yalnız 24 saat penceresinde) | Teslim/okundu durumlarını panele düşürmez |
| Görüşme sonrası otomatik özet/link gönderir | Manuel sohbet/destek paneli sağlamaz |
| Numarayı panelden bağlar ve PIN ile aktive eder | Şablon oluşturma/yönetimini panelden yapmaz — şablonlar Meta’da hazırlanır |
Gelen taraf bugün çalışmıyor. Purvisor, bağlanan WhatsApp Business hesabını kendi uygulamasına abone etmiyor; bu yüzden müşterinin sana yazdığı mesajlar, teslim/okundu bilgileri ve arama olayları panele hiç düşmez. Pratik sonucu şu: kadansın 24 saatlik penceresi senin tarafında hiçbir zaman açılmaz. Bugün güvenilir tek yol Aksiyonlar → WhatsApp Mesaj (şablonlu).
Ön koşullar
- Bir Meta Business hesabı ve ona bağlı bir WhatsApp Business Account (WABA).
- WABA’ya kayıtlı, doğrulanmış bir telefon numarası (kişisel WhatsApp’ta kayıtlı olmayan bir numara).
- Meta tarafında hazırlanmış en az bir onaylanmış mesaj şablonu (utility/marketing kategorisinde). Şablonlar Meta WhatsApp Manager’da oluşturulur, Purvisor panelinde değil.
- Numaranın 6 haneli PIN’i (Cloud API kaydı için).
- (Üretimde) Purvisor’ın WhatsApp izinleri (
whatsapp_business_messaging,whatsapp_business_management) Meta App Review’dan onaylı olmalı — kendi hesabında test için development modu yeterli.
Kurulum
WhatsApp’ı bağla
Panelde Entegrasyonlar → WhatsApp Business API → Facebook ile Bağla. Facebook hesabınla giriş yapar, işletme hesabını (WABA) ve kullanılacak numarayı seçersin. Akış bitince panele dönersin; kartta bağlı numara, işletme adı ve bir durum rozeti görünür — yeşil Aktif ya da sarı Beklemede.
📸 [Ekran görüntüsü: WhatsApp Business API kartı — bağlı numara + durum rozeti]
Erişim izni 60 gün geçerli ve otomatik yenilenmiyor. Süre dolduğunda mesajlar sessizce gönderilemez hale gelir ve panelde bunu söyleyen bir uyarı yoktur — “Facebook ile Bağla” ile yeniden bağlanman gerekir. Takvimine not düşmekte fayda var.
Numarayı PIN ile aktifleştir
Durum rozeti Beklemede ise numara henüz Cloud API’ye kayıtlı değildir. Karttaki alana numaranın 6 haneli PIN’ini gir ve aktifleştir. Rozet Aktif’e dönmeden gönderim yapılamaz.
Meta’da mesaj şablonu oluştur / onaylat
Şablonlar Meta tarafında (WhatsApp Manager → Message Templates) hazırlanır. Purvisor panelinde şablon oluşturma/düzenleme ekranı yoktur; panel yalnızca onaylı şablonlarını listeler ve değişkenlerini eşlemene izin verir.
Bir takip mesajı şablonu hazırla. Örnek (utility kategorisi):
Şablon adı: gorusme_sonrasi_ozet
Kategori: Utility
Dil: Türkçe
İçerik:
Merhaba {{1}}, az önceki görüşmemiz için teşekkürler.
{{2}} için randevunuz {{3}} tarihinde planlandı.
Sorularınız için bu numaradan bize yazabilirsiniz.{{1}}, {{2}}, {{3}} çalışma anında doldurulan değişkenlerdir (ad, konu, tarih gibi). Şablonu gönder → Meta onayı genelde birkaç dakika–saat sürer. Onaylanmadan kullanılamaz.
📸 [Ekran görüntüsü: Meta WhatsApp Manager — şablon onay durumu]
Görüşme sonrası aksiyon olarak kullan (önerilen yol)
Aksiyonlar → WhatsApp Mesaj ekranında onaylı şablonunu seç ve değişkenlerini
kişi/randevu/arama alanlarına eşle (örn. {{1}} → kişinin adı). Asistan bir
görüşmeyi belirlediğin sonuçla bitirdiğinde mesaj otomatik gider.
Bu yol şablon gönderdiği için 24 saat penceresine tabi değildir — müşteri sana hiç yazmamış olsa bile ulaşır.
Kadans adımı — 24 saat kuralına dikkat
Bir kadansa “WhatsApp” adımı ekleyip metnini yazabilirsin. Ama bu adım şablon değil serbest metin gönderir.
Serbest metne Meta yalnızca müşterinin son mesajından itibaren 24 saat içinde izin verir. Pencere kapalıysa mesaj reddedilir, adım sessizce başarısız olur ve kadans akmaya devam eder. Üstelik gelen mesajlar bugün panele hiç düşmediği için o pencere pratikte hiç açılmaz. Soğuk temas gerekiyorsa yukarıdaki şablonlu aksiyonu kullan.
Test et
- Aksiyonlar → WhatsApp Mesaj ekranından kendi numarana bir test gönderimi yap.
- Şablonun değişkenleri doldurulmuş halde geldiğini doğrula.
Karttaki Test mesajı düğmesi önce Meta’nın örnek hello_world
(İngilizce) şablonunu dener, o da olmazsa serbest metne düşer. Yani test
mesajının gelmesi kendi Türkçe şablonunun onaylı olduğu anlamına gelmez —
onu ayrıca gerçek şablonla sınamalısın.
İyi uygulamalar
- Şablonları amaca göre ayır: “görüşme sonrası özet”, “randevu hatırlatma”, “ödeme bilgisi” gibi her senaryo için ayrı şablon — onay almaları ve değişkenleri yönetmek kolaylaşır.
- Marketing vs Utility kategorisi: Hatırlatma/onay/bilgi mesajları
utility; promosyon/kampanya mesajlarımarketingkategorisinde olmalı — yanlış kategori onay reddine veya kullanıcı şikayetine yol açar. - Değişkenleri kontak alanlarına bağla, sabit metin gömme — böylece her mesaj kişiselleşir.
- Opt-out’a saygı: Kullanıcı “yazmayın” derse o kontağa WhatsApp adımlarını durdur; kadansta bunu bir koşul olarak ele al.
- Görüşme + WhatsApp birlikte: En etkili akış genelde “ara → açılmazsa/kararsızsa WhatsApp özet/link → ertesi gün tekrar ara” — bunu bir kadansla kur.
Sorun giderme
| Belirti | Olası neden / çözüm |
|---|---|
| Mesaj gönderilemedi: “template not approved” | Şablon henüz onaylanmamış veya reddedilmiş → Meta WhatsApp Manager’da durumu kontrol et, gerekirse düzeltip yeniden gönder. |
| ”phone number not registered / pending” | Numara Cloud API’ye kayıtlı değil → karttaki durum rozeti “Beklemede” ise 6 haneli PIN ile aktifleştir. |
| Kadansın WhatsApp adımı çalışmış görünüyor ama mesaj gitmedi | Serbest metin 24 saat penceresi dışında reddedildi ve adım sessizce başarısız oldu. Gelen mesajlar panele düşmediği için o pencere pratikte hiç açılmıyor → Aksiyonlar → WhatsApp Mesaj (şablonlu) kullan. |
| Bir gün her şey durdu, hata yok | Erişim izni 60 günde doluyor ve otomatik yenilenmiyor → Entegrasyonlar’dan “Facebook ile Bağla” ile yeniden bağlan. |
Değişkenler boş geldi ({{1}} olarak göründü) | Aksiyon adımında değişken eşlemesi yapılmamış → her {{n}} için bir kişi alanı/sabit değer ata. |
| Mesaj gitti ama kullanıcı “spam” dedi | Yanlış kategori (utility olması gereken mesaj marketing’de) veya açık rıza yok → kategoriyi düzelt, opt-in akışını gözden geçir. |
| Bağlanmaya çalışıyorum, Facebook hata veriyor | Purvisor’ın Meta uygulaması henüz genel erişime açılmadı (kapalı beta) → destek@purvisor.ai. |
| Bağlantıyı kaldırdım ama Meta’da hâlâ görünüyor | Panelden kaldırma Meta tarafındaki izni iptal etmiyor → Meta Business Suite → İş Ortağı Uygulamaları’ndan da kaldır. |