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, Türkiye’deki başlıca SMS aggregator’larıyla aynı API arayüzü üzerinden çalışır. Sağlayıcı farkları, gönderim sırasında soyutlanmıştır — istek formatınız aynıdır, yalnızca provider alanı veya workspace bağlantı seçimi değişir.

​
Telefon Numarası Normalizasyonu

to alanı şu formatların hepsini kabul eder ve E.164’e (+90...) normalize eder:
GirişNormalize
+905551234567+905551234567
905551234567+905551234567
05551234567+905551234567
5551234567+905551234567
TR formatından farklı veya geçersiz numaralar 422 döner.

​
Segment Hesabı

SMS’in 160 (GSM-7) veya 70 (UCS-2/Türkçe karakterli) karaktere bölünmesidir. İletiniz her gönderim için segment sayısını hesaplar.
Karakter setiTek segmentÇoklu segment (per part)
GSM-7 (ASCII)160153
UCS-2 (Türkçe ç ğ ı İ ö ş ü)7067
body 1600 karakteri aştığında istek 400 döner.

​
İYS (İleti Yönetim Sistemi)

5809 sayılı kanun uyarınca ticari içerikli SMS göndermek için alıcının İYS’te kayıtlı izni olmalıdır. Detaylar İYS Uyumu sayfasındadır. İletiniz bu denetimi sağlayıcı katmanında yapar; izinsiz ticari gönderim sağlayıcı tarafında reddedilir ve mesaj failed döner. Bilgilendirme (transactional) mesajları (OTP, sipariş onayı, kargo bilgisi) İYS izni gerektirmez.

​
Sağlayıcı Notları

  • Kredensiyel: kullanıcı adı + şifre (+ opsiyonel app key).
  • REST v2 üzerinden tek/toplu gönderim; aynı çağrıda farklı alıcılara farklı body desteklenir.
  • Onaylı msgheader’lar NetGSM panelinde tanımlanır; iletiniz dashboard’undan Başlıkları Yenile ile çekilir.
  • Kredensiyel: API Key + API Hash (panel üzerinden üretilir, kullanıcı adı/şifreden ayrıdır).
  • Toplu gönderimde tek bir order_id döner; teslim sorguları bu üzerinden yapılır.
  • İYS izni varsayılan olarak BİREYSEL listesi üzerinden uygulanır.
  • Kredensiyel: kullanıcı adı + şifre.
  • Hız limiti dakikada 240 istek (sağlayıcı tarafı).
  • İYS izni olmayan numara için sağlayıcı NOT_ALLOWED_BY_IYS döner ve mesaj failed olur.
  • Kredensiyel: kullanıcı adı + şifre.
  • Tek başlıkta çoklu numara desteği vardır.
  • Kredensiyel: kullanıcı adı + şifre.
  • Onaylı başlık listesi sağlayıcı panelinden yönetilir.

​
DLR (Delivery Report)

status: "sent" ↦ delivered/failed/expired/rejected/unknown geçişi otomatik yapılır:
  • İlk durum sorgusu kısa süre içinde başlatılır.
  • Exponential backoff ile en fazla 9 deneme yapılır.
  • Sonunda kesin sonuç gelmezse status unknown olur.
  • DLR alındığında ilgili webhook (message.delivered veya message.failed) tetiklenir.
Mobil operatör tarafında “şu an kapalı / aktif değil” gibi durumlarda TTL 24–48 saat olabilir; bu süre içinde teslim olursa delivered event’i gelir, olmadan TTL’i biterse expired.

​
Maliyet Bilgisi

Gönderim sırasında segment başına maliyet hesaplanır. Sağlayıcının döndürdüğü birim ücreti (varsa) messages kayıtlarında saklanır ve dashboard’daki Raporlar sekmesinde gösterilir. Sağlayıcı maliyet bilgisi dönmüyorsa faturalandırma workspace planına göre yapılır.