WhatsApp Business API Nedir? KOBİ'ler İçin Kapsamlı Rehber

WhatsApp'ın birbirine benzeyen ürün isimleri işletmelerin kafasını sürekli karıştırır. "WhatsApp Business" uygulaması ile "WhatsApp Business API" aynı şey değildir ve aradaki fark, bir işletmenin müşteri iletişimini otomatikleştirip otomatikleştiremeyeceğini belirler.

Bu rehber üç çözümü ayırır, API'nin nasıl çalıştığını mimari düzeyde açıklar, ücretlendirme mantığını ve şablon onay sürecini anlatır; sonunda kendi işletmeniz için hangisinin doğru olduğuna karar verebilecek durumda olursunuz.

WhatsApp Business API nedir?

WhatsApp Business API, işletmelerin kendi yazılımlarını WhatsApp'a bağlamasını sağlayan resmî programlama arayüzüdür. Meta bunu "WhatsApp Business Platform" adı altında sunar. Telefona kurulan bir uygulama değil, sunucudan sunucuya çalışan bir servistir.

Pratik karşılığı şudur: gelen her mesaj sizin sisteminize bir bildirim olarak düşer, yanıtı da sisteminiz üretir. Bu yüzden yapay zekâ asistanı, CRM entegrasyonu, otomatik randevu ve sipariş akışları yalnızca API katmanında mümkündür.

Üç farklı WhatsApp çözümünün karşılaştırması

Tablodaki en belirleyici satır "eş zamanlı temsilci" satırıdır. Business uygulaması tek bir telefona bağlıdır; ekip büyüdüğünde numara bir darboğaza dönüşür. API'de aynı numarayı sınırsız temsilci ve bot birlikte kullanır.

"Uygulaması yoktur" ne demektir?

WhatsApp Business API indirilebilir bir uygulama değildir. İşletme numaranız Meta'nın bulut altyapısına kaydedilir ve mesajlaşma, bağlandığınız yazılımın arayüzü üzerinden yürür. Bu nedenle API'ye geçen bir numara artık telefondaki WhatsApp uygulamasında kullanılamaz; numara tek bir ortama bağlıdır.

Nasıl çalışır? Mimarinin üç parçası

API kurulumunu anlamak için üç bileşeni ayırmak yeterlidir: numarayı barındıran altyapı, entegrasyonu sağlayan iş ortağı ve mesajları işleyen kendi uygulamanız.

Cloud API ve On-Premises farkı

Cloud API'de numaranız doğrudan Meta'nın sunucularında barındırılır; kurulum hızlıdır ve altyapı bakımı size ait değildir. On-Premises sürümde ise işletme kendi sunucusunda bir kapsayıcı çalıştırır. Meta bu ikinci modeli kademeli olarak kullanımdan kaldırmaktadır, dolayısıyla yeni kurulumlar için Cloud API varsayılan seçenektir. İkisinin ayrıntılı karşılaştırması için Cloud API ve On-Premises karşılaştırması yazımıza bakabilirsiniz.

BSP (iş ortağı) ne yapar?

BSP, Meta onaylı çözüm sağlayıcısıdır. Numara kaydı, işletme doğrulaması, şablon yönetimi ve faturalandırmayı üstlenir; siz teknik kurulumla değil iş akışıyla ilgilenirsiniz. İşletme doğrulama adımlarının dökümü için Meta işletme doğrulama rehberimiz yol gösterir.

Ücretlendirme nasıl işler?

API kullanımı, gönderilen tekil mesaj sayısına göre değil, konuşma kategorilerine göre ücretlendirilir. Meta dört kategori tanımlar:

• Hizmet (service): müşterinin başlattığı, destek amaçlı görüşmeler.
• Kullanım (utility): sipariş durumu, randevu hatırlatma gibi işlem bildirimleri.
• Pazarlama (marketing): kampanya ve tanıtım mesajları; en yüksek ücret kalemidir.
• Kimlik doğrulama (authentication): tek kullanımlık şifre ve doğrulama kodları.

Müşteri size yazdığında 24 saatlik bir hizmet penceresi açılır ve bu pencere içinde serbestçe yanıt verebilirsiniz. Pencere kapandıktan sonra iletişimi yeniden başlatmak için onaylı şablon gerekir. Meta ücret yapısını ve kategori kurallarını zaman zaman değiştirdiği için güncel tarifeyi mutlaka Meta'nın resmî fiyat sayfasından doğrulayın; kalem bazlı dökümü WhatsApp API konuşma ücretlendirmesi ve toplam maliyet tablosunu WhatsApp chatbot fiyatları yazılarımızda bulabilirsiniz. Pencere mantığının ayrıntısı için 24 saat müşteri hizmetleri penceresi yazımıza bakın.

