SMS API Entegrasyonu

SMS API, kendi yazılımınızın Nirvana SMS altyapısı üzerinden otomatik mesaj göndermesini sağlar. Sipariş onayı, kargo bildirimi, randevu hatırlatması, tek kullanımlık doğrulama kodu ya da devamsızlık bildirimi gibi mesajlar, kimse panele girmeden ilgili olay gerçekleştiği anda gönderilir.

API ile neler yapılır?

• Tekil ya da toplu SMS gönderimi, ileri tarihli gönderim ve iptal
• Gönderim bazında iletim raporu (teslim edildi, iletilemedi ve nedeni)
• Kalan kredi sorgulama
• Hesabınızdaki onaylı başlıkları listeleme
• Kara liste yönetimi: numara ekleme, çıkarma ve listeleme

Teknik yapı

API, HTTP üzerinden POST ile gönderilen XML istekleriyle çalışır. Kimlik doğrulama için kullanıcı adınız ve panelden alacağınız API anahtarı kullanılır; bu anahtar web paneli şifrenizden farklıdır ve yalnızca sunucu tarafında saklanmalıdır. Aynı mesajın kısa süre içinde tekrar gönderilmesi altyapı tarafından engellenir, böylece yazılım hatalarından doğan mükerrer gönderimler önlenir.

Örnek istek

Aynı mesajı bir ya da daha fazla numaraya göndermek için XML gövdesi şu yapıdadır. Her numaraya farklı metin gönderen çoklu yapı da desteklenir.

<sms>
  <username>KULLANICI_ADINIZ</username>
  <password>API_ANAHTARINIZ</password>
  <header>BASLIGINIZ</header>
  <validity>2880</validity>
  <sendDateTime>2026.11.14.9.30.0</sendDateTime>
  <message>
    <gsm>
      <no>905xxxxxxxxx</no>
      <no>905xxxxxxxxx</no>
    </gsm>
    <msg><![CDATA[Veli toplantımız cuma 17.00'de.]]></msg>
  </message>
</sms>

• validity: Mesajın teslim için bekleyeceği süre (dakika, en fazla 2880 yani 48 saat).
• sendDateTime: İsteğe bağlı ileri tarihli gönderim; en fazla 1 yıl sonrası.
• Başarılı istekte 00 kodu ve gönderim kimliği döner. İletim raporunu ilk kez gönderimden 90-180 saniye sonra sorgulamanız önerilir.
• Aynı mesajın 2 dakika içinde tekrar gönderilmesi engellenir.

İstek adresi ve API anahtarınız panelde, API ayarları bölümünde yer alır.

Hazır kütüphaneler

• GitHub: nirvanasms/api-library
• NuGet: NirvanaSms.Api

Entegrasyon sırasında takıldığınız noktada teknik ekibimiz destek verir. Adım adım anlatım için SMS API entegrasyon rehberini okuyabilirsiniz.

Dokümanlar

Nasıl başlarsınız?

1. Panelden hesabınızı açın ve API bilgilerinizi alın.
2. Hazır kütüphaneyi projenize ekleyin ya da HTTP isteğini doğrudan gönderin.
3. Test SMS'iyle bağlantıyı doğrulayın, ardından canlı gönderime geçin.

Kimler için: Yazılım ekipleri, e-ticaret siteleri, CRM ve ERP kullanan firmalar, okul ve klinik yönetim yazılımları

Sık sorulanlar