Ne işe yarar?
Meta Business hesabı ile WhatsApp Cloud API bağlantısı. Aynı numara, WhatsApp Business uygulamasında (yeşil işletme uygulaması) açık kalabilir.
Neden önemli?
Doğrulanmamış numara ile otomasyon çalışmaz. Uygulama ve panel birlikte kullanılacaksa kurulumun coexistence (ortak kullanım) akışından geçmesi gerekir.
Detaylı açıklama
Panel duyuruları, web push, e-posta özetleri ve (kuruluysa) WhatsApp/SMS kanalları birbirini tamamlar. Kritik operasyon olayları için en az iki bildirim kanalı açmanız önerilir.
WhatsApp, Meta Cloud API (Business uygulaması, numara doğrulama, webhook) üzerinden bağlanır. Webhook URL ve verify token birebir olmalıdır; SSL hatası doğrulamayı düşürür. Şablonlar onaylanmadan otomasyon (fatura, sipariş) çalışmaz. Test mesajı panelde görünmeden canlı kural açmayın.
Aynı numara hem WhatsApp Business uygulamasında hem panelde çalışabilir (Meta: Coexistence). Bunun için:
- Telefonda WhatsApp Business 2.24.17 veya üzeri gerekir (kişisel mavi WhatsApp değil).
- Kurulum sırasında uygulamada Facebook Business hesabından gelen Connect mesajını onaylayın; sohbet geçmişini paylaşmayı seçebilirsiniz.
- Kurulumdan sonra uygulamayı birkaç dakika açık tutun. Geçmiş senkronu 24 saat içinde başlatılmazsa Meta bağlantıyı düşürür; akış yeniden yapılır.
- 1:1 sohbetler iki tarafta da görünür. Grup, yayın listesi, arama ve katalog panelde senkronize edilmez.
- Uygulamadan gönderilen mesajlar ücretsizdir ve Cloud API 24 saat serbest metin penceresini açmaz veya uzatmaz. Pencere yalnızca müşteri, numara API’ye bağlandıktan sonra yazınca açılır. Panelden giden API mesajları normal Cloud API fiyatına tabidir.
- Koparma: WhatsApp Business uygulaması > Ayarlar > Hesap > Business Platform > Disconnect. Panelden
Deregisterile coexistence numarası düşürülmez.
Ön koşullar
- Panele giriş yapılmış aktif kullanıcı hesabı.
- Kanal bazlı kurulumlarda ilgili üçüncü taraf hesap (Meta Business, Verimor vb.).
- Ortak kullanım için WhatsApp Business uygulaması 2.24.17+.
Adımlar (Menü > Entegrasyonlar > Mesajlaşma)
- Panelde Facebook ile WhatsApp Kurulumu ile Embedded Signup’ı açın.
- Facebook ekranında mevcut WhatsApp Business numaranızı yazın. Hesap listesi yerine “mevcut WhatsApp Business hesabını bağla” ekranı gelmelidir.
- Telefonda resmi Facebook Business hesabından gelen mesajda Bağlan’a, ardından Business Platformuna bağlanın adımına basın. Sohbet geçmişini paylaşmak isteğe bağlıdır.
- Panelde gösterilen webhook URL’ini Meta’ya girin (yeni kurulumda otomatik abone olunur).
- Test mesajı gönderip panelde göründüğünü doğrulayın. Uygulamadan da bir mesaj yazıp panelde yansıdığını kontrol edin.
- Şablon mesajları onaylatın (fatura, kargo, genel).
24 saat penceresi
Müşteri yazdıktan sonra serbest metin; dışında yalnızca onaylı şablon. Fatura otomasyonu şablon kategorisine uymalıdır. WhatsApp Business uygulamasından verilen cevap, panelin serbest metin hakkını uzatmaz.
Sık karşılaşılan hatalar
- Webhook doğrulanmıyor — HTTPS, tam URL ve verify token eşleşmesi. HTTP 403/404 için reverse proxy.
- Numara başka WABA’da — Numarayı eski hesaptan çıkarıp yeni WABA’ya taşıyın; Meta destek.
- Kurulum sonrası uygulama kapandı — Coexistence’ta
/registerçağrılmaz. Hâlâ kapanıyorsa destek ile token veis_on_biz_appdurumunu kontrol edin. - Geçmiş gelmedi — İşletme paylaşmayı reddettiyse (Meta 2593109) kurulum bozulmaz; yalnızca geçmiş boş kalır. 24 saat içinde senkron başlamadıysa akışı yeniden çalıştırın.
Sık sorulan sorular
Kişisel WhatsApp olur mu?
Hayır. Kişisel (mavi) WhatsApp ve “WhatsApp Web” oturumu entegrasyon değildir. Yalnızca WhatsApp Business uygulaması Cloud API ile aynı numarada kalabilir.
Birden fazla numara?
Mağaza/WABA başına yapılandırma. Karışık gönderim yanlış müşteri riski.
Bağlı cihazlar?
Kurulum bağlı cihazları koparır. Windows ve Wear OS companion desteklenmez; bu cihazlardan gelen mesaj panelde görünmeyebilir.
İlgili rehberler
Hâlâ çözülmedi?
- Destek talebi açın — kısa başlık, ana mağaza ID, mağaza adı, ekran görüntüsü ve tam hata metnini ekleyin.
- WhatsApp: 0850 242 32 78 (mesai saatleri içinde yanıt verilir).
- Sipariş veya fatura tamamen durduysa Acil: sipariş veya fatura kesilemiyor makalesindeki kontrol listesini uygulayın.