Toplu Kampanya Uç Noktaları

Toplu Mesaj Gönder (`POST /api/v1/broadcasts`)

Tek bir API isteği ile 1 ila 1.000 kişiye kadar alıcı listenize onaylı WhatsApp şablon mesajı gönderebilirsiniz. Kampanya kaydı anında oluşturulur ve gönderimler arka planda asenkron yürütülür.

POSThttps://gelsinsatislar.com/api/v1/broadcastsScope: broadcasts:send

Bu Uç Nokta Ne Yapar? (Basitçe Anlatım)

Bu adres, tek istekle yüzlerce kişiye aynı mesajı göndermekiçindir. Bir duyuru yapacaksınız (ör. "Yaz indirimi başladı!") ve 1.000 müşteriniz var. Tek tek mesaj yazmak yerine, bu adrese alıcı listesini ve mesaj şablonunu verirsiniz. GelsinSatışlar gerisini halleder.

Önemli detay. Gönderimler arka planda (asenkron) yürür. Yani istek anında "kabul edildi" (202) cevabı alırsınız, mesajlar sırayla gönderilir. Bu, WhatsApp'ın kuralları gereği onaylı şablon mesajlar ile yapılır. Böylece müşterilerinize reklam veya marka mesajı gönderebilirsiniz (normal serbest mesaj yalnızca 24 saatlik aktif sohbet penceresinde gönderilebilir).

Kampanya Gönderim Şeması

curl -X POST "https://gelsinsatislar.com/api/v1/broadcasts" \
  -H "Authorization: Bearer gelsinsatislar_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Temmuz Kampanyası",
    "template_name": "yaz_indirimi",
    "template_language": "tr",
    "recipients": [
      { "to": "+905320000001", "params": ["Ahmet"] },
      { "to": "+905320000002", "params": ["Ayşe"] }
    ]
  }'

{
  "data": {
    "broadcast_id": "brd_994821a",
    "status": "sending",
    "total_recipients": 2,
    "accepted": 2,
    "rejected": 0
  },
  "error": null
}

GEThttps://gelsinsatislar.com/api/v1/broadcasts/{id}Scope: broadcasts:read

Kampanya Durumunu Takip Et (GET)

Başlattığınız kampanyanın broadcast_id değerini kullanarak kaç mesajın iletildiğini, kaçının beklemede olduğunu ve kaçının hata aldığını anlık öğrenebilirsiniz.

Basitçe Anlatım

Kampanya başlatınca bir fiş (broadcast_id) alırsınız. Bu fişle dilediğiniz an "dağıtım ne durumda?" diye sorabilirsiniz. Kargo takip numarasıyla paketinizi sorgulamak gibidir.

curl -X GET "https://gelsinsatislar.com/api/v1/broadcasts/brd_994821a" \
  -H "Authorization: Bearer gelsinsatislar_live_YOUR_API_KEY"

{
  "data": {
    "broadcast_id": "brd_994821a",
    "name": "Temmuz Kampanyası",
    "status": "completed",
    "total_recipients": 2,
    "delivered": 2,
    "failed": 0,
    "started_at": "2026-08-08T22:00:00Z",
    "finished_at": "2026-08-08T22:01:30Z"
  },
  "error": null
}

status değerleri draft (taslak), sending (gönderiliyor) ve completed (tamamlandı) olabilir.