WhatsApp Business Uygulamasından API'ye Geçiş ve Coexistence

WhatsApp Business uygulamasından API'ye geçiş, telefondaki uygulamada kullandığınız numarayı ya da yeni bir numarayı Meta'nın resmî WhatsApp Business Platform'una, yani Cloud API'ye bağlamaktır. Mevcut numara için iki yol vardır: numarayı uygulamadan tamamen çıkarıp yalnız API'de kullanmak (tam geçiş) ya da coexistence ile aynı numarayı hem uygulamada hem API'de kullanmak. Seçtiğiniz yol sohbet geçmişinizi, uygulamadaki araçlarınızı ve mesaj ücretlerinizi doğrudan etkiler.

API'nin ne olduğunu ve uygulamadan farkını arıyorsanız önce şuna bakın: WhatsApp Business API nedir?

WhatsApp Business uygulamasından API'ye geçişin üç yolu

Geçiş ihtiyacı genellikle şu durumlarda doğar: mesajlar tek telefondan yönetilemeyecek kadar artmıştır, ekip aynı numaradan çalışmak ister ya da konuşmaları bir destek paneline veya yapay zekâ asistanına bağlamak istersiniz. Bu otomasyonun bütün resmini e-ticaret müşteri hizmetleri otomasyonu yazısında anlattık. Numara tarafında üç seçeneğiniz var:

Yeni numara en temiz başlangıçtır: eski numaranız uygulamada olduğu gibi kalır, API tarafı sıfırdan kurulur. Bedeli, müşterilere yeni numarayı duyurmak ve bir süre iki numarayı birlikte izlemektir.

Tam geçişte mevcut numara yalnız API'de yaşar. Meta'nın işletme telefon numaraları belgesine göre WhatsApp'ta kullanılan bir numara, oradaki hesap silinmeden Cloud API'ye kaydedilemez; kayıttan sonra numara arama ve SMS için kullanılabilir ama WhatsApp uygulamasında kullanılamaz. WhatsApp'ın yardım sayfasına göre hesabı silmek mesaj geçmişini de siler.

Coexistence ise mevcut numarayı bırakmadan API'ye bağlanmanın yoludur.

Coexistence nedir, Türkiye'de kullanılabilir mi?

Coexistence (birlikte kullanım), WhatsApp Business uygulamasındaki hesabınızı ve numaranızı bırakmadan Cloud API'ye bağlanmanızı sağlayan yöntemdir. Meta'nın belgelerinde "WhatsApp Business uygulaması kullanıcılarını bağlama" olarak geçer; coexistence adı destek kanallarında ve iş ortağı belgelerinde kullanılır. Bağlantıyı, Meta'nın iş ortağı statüsündeki bir sağlayıcı (Solution Partner ya da Tech Provider) Embedded Signup akışıyla kurar. Sonrasında uygulamadan ve API'den gönderilen mesajlar iki taraf arasında aynalanır: telefondan birebir yazışmaya devam ederken API tarafından yüksek hacimde mesajlaşabilirsiniz.

Türkçe içeriklerde hâlâ "bir numara aynı anda hem uygulamada hem API'de çalışamaz" cümlesine rastlanıyor. Bu, coexistence'tan önceki dönem için doğruydu. Meta bu yöntemi Şubat 2025'te iş ortaklarına açtı ve geliştirici değişiklik günlüğüne göre 23 Ekim 2025'te Türkiye'yi AB/AEA, Birleşik Krallık, Avustralya, Japonya, Güney Kore, Filipinler ve Rusya ile birlikte desteklenen ülkeler listesine ekledi.

