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.

POST /v1/messages/bulk
Tek istekte en fazla 200 alıcıya aynı şablonla, alıcı-başına farklı değişken setleriyle gönderim yapar.
Bu uç noktanın şablon modu ile düz metin modu ayrıdır. Üst seviyede template verirseniz her items[] yalnızca to (+ opsiyonel variables) içermelidir — items[].body kullanılamaz. Karışık mod desteklenmez.

​
İstek Gövdesi

AlanTipZorunluAçıklama
templatestringEvetTüm öğeler için ortak şablon key’i.
providerstringHayırSağlayıcı kodu. Belirtilmezse workspace varsayılanı.
senderstring (≤ 32)SMS içinTüm öğeler için ortak msgheader.
itemsarray (1–200)EvetAlıcı listesi.
items[].tostring (1–64)EvetAlıcı.
items[].variablesobjectŞartlıBu alıcıya özgü değişkenler. Şablon değişkensizse boş bırakılabilir.
items[].body kullanılmaz — şablon modunda body, üst seviyedeki şablonun render edilmiş hali olur.

​
Örnek

curl -X POST https://api.iletiniz.com/v1/messages/bulk \
  -H "Authorization: Bearer iltz_live_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "template": "siparis_kargoda",
    "sender": "FIRMA",
    "items": [
      { "to": "+905551112233", "variables": { "isim": "Ali",  "kargo_takip": "TR1001" } },
      { "to": "+905552223344", "variables": { "isim": "Veli", "kargo_takip": "TR1002" } },
      { "to": "+905553334455", "variables": { "isim": "Ayşe", "kargo_takip": "TR1003" } }
    ]
  }'

​
Yanıt

200 OK 
{
  "total": 3,
  "sent": 3,
  "failed": 0,
  "provider": "netgsm",
  "template": "siparis_kargoda",
  "template_key": "siparis_kargoda",
  "created_at": "2026-05-13T20:14:00.000Z",
  "results": [
    { "to": "+905551112233", "status": "sent", "job_id": "k7m4n2p9q8r5s1t6" },
    { "to": "+905552223344", "status": "sent", "job_id": "a3b6c9d2e5f8g1h4" },
    { "to": "+905553334455", "status": "sent", "job_id": "x9y2z5a8b1c4d7e0" }
  ]
}

​
Kısmi Başarı

Bir alıcı için değişken eksik olursa (veya İYS engeli, geçersiz numara) o satır failed döner; diğerleri etkilenmez. 
{
  "total": 3,
  "sent": 2,
  "failed": 1,
  "provider": "netgsm",
  "template": "siparis_kargoda",
  "template_key": "siparis_kargoda",
  "created_at": "2026-05-13T20:14:00.000Z",
  "results": [
    { "to": "+905551112233", "status": "sent", "job_id": "k7m4n2p9q8r5s1t6" },
    {
      "to": "+905552223344",
      "status": "failed",
      "error": {
        "code": "missing_template_variables",
        "message": "Şablon değişkenleri eksik: kargo_takip"
      }
    },
    { "to": "+905553334455", "status": "sent", "job_id": "x9y2z5a8b1c4d7e0" }
  ]
}

​
Hata Yanıtları (Üst Seviye)

KoderrorSebep
400doğrulama hatasıitems boş, > 200 öğe, items[].body şablon modunda kullanıldı, vb.
400missing_template_variablesÜst seviye şablon doğrulamasında değişkensiz öğe yok. Per-item hatalar results içinde döner.
401—API key yok / yanlış.
404template_not_foundBelirtilen template workspace’te yok.
429—Rate limit aşıldı.

​
Performans

Şablon resolve ve render adımları isteğin başında bir kez yapılır, sonra her item için yalnızca değişken substitüsyonu çalışır. Bu sayede 200 alıcılı bir şablon gönderimi, 200 ayrı /v1/messages çağrısından belirgin şekilde hızlıdır.

​
İlgili Sayfalar