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

> WhatsApp Cloud API kurulumunu adım adım yapın: Meta uygulaması, kalıcı anahtar, webhook ve Ekim 2026 sonrası mesaj ücretleri tek rehberde burada.

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.

Yayın tarihi: 2026-11-09 · Son güncelleme: 2026-11-09

## 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](https://developers.facebook.com/documentation/business-messaging/whatsapp/access-tokens) 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?

| 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](https://developers.facebook.com/documentation/business-messaging/whatsapp/pricing) 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](/blog/whatsapp-ai-chatbot-cost-2026) 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](/docs/channels/whatsapp), özeti [WhatsApp kanalı](/tr/channels/whatsapp) sayfasında. ikas kullanıyorsanız [ikas canlı destek](/tr/blog/ikas-canli-destek-yapay-zeka) 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](/tr/pricing) 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.

---

Bu sayfayı web'de okuyun: [WhatsApp Cloud API kurulumu: adım adım rehber](/tr/blog/whatsapp-cloud-api-kurulumu)
