Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.iletiniz.com/llms.txt

Use this file to discover all available pages before exploring further.

İletiniz, WhatsApp Business Cloud API (Meta) üzerinden onaylı şablon mesajları gönderir. WhatsApp’ın opt-in zorunluluğu ve şablon onayı süreci nedeniyle gönderim akışı SMS’ten farklıdır.

​
Önkoşullar

WhatsApp gönderimi için aşağıdaki Meta tarafı kurulumlar tamamlanmış olmalıdır:
  1. Bir Meta Business Account ve onun altında bir WhatsApp Business Account (WABA).
  2. WABA’ya bağlı, doğrulanmış bir telefon numarası ve phone_number_id.
  3. Bir System User access token (whatsapp_business_messaging ve whatsapp_business_management izinleriyle).
  4. Şablonlarınızın Meta tarafında onaylanmış olması — WhatsApp serbest metin gönderimine yalnızca son 24 saat içinde kullanıcı tarafından bot ile etkileşim olduysa izin verir; dışında zorunlu olarak onaylı şablon kullanılır.

​
Bağlantı Kurulumu

  1. Kontrol Paneli → Entegrasyonlar → Yeni Bağlantı → WhatsApp.
  2. Phone Number ID (örn. 123456789012345) ve Access Token alanlarını doldur.
  3. Doğrula ile bağlantı testi yap (Meta phone_number endpoint’ine probe atılır).

​
Alıcı Formatı

to alanı E.164 formatında telefon numarası olmalıdır. WhatsApp tarafı + öneki olmadan kabul eder; iletiniz her iki formatı da normalize eder. 
{
  "to": "+905551234567",
  "body": "Onay kodunuz: 482931",
  "provider": "whatsapp"
}

​
Şablon Modu

WhatsApp serbest metin gönderimi yalnızca dar bir pencerede çalıştığı için şablonla göndermek önerilir: 
{
  "to": "+905551234567",
  "template": "siparis_kargoda",
  "variables": {
    "isim": "Mehmet",
    "kargo_takip": "TR1234567890"
  },
  "provider": "whatsapp"
}
İletiniz tarafında tanımladığınız şablonun key değeri, WhatsApp tarafındaki şablonun adıyla birebir aynı olmalıdır. WhatsApp şablonu Meta Business Manager’da oluşturulup onaylandıktan sonra aynı isimle iletiniz dashboard’una eklenir.

​
Farklılıklar

ÖzellikSMSTelegramWhatsApp
senderZorunlu (msgheader)Yok sayılırYok sayılır (phone_number_id bağlantıda)
Şablon onayıSağlayıcı bazındaYokMeta tarafında zorunlu (24 saat dışı gönderim için)
Segment hesabı160/70 karakterSabit 1Sabit 1
MaliyetPer segmentYokPer conversation (Meta fiyatlandırması)
DLRPollAnlık (Send-time)Anlık (Meta webhook → iletiniz)
Maks. body16004096 → 1600’e kırpılır1024

​
Hata Yanıtları

WhatsApp’a özgü tipik hatalar:
error.codeAnlamı
whatsapp_131026Alıcının WhatsApp hesabı yok veya inaktif
whatsapp_13104724-saatlik etkileşim penceresi dışı serbest metin gönderildi (şablon kullanın)
whatsapp_132012Şablon Meta tarafında onaysız veya silinmiş
whatsapp_token_expiredSystem user access token süresi dolmuş — yenileyin

​
İlgili Sayfalar