Hedef: Business numarasını telefonda tutarak API'ye bağlamak
WhatsApp Coexistence kurulumunda amaç, mevcut WhatsApp Business numarasını telefondaki uygulamada kullanmayı sürdürürken Meta Cloud API'ye bağlamaktır. Rezervem Manager'ın bağlantı ekranı ile uygun bağımsız Connect markalarının masaüstü bağlantı yolu farklı giriş noktalarıdır.
İşleme başlamadan önce numara ve Meta Business hesabı sahipliğini, mevcut sağlayıcı bağlantısını ve kurulum yetkilisini belirleyin. İşletmenin geçmiş sohbetleri paylaşma kararı da kaydedilmelidir. Coexistence'ın klasik API'den farkları yazısını da okuyabilirsiniz.
1. Uygunluk ve numara sahipliğini doğrulayın
Telefonda güncel WhatsApp Business uygulamasının çalıştığını, numaraya erişildiğini, Meta Business Portfolio yetkisinin bulunduğunu kontrol edin. Eski Cloud API veya BSP bağlantısı varsa numarayı otomatik taşımaya çalışmayın.
Numara daha önce klasik Cloud API'ye taşınmışsa Meta, Coexistence seçeneği yerine klasik tamamlamayı gösterebilir. Bu durumda geçiş için işletme yetkilisi ve mevcut sağlayıcıyla değerlendirme yapın.
- Business uygulaması telefonda aktif.
- Meta hesabı ve yönetici yetkisi doğrulandı.
- Önceki BSP/Cloud API bağlantısı kontrol edildi.
- Numara ve geçmiş görüşme paylaşımı için işletme onayı var.
2. Rezervem'de doğru bağlantı yolunu açın
Manager kullanan işletmede WhatsApp Business Cloud bölümündeki mevcut numarayı bağlama seçeneğini kullanın. Rezervem bu yolda Meta'nın Coexistence özelliğini açan özel Embedded Signup akışını başlatır; klasik 'onboarding tamamla' formuyla aynı değildir.
Bağımsız Connect markasında yetkili kişi mobil uygulamada bağlantı bağlantısı oluşturup masaüstü tarayıcıda Meta girişini tamamlayabilir; self-servis yol hesap yetkisi ve özellik bayrağına bağlıdır. Klasik API ekleme formunu Coexistence için kullanmayın.
3. Meta ekranındaki kodu girin veya QR adımını tamamlayın
Meta penceresinde mevcut WhatsApp Business hesabınızı seçin. Resmî Facebook Business mesajı üzerinden 'Business Platform'a bağlan' doğrulaması ve kod istenebilir. Bazı bağlantı sürümleri QR gösterir; QR varsa WhatsApp Business uygulamasındaki ilgili resmî yönergeyi takip edin.
Bu QR, WhatsApp Web 'Bağlı cihazlar' QR'sı veya restoran misafir QR'sı değildir. Kodları başka personele göndermeyin. Geçmiş paylaşımı istenirse işletmenin yetkili veri koruma kararına göre devam edin.
4. Numaranın iki tarafta çalıştığını test edin
Meta onayından sonra Rezervem bağlantı durumunu kontrol edin. Numara Coexistence olarak tamamlanmış olmalı ve telefondaki WhatsApp Business uygulaması çalışmaya devam etmelidir. QR okutulmuş olması tek başına başarı kanıtı değildir.
İzinli test kişisiyle telefondan birebir görüşmeyi ve API tarafında geçerli mesaj penceresi veya onaylı şablonla test gönderimini ayrı doğrulayın. Gönderim sonucu ile teslim sonucunu karıştırmayın.
- Meta yetkilendirmesi tamamlandı.
- Numara Coexistence olarak etkin görünüyor.
- Telefon mesaj testi doğrulandı.
- API mesaj testi ve teslim sonucu kontrol edildi.
5. Geçmiş, cihazlar ve Connect kapsamını doğrulayın
Meta, izinli geçmiş senkronizasyonunda zaman sınırı uygular; son altı aya kadar desteklenen birebir mesajlar aktarılabilir. Grup sohbetleri API'ye eşitlenmez, bazı bağlı cihazlar yeniden bağlanmayı gerektirebilir.
Rezervem WhatsApp servisinde geçmiş ve Business uygulaması mesaj yankıları için kayıt mekanizması bulunur ancak bunların tümü Connect gelen kutusuna otomatik aktarılmaz. Gerçek hesapta hangi konuşmaların göründüğünü ayrı test edin. Telefonda gönderilen mesajın API'nin 24 saatlik penceresini açtığını varsaymayın.
6. Hata durumunu ve kampanya izinlerini yönetin
Meta beklenen Coexistence ekranını göstermiyorsa numaranın önceki kayıt modunu ve hesap yetkilerini inceleyin. Yetkilendirme kodu tek kullanımlıktır; oturum kapanmışsa eski kodu yeniden göndermek yerine baştan Meta bağlantısı açın. Klasik kayıtla devam ederek Business uygulamasını riske atmayın.
Canlı kampanya öncesinde Meta ücretleri, onaylı şablon, WhatsApp katılımı, ETK/İYS izinleri ve gönderim yetkilerini kontrol edin. İYS/WhatsApp kampanya rehberi ile WhatsApp API kurulum rehberi sonraki adımlardır.
- Hata durumunda sorumlu yetkili belirlendi.
- Önceki sağlayıcı ve hesap sahipliği yeniden doğrulandı.
- İzinli test kitlesi ve Meta şablon durumu kontrol edildi.
- Gönderim, teslim ve veri erişimi ayrı değerlendirildi.
Sık sorulan sorular ve resmî kaynak
QR'yi WhatsApp Web menüsünden mi okutacağım? Hayır. Meta'nın gösterdiği yöntemi, WhatsApp Business uygulamasındaki resmî bağlantı adımı üzerinden tamamlayın.
Geçmiş sohbetler mutlaka aktarılır mı? Hayır; işletmenin izni, Meta sınırları ve ilgili yazılımın entegrasyon kapsamı belirleyicidir.
Normal WhatsApp Messenger numarasıyla olur mu? Bu akış WhatsApp Business uygulaması kullanan işletmeler içindir.
Resmî kaynak: Meta Coexistence onboarding dokümanı (17 Kasım 2026 erişimi).