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?
- Uygulamayı oluşturun
developers.facebook.com/apps adresinde yeni bir uygulama oluşturup Business portföyünüze bağlayın.
- WhatsApp ürününü ekleyin
Uygulamanın ürünler listesinden WhatsApp'ı ekleyin. Sol menüde WhatsApp → API Setup ekranı açılır.
- 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:
- 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.
- 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.
- Anahtarı üretin
Generate token'a basın, uygulamanızı ve süre tercihini seçin;
business_management,whatsapp_business_managementvewhatsapp_business_messagingizinlerini 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.
- Ayarları açın
Uygulamanızda WhatsApp → Configuration'a gidip Webhook bölümünde Edit'e tıklayın.
- Adresi ve jetonu girin
Callback URL alanına Webhook URL'yi, Verify token alanına jetonu yapıştırıp kaydedin.
- 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?
| Belirti | Olası sebep | Çözüm |
|---|---|---|
| Webhook doğrulanmıyor | Verify 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üyor | messages alanına abone olunmadı | Webhook fields altında Manage ile açın |
| Cevaplar müşteriye gitmiyor | Phone Number ID yerine telefon numarası yazıldı | API Setup ekranındaki ID'yi kopyalayın |
| Bir gün sonra her şey duruyor | Geçici anahtarın süresi doldu | Kalıcı System User anahtarına geçin |
| Test mesajı ulaşmıyor | Meta'nın test numarası yalnızca eklediğiniz alıcılara yazar | Alı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.
Maliyet = max(0, teslim edilen servis mesajı - 1.000) x pazar tarifesiMeta'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.