WhatsApp Business API nasıl alınır?
WhatsApp Business API'yi Meta'dan bir başvuru formuyla almazsınız. Bir Meta işletme portföyü (business portfolio) açar, WhatsApp Business Platform'da bir uygulama oluşturur, kendinize ait bir telefon numarası kaydeder ve mesaj şablonlarınızı onaylatırsınız. Aynı adımları sizin yerinize yürüten bir çözüm ortağı (BSP) üzerinden de ilerleyebilirsiniz.
"WhatsApp Business API" derken çoğu kişi Meta'nın Cloud API adlı arayüzünü kastediyor. Bu arayüz, telefondaki WhatsApp Business uygulamasının yerine geçmez; yazılımınızın (CRM, e-ticaret sitesi, chatbot) WhatsApp üzerinden otomatik mesaj göndermesini ve almasını sağlar. Meta'nın Cloud API başlangıç belgesi süreci üç ana adım olarak veriyor: Meta uygulamasını WhatsApp kullanım senaryosuyla oluşturmak, uygulamayı bir mesajlaşma hesabına ve telefon numarasına bağlamak, ardından test mesajı gönderip webhook kurmak. Başlamak için bir Facebook ya da yönetilen Meta hesabı ve geliştirici kaydı yetiyor; test için Meta size geçici bir numara da veriyor.
Kısacası "API almak" bir sözleşme imzalamak değil, bir kurulum yapmaktır. Zor kısım düğmelere basmak değil; hangi numarayı kullanacağınıza, mesajların kime ve hangi izinle gideceğine, şablonların nasıl yazılacağına önceden karar vermektir. Bu yazı o kararları sıraya koyuyor.
Başvurudan canlıya geçişe kadar hangi adımlar var?
Aşağıdaki tablo, kendi başınıza ilerlerseniz izleyeceğiniz sırayı ve her adımda neyi hazır tutmanız gerektiğini özetliyor.
| Adım | Ne yapılır? | Hazır olması gereken |
|---|---|---|
| 1. Meta hesabı | Geliştirici kaydı ve işletme portföyü açılır | Facebook hesabı, şirket adı, yetkili e-postası |
| 2. Uygulama | Meta uygulaması WhatsApp kullanım senaryosuyla oluşturulur | Uygulama adı, portföy seçimi |
| 3. Telefon numarası | Numara eklenir, doğrulanır, API'ye kaydedilir | Size ait, SMS ya da arama alabilen numara |
| 4. İşletme doğrulaması | Şirket Meta'ya doğrulatılır | Resmî şirket belgeleri, web sitesi |
| 5. Şablonlar | Mesaj şablonları oluşturulup onaya gönderilir | Kategorisi belli, örnek değerli metinler |
| 6. Webhook ve test | Gelen mesajlar ve durumlar sunucunuza bağlanır | HTTPS adresi, kayıt tutan yazılım |
| 7. Canlıya geçiş | Ödeme yöntemi eklenir, ilk gerçek gönderim yapılır | Opt-in kayıtları, ödeme yöntemi |
İşletme doğrulaması (4. adım) gönderim limitinizi ve şablon hakkınızı artıran yollardan biridir; ayrıntısı aşağıda. Test numarasıyla geliştirmeye hemen başlayabilir, doğrulama belgelerini ise paralelde hazırlayıp canlıya geçişten önce tamamlayabilirsiniz. Şirket unvanı, vergi bilgileri ve web sitesindeki işletme adı birbiriyle tutarlı olmalı; bu tutarlılık belge kontrolünü kolaylaştırır.
Telefon numarası nasıl seçilir?
Numara size ait olmalı, ülke ve alan koduyla başlamalı (kısa numaralar desteklenmiyor) ve SMS ya da sesli aramayla doğrulama kodu alabilmelidir. Meta'nın işletme telefon numaraları belgesi bu koşulları sayıyor ve mobil numarayı öneriyor; sabit hat, ücretsiz arama hattı ve VoIP numaralarında SMS ile kod almanın sorunlu olabileceğini belirtiyor.
İki ayrıntı sık sorun çıkarır. Birincisi, WhatsApp'ta zaten kullanılan bir numarayı API'ye kaydedemezsiniz; önce o hesabı silmeniz gerekir. İkincisi, API'ye kaydedilen numara gündelik arama ve SMS için kullanılmaya devam edebilir ama WhatsApp uygulamasında kullanılamaz. Müşteri hizmetleri ekibinizin bugün kullandığı numarayı taşıyacaksanız eski sohbetlerin ve cihazların ne olacağını önceden planlayın. Mümkünse API için ayrı bir numara ayırın.
Çözüm ortağı (BSP) mı, doğrudan Cloud API mi?
Teknik ekibiniz varsa doğrudan Cloud API ile ilerleyebilirsiniz; yoksa bir çözüm ortağı kurulumu, şablon yönetimini ve ekran arayüzünü sizin için üstlenebilir. Karar çoğu zaman paradan çok kontrolle ilgilidir: numaranın, şablonların ve müşteri konuşmalarının kimde durduğu, ileride sağlayıcı değiştirmenin ne kadar zor olacağını belirler.
- Doğrudan Cloud API: Aracı yok, kontrol sizde. Webhook, güvenlik, şablon yönetimi ve hata izleme de sizin sorumluluğunuzda. Kendi CRM'inize ya da yapay zekâ asistanınıza bağlamak en kolay bu yolda.
- Çözüm ortağı üzerinden: Kurulum ve panel hazır gelir. Karşılığında çoğunlukla bir hizmet bedeli ödersiniz ve altyapınız ortağa bağlı olur.
- Sorulacak sorular: Numaranın ve şablonların sahibi kim? Ortaktan ayrılırsanız bunları taşıyabilir misiniz? Mesaj ücretini Meta fiyatından mı yansıtıyor, üstüne ne ekliyor?
Çözüm ortağıyla ilerlerseniz doğrulama işini de o üstlenebilir: Meta'nın mesaj limitleri belgesi, ortak tarafından onboard edilen işletmelerde doğrulamanın ortağa yaptırılabileceğini yazıyor.
Mesaj şablonları nasıl onaylanır?
Müşteriyle konuşmayı işletme başlatacaksa ya da müşteri yazalı 24 saat geçmişse şablon gerekir. Şablonlar otomatik sistemler ve manuel incelemeyle denetlenir; Meta'nın şablon inceleme belgesi karar için 24 saate kadar süre olabileceğini söylüyor. Onaylanan şablon gönderilebilir; reddedilen şablon düzenlenip yeniden gönderilebilir ya da itiraz edilebilir. Reddedilmeyi azaltmak için şunlara bakın:
- Parametreleri düzgün yazın: {{1}}, {{2}} gibi değişkenler sıralı olmalı, şablon bir parametreyle başlayıp bitmemeli, her değişken için örnek değer verilmeli.
- Hassas bilgi istemeyin: Kart numarası ya da kimlik numarası gibi tanımlayıcıları istemek ret sebebidir; son 4 hane gibi kısmi bilgi kabul ediliyor.
- Tehdit içermeyin: Müşteriyi hukuki işlemle korkutan ya da küçük düşüren ifadeler reddedilir.
- Tekrardan kaçının: Aynı gövde ve alt bilgiyle ikinci bir şablon, kopya sayılıp reddedilir.
- Kategoriyi doğru seçin: Her şablon pazarlama, hizmet (utility) ya da doğrulama (authentication) kategorisinde olmak zorunda. Kategori yalnızca onay sürecini değil, mesajın fiyatını da etkiler; kampanya içeriği taşıyan karışık şablonlar pazarlama sayılabilir.
Onaydan sonra da iş bitmiyor: müşteriler şikâyet eder ya da okunma oranı düşerse şablon duraklatılabilir veya devre dışı bırakılabilir. Kalite durumunu WhatsApp Manager'daki şablon panelinden düzenli izleyin ve düşük puanlı şablonu, müşteri şikâyetleri büyümeden önce sadeleştirin ya da yerine yenisini yazın.
Gönderim limitleri ve ücretlendirme nasıl işliyor?
Yeni bir işletme portföyünün, müşteri hizmeti penceresi dışında 24 saatte ulaşabileceği benzersiz alıcı sınırı 250'dir. Meta'ya göre bu sınır, işletmenizi doğrulatarak ya da yüksek kaliteli şablonlarla 30 gün içinde 2.000 kişiye ulaşarak 2.000'e çıkabiliyor; sonraki artışlar kalite ve kullanım koşulları sağlandıkça otomatik geliyor. Belge 10.000, 100.000 ve sınırsız kademelerini de sayıyor.
Ücretlendirmede Meta'nın fiyatlandırma sayfası şunu söylüyor: 1 Temmuz 2025'ten itibaren ücret mesaj başına alınıyor, yalnızca işletmeden kullanıcıya giden ve teslim edilen mesajlar için; kullanıcıdan işletmeye gelen mesajlar ücretsiz. Fiyat, mesajın kategorisine ve alıcı numarasının ülke koduna göre değişiyor. Aynı sayfaya göre 1 Ekim 2026 itibarıyla hizmet (service) mesajları da ücretlendiriliyor, ancak her iş numarasına ayda 1.000 ücretsiz hizmet mesajı tanımlanıyor. Tarifeler ve kurallar değişebildiği için Türkiye'deki alıcılar için güncel listeyi o sayfadan kontrol edin; burada tutar vermiyoruz.
Opt-in ve KVKK tarafında nelere dikkat edilmeli?
WhatsApp politikası, kişilere yalnızca telefon numarasını size vermişlerse ve sonraki mesajları almak istediklerini onaylamışlarsa (opt-in) yazmanıza izin veriyor. WhatsApp Business Mesajlaşma Politikası, onay yönteminin belirlenmesinin ve yürürlükteki yasalara uygun alınmasının işletmenin sorumluluğunda olduğunu, engelleme ve ayrılma taleplerine uyulması gerektiğini belirtiyor.
Türkiye'de bu, WhatsApp onayının yanında kişisel verilerin korunması ve ticari elektronik ileti kurallarının da değerlendirilmesini gerektirebilir. Telefon numarasının hangi amaçla ve ne kadar süre saklanacağı aydınlatma metninde yer almalıdır. Bu noktayı hukuk danışmanınızla netleştirin. Yapay zekâ asistanı bağlayacaksanız KVKK tarafı daha da önem kazanır; KVKK ve üretken yapay zekâ rehberimiz bu soruları ele alıyor.
Örnek: üç şubeli bir klinik
Örneğin 3 şubesi olan varsayımsal bir klinik, randevu hatırlatmasını WhatsApp'tan göndermek istiyor. Randevu sisteminde 1.800 hasta kayıtlı, ama yalnızca 1.100'ü randevu alırken mesaj almayı kabul etmiş. Klinik yalnızca bu 1.100 kişiyi gönderim listesine alıyor.
Yeni portföyün sınırı 250 olduğundan ilk gün 250 hastaya hatırlatma gönderebiliyor; kalan kişilere sonraki günlere bölerek yazıyor. Hatırlatma şablonunu hizmet kategorisinde, kampanya duyurusunu pazarlama kategorisinde onaya gönderiyor. İşletme doğrulamasını tamamlayınca sınır 2.000'e çıkıyor ve 1.100 kişilik liste tek günde gönderilebiliyor. Bir hasta "iptal" yazarsa bu mesaj ücretsiz geliyor ve 24 saatlik pencere içinde serbest metinle yanıtlanabiliyor. Bu rakamlar varsayımsaldır; kendi listenizdeki farkı gerçek verinizle hesaplayın.
En sık yapılan hatalar neler?
- Kullanımdaki bir numarayı kaydetmeye çalışmak: Numara önce WhatsApp'tan silinmeli; ekibin sohbet geçmişi ayrıca korunmalı.
- Onay almadan toplu gönderim: Engellenme ve şikâyetler kaliteyi düşürür, şablonlar duraklatılabilir.
- Kategoriyi yanlış seçmek: Kampanya içeren bir hatırlatma pazarlama sayılabilir ve fiyatı etkiler.
- Numaranın sahipliğini aracıya bırakmak: Ortaktan ayrılırken numara ve şablon taşınamayabilir; sözleşmede yazılı olmalı.
- Webhook'u kurmamak: Gelen mesajlar ve teslim durumları webhook'la gelir; izlenmezse yanıtsız müşteri kalır.
- Bütçeyi sabit rakamla kurmak: Kategori ve hizmet mesajı kuralları değişiyor; güncel fiyat listesine bakın.
Hatson Tech bu konuda nasıl yardımcı oluyor?
Hatson Tech, WhatsApp hattını CRM'inize, randevu ya da sipariş sisteminize ve gerektiğinde bir yapay zekâ asistanına bağlayan yazılımı geliştiriyor. Yapay zekâ ajanı geliştirme çözümümüzde asistanın hangi yanıtları kendi verebileceğini, hangi konuyu insana devredeceğini ve kayıtların nerede tutulacağını birlikte belirliyoruz; gerekirse model sizin kendi sunucularınızda çalışabiliyor. Sabit fiyat yayımlamıyoruz; ilk görüşme ve keşif ücretsiz.
İlgili okumalar: müşteri hizmetlerinde yapay zekâ ve yapay zekâ ajanları yazılarımız.