Coexistence nedir?

Coexistence, WhatsApp Business App üzerinde çalışan hesabın Embedded Signup ile API tarafına bağlanmasını sağlar. Bu modelde QR okutma zorunlu değildir.

Klasik QR akışından farkı

QR tabanlı yöntemlerde cihaz bağlantısı ve session yönetimi daha kırılgan olabilir. Coexistence modelinde OAuth tabanlı onboarding ile daha kontrollü bir bağlantı deneyimi elde edilir.

• OAuth URL alınır
• Kullanıcı popup üzerinden yetkilendirme yapar
• code ve state ile bağlantı tamamlanır

Entegrasyon adımları

1. Auth URL oluştur

Otel bağlamı ile auth endpoint çağrılır. Bu adımda hotelId state içine gömülür.

2. Popup üzerinden yetkilendirme

Kullanıcı WhatsApp Business hesabını paylaşır ve callback ile geri döner.

3. Connect çağrısı

code + state ile bağlantı finalize edilir ve yeni social kayıt oluşturulur.

Frontend'de kritik kontrol noktaları

• Popup engelleyici kontrolü
• Timeout yönetimi
• Hata kodlarını kullanıcıya anlamlı gösterme
• Başarı sonrası social listesini anında yenileme

Provider ayrımı neden önemli?

Aynı platform altında farklı sağlayıcılar (meta, meow, coex) farklı davranışlar gerektirir. Örneğin Coexistence hesaplarında "durdur/devam" yerine bağlantı kesme akışı daha doğru olabilir.

Geçiş stratejisi

Canlıda geçiş yaparken aşağıdaki yaklaşım güvenlidir:

• Yeni bağlantıları WhatsApp API akışına yönlendir
• Eski hesapları provider etiketiyle ayır
• Operasyon ekibini yeni aksiyon setine göre bilgilendir

Sonuç

Coexistence, onboarding süresini kısaltırken bağlantı kalitesini artırır. Doğru UI ayrımları ve provider bazlı aksiyonlarla ekip için daha öngörülebilir bir operasyon kurulur.