WhatsApp Business API Nedir? Türkiye'de Nasıl Alınır, Nasıl Çalışır?

WhatsApp Business uygulaması ile API arasındaki fark

Meta'nın işletmelerin kendi sunucusunda çalıştırdığı eski On-Premises API 23 Ekim 2025'te kapatıldı; bugün tek seçenek Meta'nın barındırdığı Cloud API'dir. "WhatsApp Business Platform" da aynı hizmetin resmi adıdır.

Kim kullanmalı?

• Günde onlarca sipariş onayı ve kargo bildirimi gönderen e-ticaret siteleri.
• Aynı numarayı birden fazla temsilcinin yönetmesi gereken ekipler.
• Kampanya ve sepet hatırlatma gönderimini segmentlere göre yapmak isteyen markalar.
• Tek kişinin yürüttüğü, günde birkaç müşteriyle yazışan küçük işletme için uygulama yeterlidir.

Nasıl çalışır?

1. MüşteriTelefonundaki WhatsApp ile yazar, mesajlarınızı alır.
2. Meta Cloud APIMesajları iletir, şablonları onaylar, kalite ve limitleri denetler.
3. WpdifyOrtak gelen kutusu, şablonlar, segmentler, kampanyalar ve raporlar.
4. E-ticaret altyapınızTicimax, Shopify, T-Soft, ikas, özel API: sipariş, kargo ve sepet verisi.

Türkiye'de WhatsApp Business API nasıl alınır?

1. Meta İşletme hesabı açın ve doğrulayın. business.facebook.com üzerinden işletme portföyü oluşturun. Doğrulama için vergi levhası, ticaret sicil gazetesi veya işletme adına fatura gibi belgeler istenir; belgedeki ad ve adres hesaptakiyle eşleşmeli. Doğrulama, alıcının gördüğü işletme adını ve bilgilerini etkiler.
2. Numarayı seçin. Yeni bir numara ya da mevcut numaranız. Numara SMS veya sesli arama ile kod alabilmeli (sabit hat da olur). Numara WhatsApp Business uygulamasında kullanılıyorsa iki yol var: uygulamadan silip API'ye taşımak ya da Coexistence ile ikisini birden kullanmak (aşağıda).
3. Platform ya da kendi yazılımınız. Cloud API'yi doğrudan Meta'dan kullanabilirsiniz; webhook, şablon yönetimi, gelen kutusu ve raporlamayı geliştirmek gerekir. Çoğu işletme Wpdify gibi bir platformla bağlanır: Facebook girişiyle açılan akış numarayı birkaç dakikada bağlar.
4. Görünen adı onaylatın. Alıcının göreceği işletme adı markanızla uyumlu olmalı; Meta uyumsuz adı reddeder.
5. Şablonları oluşturup onaylatın. Sipariş onayı, kargo bildirimi, kampanya, sepet hatırlatma metinleri önceden onaylanır.
6. Altyapınızı bağlayın. E-ticaret sisteminiz bağlandığında sipariş, kargo ve sepet olayları mesajları kendiliğinden tetikler; gelen yanıtlar ekibinizin gelen kutusuna düşer.

Mesaj kategorileri

İşletmenin başlattığı her mesaj onaylı bir şablonla gider ve bir kategoriye girer. Kategoriyi siz seçersiniz, ama Meta içeriğe göre yeniden sınıflayabilir:

Sepet hatırlatma ve kampanya içeriği "yardımcı" diye gönderilirse Meta onaylamaz ya da pazarlama olarak sınıflar. Kategori, mesajın alıcının ekranında nasıl göründüğünü de etkiler: pazarlama şablonlarında yalnız ilk birkaç satır görünür (bkz. "Devamını okuyun" neden çıkıyor?).

24 saat kuralı

Müşteri size yazdığında 24 saatlik hizmet penceresi açılır. Bu süre içinde serbest metin, görsel ve belge gönderebilirsiniz. Pencere kapandıktan sonra müşteriye yalnız onaylı şablonla ulaşılır. Coexistence kullanıyorsanız telefondaki uygulamadan yazdığınız mesajlar pencereyi açmaz; yalnız müşterinin mesajı açar.

Şablonlar ve onay

Şablon; isteğe bağlı başlık (metin, görsel, video veya belge), gövde, alt bilgi ve düğmelerden oluşur. Gövdede {{1}}, {{2}} gibi değişkenler gönderim anında dolar. Düğmeler: bağlantı, telefon, hızlı yanıt, kod kopyala. Çoğu şablon dakikalar içinde otomatik değerlendirilir; otomatik karar verilemeyenler insan incelemesine gider ve bu 48 saate kadar sürebilir. Sık ret nedenleri: içeriğin kategoriyle uyuşmaması, değişkenin mesajın en başında veya sonunda tek başına durması, yanıltıcı ifade, mevcut bir şablonla aynı içerik. Onaylı şablonun metni değiştirilemez; değişiklik yeni şablon demektir.

Kalite puanı ve mesaj limitleri

Her numaranın ve şablonun bir kalite puanı (yeşil, sarı, kırmızı) vardır; alıcıların engelleme ve şikâyet oranından hesaplanır. Düşük puanlı şablonu Meta önce duraklatır, tekrarlanırsa kapatır. Mesaj limiti ise işletme portföyü başına, 24 saatte ulaşılabilecek farklı alıcı sayısıdır: yeni portföy 250 ile başlar; son 7 günde limitin yarısını kullanan ve kaliteli mesaj gönderen portföy 2.000, 10.000, 100.000 ve sınırsız kademelerine kendiliğinden yükselir. Ayrıntı: toplu mesaj rehberi.

Mevcut numarayı kapatmadan API'ye geçmek: Coexistence

Meta, WhatsApp Business uygulamasındaki bir numaranın aynı anda Cloud API'ye bağlanmasına izin veriyor; adı Coexistence. Bağlantı sırasında numaranızı yazarsınız, telefondaki uygulamadan bir QR kod okutursunuz ve konuşma geçmişiyle rehberin panele aktarılmasını onaylarsınız. Sonrasında ekibiniz telefondan yazmaya devam eder; panel aynı sohbetleri görür, API'den giden mesajlar uygulamada da görünür.

Bilinmesi gerekenler: uygulamadan yazılan mesajlar 24 saat penceresini açmaz, panelden ilk temas yine onaylı şablonla yapılır; geçmiş ve rehber aktarımı tek seferliktir ve bağlantının ilk 24 saati içinde yapılır; son 14 günden eski medya aktarılmaz, yer tutucu olarak görünür; bağlantı sırasında uygulamanın bağlı cihazları (WhatsApp Web, masaüstü) ayrılır.

Wpdify ile WhatsApp Business API

Wpdify, numaranızı Facebook girişiyle birkaç dakikada bağlar; yeni numara ve Coexistence yollarının ikisini de destekler. Ticimax, Shopify, T-Soft, ikas, Vikaon ve özel yazılımlardan sipariş ve müşteri verisini çeker; kargo bildirimi, sipariş bilgilendirme, sepet hatırlatma ve kampanya gönderimlerini onaylı şablonlarla yapar. Gelen yanıtlar ortak gelen kutusunda, hesap durumu ve kalite puanı panelde, dönüşümler raporda görünür. Meta İşletme hesabınız yoksa kurulumu birlikte yaparız: WhatsApp'tan yazın ya da 14 gün ücretsiz deneyin.