WhatsApp Cloud API kurulumu: adım adım rehber

WhatsApp Cloud API'yi kurmak için Meta Business portföyü ve WhatsApp ürünü eklenmiş bir geliştirici uygulaması gerekir; canlı kullanımda 24 saat içinde dolan geçici anahtar yerine System User'dan alınan kalıcı anahtar kullanılır. 1 Ekim 2026'dan beri Meta, numara başına ayda 1.000 ücretsiz servis mesajından sonrasını mesaj başına faturalar.

Başlamadan önce ne gerekir?

  • Meta Business portföyü: business.facebook.com üzerinde.
  • Meta geliştirici uygulaması: developers.facebook.com/apps üzerinde, WhatsApp ürünü eklenmiş.
  • Telefon numarası: WhatsApp → API Setup altında. Başlangıç için Meta'nın ücretsiz test numarası yeterli.
  • Ödeme yöntemi: canlı kullanımda, ücretsiz kota bittikten sonra mesajların teslim edilmesi için.

Meta uygulaması nasıl açılır?

  1. Uygulamayı oluşturun

    developers.facebook.com/apps adresinde yeni bir uygulama oluşturup Business portföyünüze bağlayın.

  2. WhatsApp ürününü ekleyin

    Uygulamanın ürünler listesinden WhatsApp'ı ekleyin. Sol menüde WhatsApp → API Setup ekranı açılır.

  3. Numaranızı bağlayın

    Test için Meta'nın verdiği numarayı kullanabilir, canlı kullanım için kendi numaranızı ekleyebilirsiniz.

Phone Number ID nerede?

WhatsApp → API Setup ekranında, numaranızın yanındaki Phone Number ID değerini kopyalayın. Telefon numarasının kendisi değil, bu ID gerekir. Aynı ekranda WhatsApp Business Account ID de yazar.

Kalıcı anahtar nasıl alınır?

API Setup ekranındaki geçici anahtar yalnızca deneme içindir. Meta'nın belgesi kısa ömürlü olduğunu ve birkaç saatte bir yenilemeniz gerekebileceğini söylüyor. Canlı kullanım için bir System User anahtarı alın:

  1. System User oluşturun

    Business Ayarları'nda System Users bölümünü açın, Add ile Admin veya Employee rolünde bir kullanıcı ekleyin.

  2. Uygulamayı atayın

    Kullanıcının adına tıklayıp Assign assets ile uygulamanızı seçin ve Manage app yetkisini verin. Employee kullanıcıysa WhatsApp hesabına da erişim verin.

  3. Anahtarı üretin

    Generate token'a basın, uygulamanızı ve süre tercihini seçin; business_management, whatsapp_business_management ve whatsapp_business_messaging izinlerini işaretleyip anahtarı kopyalayın.

Webhook ve messages aboneliği nasıl yapılır?

Webhook, gelen mesajları sisteminize iletir. Pommy'de Entegrasyonlar sayfasındaki WhatsApp penceresi size bir Webhook URL ve Verify Token verir.

  1. Ayarları açın

    Uygulamanızda WhatsApp → Configuration'a gidip Webhook bölümünde Edit'e tıklayın.

  2. Adresi ve jetonu girin

    Callback URL alanına Webhook URL'yi, Verify token alanına jetonu yapıştırıp kaydedin.

  3. messages alanına abone olun

    Manage altında messages alanını açın. Abonelik olmadan webhook doğrulanır ama mesajlar gelmez.

Mesajlar bir gün sonra durduysa ne yapmalı?

En sık görülen hata budur ve sebebi neredeyse her zaman geçici anahtardır. Kalıcı System User anahtarını üretin ve bağlantı ayarlarından güncelleyin; diğer değerleri tekrar girmeniz gerekmez. Sonra bir test mesajı gönderin.

En sık kurulum hataları neler?