Mesaj şablonları ve onay süreci

24 saatlik pencere dışında gönderilen her mesaj, önceden Meta onayından geçmiş bir şablon olmak zorundadır. Onay genellikle kısa sürer ancak reddedilme sebepleri nettir: yanıltıcı içerik, eksik değişken tanımı, izinsiz pazarlama ve politika dışı sektörler. Ret gerekçelerinin listesi ve düzeltme yöntemleri için şablon onay ve ret nedenleri yazımızı inceleyin.

Pazarlama şablonu gönderebilmek için müşteriden açık rıza almanız gerekir. Rıza toplama yöntemleri ve KVKK uyumu için opt-in ve açık rıza toplama rehberimiz kullanılabilir.

Kurulum adımları

1. Meta Business hesabı: işletme hesabı açılır ve doğrulama belgeleri yüklenir.
2. Numara seçimi: API'ye taşınacak numara belirlenir; hâlihazırda WhatsApp uygulamasında kayıtlıysa önce oradan silinmesi gerekir. Ayrıntı için numarayı API'ye taşıma yazımıza bakın.
3. İş ortağı bağlantısı: BSP üzerinden numara kaydedilir ve doğrulama tamamlanır.
4. Şablon oluşturma: sık kullanılan bildirim metinleri onaya gönderilir.
5. Yazılım entegrasyonu: gelen mesaj bildirimleri uygulamanıza bağlanır, yanıt akışı ve bot kurgusu tanımlanır.
6. Test ve devreye alma: gerçek trafiğe açmadan önce devir kuralları ve mesai dışı davranış sınanır.

Kalite puanı ve gönderim limitleri

Meta her numaraya, kullanıcı geri bildirimlerine dayanan bir kalite puanı verir. Engellenme ve şikâyet arttığında puan düşer, gönderim limitleri daralır ve en kötü durumda numara askıya alınır. Bu yüzden izinsiz toplu gönderim, API kullanımında en pahalı hatadır. Limit kademeleri ve puanı yükseltme yöntemleri için kalite puanı ve gönderim limitleri yazımıza bakabilirsiniz.

KOBİ'ler için karar dengesi

Günde birkaç mesaj alan, tüm yanıtları tek kişinin verdiği mikro işletmeler için Business uygulaması yeterlidir; API gereksiz karmaşıklık getirir. API'ye geçiş şu eşiklerden biri aşıldığında anlamlı hale gelir: aynı numaraya birden fazla kişinin bakması gerekmesi, mesai dışı gelen taleplerin kaybedilmesi, randevu veya sipariş bildirimlerinin elle gönderiliyor olması.

Birden fazla şubesi olan işletmelerde tek numara üzerinden şubeye yönlendirme mümkündür; kurgunun nasıl yapıldığını çok şubeli işletmelerde yönlendirme yazımızda anlattık. Reklamdan doğrudan sohbet başlatmak isteyenler için Click to WhatsApp reklamları rehberimiz uygundur.

Sık yapılan beş hata

• Korsan QR araçlarıyla otomasyon kurmak: resmî olmayan yöntemler numaranın kalıcı olarak engellenmesine yol açar.
• İzinsiz listeye toplu pazarlama göndermek: kalite puanını düşürür ve limitleri daraltır.
• Numarayı API'ye taşımadan önce yedek almamak: uygulamadaki eski sohbet geçmişi API'ye aktarılmaz.
• Her mesaj için şablon oluşturmaya çalışmak: 24 saatlik pencere içinde şablon gerekmez, serbest metin yeterlidir.
• Devir kuralı tanımlamamak: botun aktaramadığı görüşmeler müşteri kaybına dönüşür.

BozLat AI ile kurulum

BozLat AI, işletme doğrulamasından şablon yönetimine ve yapay zekâ asistanının eğitimine kadar API kurulumunun tamamını üstlenir; siz yalnızca işletme bilgilerinizi panele girersiniz. Paketleri ve kapsamı görmek için BozLat AI fiyatlar sayfamızı ziyaret edebilirsiniz.

Resmî yeşil onay rozeti sürecini merak ediyorsanız yeşil tik ve resmî işletme hesabı yazımız süreci adım adım açıklıyor.