Şartlar ve sınırlar (Meta'nın coexistence belgesi):

• WhatsApp Business uygulaması 2.24.17 veya üstü olmalı.
• Seçeneğin, çalıştığınız iş ortağının bağlantı akışında açık olması gerekir; bağlanmadan önce sağlayıcınıza sorun.
• Hem uygulamada hem API'de kullanılan numaranın işlem hacmi sabittir: saniye başına 20 mesaj. Bazı Türkçe kaynaklarda geçen "saniye başına 5 mesaj" rakamı Meta'nın belgesiyle uyuşmuyor.
• Bağlantıdan sonra iş ortağının kişileri ve sohbet geçmişini eşitlemek için 24 saati vardır; süre geçerse akışın baştan tamamlanması gerekir. Meta bu sırada uygulamanın açık tutulmasını öneriyor.

Akış kabaca şöyle işler: bağlantı ekranında mevcut numaranızı girer ve gösterilen doğrulama kodunu kopyalarsınız; ardından uygulamaya resmî Facebook Business hesabından gelen mesajda bağlanmayı onaylar, isterseniz sohbet geçmişinin paylaşılmasına izin verir ve kodu yapıştırırsınız.

Coexistence'ta neler değişir?

Meta'nın belgesindeki karşılaştırma tablosu, bağlantıdan sonra uygulamada neyin değiştiğini ve API tarafında neyin desteklendiğini listeliyor (özet):

Kısacası katalog, hızlı yanıtlar ve etiketler telefonda çalışmaya devam eder ama API'ye bağlı bir panel bunları kullanamaz. Uygulamadaki karşılama ve uzakta mesajlarını, API tarafındaki otomatik yanıtlarla çakışmayacak biçimde gözden geçirin.

Cihazlar için üç not daha:

• Bağlantı sırasında bağlı cihazların (en fazla dört) hepsi çözülür; desteklenenleri yeniden bağlarsınız. WhatsApp'ın Windows ve WearOS istemcileri desteklenmez.
• Müşteri desteklenmeyen bir istemciden yazarsa mesaj API tarafına düşmez; Meta bu durumda mesajı uygulamadan kontrol etmeyi öneriyor.
• Ana telefon yaklaşık 14 gün, bağlı cihaz yaklaşık 30 gün kullanılmazsa API bağlantısı kopabilir.

Sohbet geçmişi ve kişiler ne olur?

Coexistence'ta geçmiş telefonda yerinde kalır; API tarafına aktarılıp aktarılmayacağı sizin onayınıza bağlıdır. Onay verirseniz bağlantı anından geriye 180 günlük birebir sohbetler aktarılabilir, grup mesajları aktarılmaz. Görsel ve dosyalar yalnız bağlantıdan önceki son 14 günün mesajları için gelir; daha eski medya mesajları dosyası olmadan aktarılır. WhatsApp numarası olan kişiler de eşitlenebilir. Her eşitleme yalnız bir kez yapılabilir; tekrar gerekirse bağlantıyı kaldırıp akışı baştan tamamlamanız gerekir. Eşitlemeyi iş ortağı başlatır; geçmişin kullanacağınız panelde görünüp görünmeyeceğini bağlanmadan önce sağlayıcınıza sorun. Bağlantıdan sonra uygulamadan gönderdiğiniz yeni mesajlar da iş ortağına iletilir; Meta bunların API tarafındaki konuşma geçmişinde gösterilmesini ister.

Tam geçişte hesap silindiği için uygulamadaki geçmiş de silinir. Önemli sohbetleri önce WhatsApp'ın sohbeti dışa aktarma özelliğiyle kaydedin; dışa aktarılan dosya yalnız arşivdir, WhatsApp'a geri yüklenemez. API tarafı boş başlar.

Yeni numarada eski numaranın geçmişi uygulamada olduğu yerde kalır.

Aktarılan geçmiş müşterilerinizin kişisel verilerini içerir. Konunun genel çerçevesi yapay zekâ müşteri hizmetleri ve KVKK yazısında; kendi durumunuzu hukuk danışmanınızla doğrulayın.

Geçiş öncesi kontrol listesi

1. Yolu seçin. Uygulamayı telefonda kullanmaya devam etmeniz gerekmiyorsa yeni numara ya da tam geçiş daha sadedir; gerekiyorsa coexistence.
2. Uygulama sürümünü kontrol edin. Coexistence için 2.24.17 veya üstü gerekir.
3. Yayın listelerinizi gözden geçirin. Coexistence'ta listeler salt okunur olur, yenisi oluşturulamaz. API'de kampanya duyuruları onaylı pazarlama şablonlarıyla yapılır; izin kuralları için WhatsApp, İYS ve ticari ileti yazısına bakın.
4. Geçmişi arşivleyin. Tam geçişte hesabı silmeden önce önemli sohbetleri dışa aktarın.
5. Cihazlarınızı listeleyin. Windows uygulamasıyla çalışan ekip arkadaşınız için desteklenen bir istemci planlayın.
6. Ana telefonu etkin tutun. Uzun süre kullanılmayan ana cihaz bağlantıyı koparabilir.
7. Bağlantıyı sakin bir saate planlayın. Eşitleme birkaç dakika sürebilir ve 24 saat içinde tamamlanmalıdır; uygulama açık kalsın.
8. Kimin nereden yanıt vereceğini kararlaştırın. Aynı müşteriye hem telefondan hem panelden yazılmasın; hangi konuşmaların uygulamada kalacağını baştan belirleyin.

Ücret ve pencere: uygulamadan ve API'den giden mesajlar

Meta'nın kuralı net: coexistence'ta uygulamadan gönderdiğiniz mesajlar ücretsiz kalır, API'den gönderilenler Cloud API fiyatına tabidir. Cloud API'de ücret teslim edilen mesaj başınadır ve 1 Ekim 2026'dan beri 24 saatlik pencere içindeki serbest metinli yanıtlar (servis mesajları) da ücretlidir; her işletme numarası için ayın ilk 1.000 servis mesajı ücretsizdir. Kategoriler ve Türkiye tarifesi WhatsApp Business API fiyatları yazısında.

Müşteri hizmeti penceresi de yalnız API tarafına uygulanır:

• Pencere, müşteri size API bağlantısı kurulduktan sonra yazdığında açılır. Bağlantıdan hemen önce yazmış bir müşteriye API'den yalnız onaylı şablonla yanıt verebilirsiniz.
• Uygulamadan gönderilen mesajlar pencereye tabi değildir; API penceresini açmaz, uzatmaz ve API ücretini etkilemez.

Pratikte bağlantı sırasında cevap bekleyen bir müşteriye uygulamadan ücretsiz ve şablonsuz yazabilirsiniz; API'den serbest metinle yazabilmek içinse müşterinin bağlantıdan sonra size yeniden yazması gerekir. Kuralın ayrıntısı WhatsApp 24 saat kuralı yazısında.

Distrivo Müşteri Destek Asistanı ile WhatsApp bağlantısı

Numara tarafı netleştikten sonra sıra konuşmaları yönetecek araca gelir. Distrivo Müşteri Destek Asistanı WhatsApp'a resmî Cloud API üzerinden bağlanır:

• Resmî Cloud API bağlantısı: WhatsApp Business Platform bağlantısı panelden, Meta'nın resmî bağlantı akışıyla kurulur; şifre paylaşmaz, token kopyalamazsınız. Bu bağlantı, Meta'nın onay süreci tamamlanana kadar beta olarak hesap bazında açılıyor.
• Önce deneyin: Test kanalında hiçbir kanal bağlamadan yapay zekâyla sohbet eder, yanıtları ve üslubu numara kararı netleşmeden denersiniz.
• Tek gelen kutusu: WhatsApp konuşmaları Instagram DM ve Messenger konuşmalarıyla aynı listede durur.
• Pencere kuralına uyum: Pencere kapalıyken serbest metinli proaktif mesaj gönderilemez; destek asistanı bu durumda mesajı "gönderilemedi" olarak işaretler.
• İnsan bir tık uzakta: Konuşmayı tek tıkla devralır, işiniz bitince geri verirsiniz; müşteri yetkili istediğinde eskalasyon anında çalışır ve hiçbir ayarla kapatılamaz.
• Kademeli başlangıç: Yapay zekâ tek düğmeyle durdurulabilir; hangi gün ve saatlerde yanıt vereceğini haftalık planla belirlersiniz.
• Ayrı kalemler: Meta'nın WhatsApp mesaj ücretleri Distrivo'nun kullanım bedelinden ayrı bir konudur; Distrivo tarafında her konuşmanın maliyeti panelde ayrı görünür.

Coexistence bu yazıda Meta'nın genel bir seçeneği olarak anlatıldı. Numaranızı WhatsApp Business uygulamasında da kullanmaya devam etmek istiyorsanız, numarayı bağlamadan önce Distrivo'nun bağlantı akışında hangi yolun sunulduğunu sorun.

Kanallar, yetkiler ve fiyatlandırmanın bütünü için destek asistanını inceleyin.

Sık sorulan sorular

Mevcut WhatsApp Business numaramı API'ye taşıyabilir miyim?

Evet, iki yolla. Tam geçişte numaradaki WhatsApp hesabını siler ve numarayı yalnız Cloud API'de kullanırsınız. Coexistence'ta numara hem uygulamada hem API'de çalışır; Türkiye 23 Ekim 2025'ten beri desteklenen ülkeler arasındadır ve uygulamanın 2.24.17 veya üstü sürümü gerekir.

Geçişten sonra WhatsApp Business uygulamasını kullanmaya devam edebilir miyim?

Aynı numarada yalnız coexistence ile. Bu durumda birebir yazışma, arama, katalog ve hızlı yanıtlar uygulamada çalışmaya devam eder; kaybolan mesajlar, canlı konum ve yayın listeleri kapanır. API bağlantısını kaldırmak isterseniz bunu API'den değil uygulamanın ayarlarından yaparsınız (Meta'nın belgesinde Settings > Account > Business Platform). Tam geçişte numara uygulamada kullanılamaz.

Sohbet geçmişim kaybolur mu?

Seçtiğiniz yola bağlı. Coexistence'ta geçmiş telefonda kalır; onay verirseniz son 6 ayın birebir sohbetleri API tarafına aktarılabilir, gruplar aktarılmaz. Tam geçişte hesap silindiği için uygulamadaki geçmiş de silinir; önemli sohbetleri önceden dışa aktarın.

Yayın listelerim ne olur?

Coexistence'ta yayın listeleri kapanır: yenisini oluşturamazsınız, mevcutlar salt okunur kalır. API'de müşteriye pencere dışında yalnız onaylı şablonla yazabilirsiniz; kampanya duyuruları pazarlama şablonu kategorisine girer ve bu kategori ücretlidir.

Uygulamadan gönderdiğim mesajlar ücretli olur mu?

Hayır. Meta'ya göre coexistence'ta uygulamadan gönderilen mesajlar ücretsiz kalır; yalnız API'den gönderilenler Cloud API fiyatına tabidir. Uygulama mesajları API'nin 24 saatlik penceresini açmaz ve uzatmaz.