Toplu Mesaj Gönder (POST /api/v1/broadcasts)
Tek bir API isteği ile 1 ila 1.000 alıcıya kadar onaylı WhatsApp şablon mesajı gönderebilirsiniz. Kampanya kaydı anında oluşturulur; gönderimler arka planda sunucu tarafındaki kalıcı kuyrukta yürütülür ve isteğiniz yanıtlandıktan sonra da devam eder — sekme/kapı kapanması gönderimi durdurmaz. 1.000 alıcılık bir gönderim birkaç dakika sürebilir; ilerlemeyi ve alıcı bazlı sonuçları GET /api/v1/broadcasts/{id} ile takip edin. Geçici hatalar (hız sınırı, 5xx) otomatik olarak artan beklemeyle yeniden denenir. WhatsApp Business Platform kuralları gereği toplu gönderimler yalnızca Meta tarafından onaylanmış şablon mesajlarla yapılabilir.
gelsinsatislar_test_ önekli bir anahtarla başlattığınızda hiçbir mesaj gönderilmez ve aylık alıcı kotanız harcanmaz; örnek bir yanıt (sandbox: true) döner. Ayrıntılar: anahtar türleri ve kısıtlamalar.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
}Kampanya Durumunu Takip Et (GET)
Başlattığınız kampanyanın broadcast_id değerini kullanarak iletilen mesaj sayısını, beklemede olanları ve hata alanları anlık olarak sorgulayabilirsiniz.
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
}draft (taslak), sending (gönderiliyor) ve completed (tamamlandı).