WhatsApp Business API Nasıl Alınır? Adım Adım
İşletme

WhatsApp Business API Nasıl Alınır? Adım Adım

Ortada bir başvuru formu yok: bir Meta işletme portföyü, bir telefon numarası ve onaylı şablonlar kuruyorsunuz. Sıra, kontroller ve tuzaklar burada.

Kısa cevap

WhatsApp Business API'yi almak için bir Meta işletme portföyü açar, WhatsApp kullanım senaryosuyla bir uygulama oluşturur, size ait bir telefon numarası kaydeder ve mesaj şablonlarınızı onaylatırsınız; bunu Cloud API ile kendiniz ya da bir çözüm ortağı üzerinden yapabilirsiniz. Yeni hesap müşteri hizmeti penceresi dışında günde 250 alıcıya yazabilir ve her alıcıdan kayıtlı onay (opt-in) almanız gerekir. Meta teslim edilen mesaj başına ücret alır; güncel fiyat listesini kontrol edin.

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ımNe yapılır?Hazır olması gereken
1. Meta hesabıGeliştirici kaydı ve işletme portföyü açılırFacebook hesabı, şirket adı, yetkili e-postası
2. UygulamaMeta uygulaması WhatsApp kullanım senaryosuyla oluşturulurUygulama adı, portföy seçimi
3. Telefon numarasıNumara eklenir, doğrulanır, API'ye kaydedilirSize ait, SMS ya da arama alabilen numara
4. İşletme doğrulamasıŞirket Meta'ya doğrulatılırResmî şirket belgeleri, web sitesi
5. ŞablonlarMesaj şablonları oluşturulup onaya gönderilirKategorisi belli, örnek değerli metinler
6. Webhook ve testGelen mesajlar ve durumlar sunucunuza bağlanırHTTPS adresi, kayıt tutan yazılım
7. Canlıya geçişÖdeme yöntemi eklenir, ilk gerçek gönderim yapılırOpt-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:

  1. 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.
  2. 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.
  3. Tehdit içermeyin: Müşteriyi hukuki işlemle korkutan ya da küçük düşüren ifadeler reddedilir.
  4. Tekrardan kaçının: Aynı gövde ve alt bilgiyle ikinci bir şablon, kopya sayılıp reddedilir.
  5. 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.

Önemli çıkarımlar

  • API almak bir başvuru değil kurulumdur: portföy, uygulama, telefon numarası, şablonlar, webhook, canlıya geçiş.
  • Size ait ve WhatsApp'ta kullanılmayan bir numara seçin; eski sohbetlerine ne olacağını önceden planlayın.
  • Doğrudan Cloud API ile çözüm ortağı arasında, numaranın ve şablonların kimde durduğunu sorarak karar verin.
  • Şablonlar yaklaşık 24 saat içinde incelenir; reddin çoğunu kategori, parametre ve hassas veri talebi belirler.
  • Yeni portföy günde 250 alıcıyla başlar; bütçeyi sabit rakamla değil, Meta'nın güncel fiyat listesiyle kurun.

Sıkça sorulan sorular

WhatsApp Business API nasıl alınır?

Bir Meta geliştirici hesabı ve işletme portföyü açın, WhatsApp kullanım senaryosuyla bir uygulama oluşturup size ait bir telefon numarası bağlayın. Gerçek mesaj göndermeden önce şablonlarınızı incelemeye gönderin ve webhook kurun. Bunu kendiniz yapmak istemiyorsanız kurulumu bir çözüm ortağı yürütebilir.

WhatsApp Business API ücretli mi?

Hesabı oluşturmak için Meta ücret almaz, ama gönderim ücretlidir. Meta, işletmeden kullanıcıya giden ve teslim edilen mesajları kategoriye ve alıcı ülkesine göre ücretlendirir; kullanıcıdan size gelen mesajlar ücretsizdir. Aylık belirli sayıda hizmet mesajı ücretsizdir ve çözüm ortağı kendi bedelini ekleyebilir.

Mevcut WhatsApp numaramı API için kullanabilir miyim?

WhatsApp'ta aktifken kullanamazsınız. Kullanımdaki bir numara önce WhatsApp'tan silinmeli, API'ye kaydedildikten sonra da WhatsApp uygulamasında kullanılamaz. Çoğu ekip bunun için ayrı bir numara ayırır.

Şablon onayı ne kadar sürer?

Meta kararın 24 saate kadar sürebileceğini söylüyor. Ret genellikle parametre biçimi, hassas kimlik bilgisi talebi, tekrar eden metin ya da yanlış kategoriden gelir; reddedilen şablon düzenlenip yeniden gönderilebilir ya da itiraz edilebilir.

Çözüm ortağına (BSP) mutlaka ihtiyacım var mı?

Hayır. Yazılımcı ekibi olan bir şirket Cloud API'yi doğrudan kullanabilir. Hazır panel ve yönetilen kurulum istiyorsanız ortak işe yarar; yine de numaranın ve şablonların kimde durduğunu ve sonradan taşınıp taşınamayacağını sorun.

WhatsApp Business API ile günde kaç kişiye mesaj atılabilir?

Yeni bir işletme portföyü, müşteri hizmeti penceresi dışında günde 250 benzersiz alıcıya ulaşabilir. İşletme doğrulaması ya da yüksek kaliteli gönderim geçmişiyle sınır 2.000'e çıkar, sonraki artışlar koşullar sağlandıkça otomatik gelir.

Tüm yazılar