Knowledge Base

POST /ProactiveMessage/SendWhatsappCampaign

Bu endpoint, sistemlerin belirli kullanıcı gruplarına şablon tabanlı, kişiselleştirilmiş ve zamanında WhatsApp mesajları göndermesini sağlamak amacıyla tasarlanmıştır. Proaktif mesaj gönderimi, yalnızca kullanıcı aksiyonlarına dayalı olmayan, sistem tetiklemeli iletişim senaryolarının önünü açar. Bu endpoint'i kullanmak için bir WhatsApp Business API hesabınız olması ve gönderilecek template'lerin Meta tarafından onaylatılması gerekmektedir. 

Request Format

Request Body

Parametre Açıklamaları

• templateName: WhatsApp Business tarafından onaylanmış mesaj şablonunun adı.
  

• imageUrl: Mesaja eklenecek görselin URL'si (opsiyonel, şablonla uyumlu olmalı).
  

• buttonParamater: Şablon içindeki butonun parametresi (ör. tıklanacak URL, etiket vs.).
  

• bodyParameters: Şablon gövdesinde kullanılan değişken değerler.
  

• userDatas: Mesaj gönderilecek kullanıcı bilgileri. Birden fazla kullanıcı girilebilir.
  

userDatas altındaki alanlar:

• email: Kullanıcının e-posta adresi (opsiyonel).
  

• phone: Kullanıcının telefon numarası (zorunlu).
  

• name: Kullanıcının adı (kişiselleştirme için gerekli) (opsiyonel).
  

• surname: Kullanıcının soyadı (opsiyonel).
  

• gender: Kullanıcının cinsiyeti (opsiyonel).
  

• companyPhone: Şirket telefon numarası (opsiyonel). Eğer aynı Jetlink hesabına bağlı birden fazla WhatsApp hesabınız varsa bu alanı doldurmalısınız.
  

✅ Başarılı Yanıt

❌ Hata Yanıtı Örneği

 Notlar

• Gönderilen templateName, WhatsApp'ta onaylı bir şablon olmalıdır. Aksi takdirde mesaj gönderimi başarısız olur.
  

• bodyParameters sıralaması, şablonda kullanılan değişken sırasıyla eşleşmelidir (örneğin {{1}}, {{2}}, ...).
  

• phone alanı uluslararası formatta olmalıdır (örn: +90 ile başlamalıdır).
  

• Çoklu kullanıcıya aynı mesaj gönderimi için userDatas dizisine birden fazla kullanıcı eklenebilir.
  

  
  
  Kullanım Senaryoları:
  

  
  

• Planlı kampanya bildirimleri
  

• Sepet hatırlatma mesajları
  

• Teslimat güncellemeleri ve işlem bildirimleri
  

• Üyelik yenileme veya ödeme hatırlatma süreçleri
  

• Şarta bağlı bilgilendirme sistemleri (ör. bakiye limiti, kullanım süresi uyarıları)
  

Faydalar:

• API ile Otomasyon: Arka plan servisleri ve cron job’lar ile entegre çalışarak tam otomasyon sağlar.
  

• Kişiselleştirme Desteği: bodyParameters üzerinden mesaj içerikleri dinamik olarak kullanıcıya özel düzenlenebilir.
  

• Toplu Gönderim Yeteneği: userDatas dizisi sayesinde tek çağrıda birden fazla kullanıcıya mesaj iletilebilir.
  

• Şablon Uyumlu Altyapı: WhatsApp Business API'nin şablon kurallarıyla tam uyumludur; template yapısına göre değişken alanlara veri geçişi yapılabilir.
  

• Düşük Gecikme Süresi: Reaktif değil, tetikleyici olmayan senaryolarda da hızlı yanıt süresi sunar.
  

Bu yapı, hem pazarlama ekiplerinin planlı kampanyalarını teknik süreçlerle entegre etmesini, hem de transactional mesajların kullanıcıya doğrudan ulaşmasını sağlar.

POST /ProactiveMessage/StatusWhatsappCampaign

Bu API, WhatsApp mesaj şablonlarının durumunu sorgulamak amacıyla kullanılır. messageId parametresi ile, belirli bir template mesajının güncel durumu hakkında bilgi alabilirsiniz. 

HTTP Yöntemi

• POST: /ProactiveMessage/StatusWhatsappCampaign
  

Parametreler

Bu API çağrısında herhangi bir URL parametresi gerekmemektedir. İstek gövdesinde sadece messageId parametresi gereklidir.

Request Body

Parametre:

• messageId (string): SendWhatsappCampaign isteğinin response'unda verilen msgId alanındaki mesaj id si buraya girilecek
  

Örnek Request Body:

Başarılı Example Response:

• HTTP Durum Kodu: 200 OK
  

• Medya Türü: text/plain
  
  
  
  
  

  
  

  
  
  sent: Sistemin mesajı başarılı şekilde gönderdiğini ifade eder.
  delivered: Kullanıcıya mesajın başarılı şekilde ulaştığını ifade eder.
  read: Kullanıcının mesajı açtığını ve okuduğunu ifade eder.
  

  
  

Örnek Request:

Bu endpoint, WhatsApp şablonlarıyla çalışırken doğru durumları almak ve şablon kalitesini izlemek için geliştiriciler tarafından kullanılabilir.