BelirtiOlası sebepÇözüm
Webhook doğrulanmıyorVerify Token eksik veya yanlış yapıştırıldıDeğeri Pommy'den baştan kopyalayın, kayıttan önce boşluk bırakmayın
Mesajlar konsola düşmüyormessages alanına abone olunmadıWebhook fields altında Manage ile açın
Cevaplar müşteriye gitmiyorPhone Number ID yerine telefon numarası yazıldıAPI Setup ekranındaki ID'yi kopyalayın
Bir gün sonra her şey duruyorGeçici anahtarın süresi dolduKalıcı System User anahtarına geçin
Test mesajı ulaşmıyorMeta'nın test numarası yalnızca eklediğiniz alıcılara yazarAlıcınızı API Setup ekranından ekleyin

1 Ekim 2026 sonrası ücretler nasıl?

Meta 1 Ekim 2026'dan beri servis mesajlarını teslim edilen mesaj başına ücretlendiriyor. Her iş telefon numarasının ayda 1.000 teslim edilen servis mesajı ücretsiz; kota her ay yenilenir, kullanılmayan aktarılmaz.

Meta'ya ödeyeceğiniz (aylık)
Maliyet = max(0, teslim edilen servis mesajı - 1.000) x pazar tarifesi

Meta'nın 1 Ekim 2026'dan geçerli USD tarifesinde Türkiye servis mesajı 0,0009 dolar. Örnek hesap: ayda 5.000 teslim edilen mesajda (5.000 - 1.000) x 0,0009 = 3,60 dolar. Tarifeyi 9 Kasım 2026'da okuduk, bütçe yapmadan önce güncelini kontrol edin. Maliyet hesabının tamamı İngilizce WhatsApp AI chatbot cost yazısında.

Şablon mesajlar nedir, ne zaman gerekir?

Müşteri son 24 saat içinde yazmadıysa ona serbest metin gönderemezsiniz; Meta'nın onayladığı şablonları kullanmanız gerekir. Sipariş onayı gibi kendiliğinden giden mesajlar ve kampanyalar da şablondur. Bu mesajların ayrı tarifesi vardır ve ayda 1.000 ücretsiz servis mesajı onları kapsamaz. Meta'nın USD tarifesine göre Türkiye'de pazarlama mesajı 0,0109 dolar, yardımcı (utility) mesaj 0,0009 dolar.

Ödeme yöntemi olmazsa ne olur?

Kayıtlı ödeme yöntemi yoksa Meta ücretsiz kota içindeki servis mesajlarını teslim eder, kota bittikten sonrasını teslim etmez. Müşteriniz cevap alamaz. Ödeme yöntemini Meta'nın Billing Hub'ına baştan ekleyin.

24 saatlik pencere nedir?

Müşteri size yazdığında müşteri hizmetleri penceresi açılır, her yeni mesajla yenilenir ve 24 saat sürer. Serbest metinli cevaplar yalnızca bu pencerede gönderilebilir. Pencere dışında yalnız şablon mesaj gönderilebilir.

Yapay zekâ asistanını nasıl bağlarım?

Pommy'de Entegrasyonlar → WhatsApp Business penceresini açın, Phone Number ID, Access Token ve isteğe bağlı Business Account ID değerlerini girin, webhook adımını tamamlayın. Pencere test mesajı göndermeyi önerir; sonrasında WhatsApp mesajları temsilci konsoluna düşer. Adımlar WhatsApp kurulum kılavuzunda, özeti WhatsApp kanalı sayfasında. ikas kullanıyorsanız ikas canlı destek rehberiyle birlikte okuyun.

İpucu: Meta'nın ücretleri Pommy planınızdan ayrıdır, çünkü kendi uygulamanızla bağlanırsınız. Pommy'nin planları fiyatlar sayfasında.

WhatsApp Cloud API hakkında başka neler bilinmeli?

İki numara kullanırsam ücretsiz kota iki katına çıkar mı?
Evet, Meta'ya göre her iş telefon numarasının kendi ücretsiz kotası vardır.
Meta'nın test numarası yeterli mi?
Kurulumu denemek için evet. Gerçek müşteriler için kendi numaranız ve kalıcı anahtar gerekir.