API Entegrasyonu Hazırlık Rehberi

Bu rehber, Netgsm API’sini kullanmaya başlamadan önce yapılması gereken tüm hazırlık adımlarını kapsamaktadır.
Adımlar genel API hazırlıkları ve hizmet bazlı hazırlıklar olarak ikiye ayrılmıştır.

 

1. Genel API Hazırlıkları

API ile bağlantı kurmadan önce, aboneliğiniz üzerinde aşağıdaki adımları tamamlamanız gerekir:

1. API Alt Kullanıcısı Oluşturma
   Aboneliğiniz için özel bir API alt kullanıcısı oluşturun.
   Detaylı adımlar için:
   API Alt Kullanıcısı Nasıl Oluşturulur?
2. Hizmet Yetkilendirmesi
   API alt kullanıcınızı, kullanacağınız servislere uygun yetkiler ile tanımlayın.
3. API Erişimini Aktif Etme
   Aboneliğinizde API erişim iznini aktif hale getirin.
   Detaylı adımlar için:
   API Erişimi Aktifleştirme
4. IP Kısıtlama Tanımlaması (Önerilir)
   API erişimini yalnızca belirlediğiniz IP adreslerinden yapılacak isteklere izin verecek şekilde sınırlandırın.

 

2. Hizmet Bazlı Hazırlıklar

a) Bulk SMS & OTP SMS

• Gönderici adınız ile gönderim yapabilirsiniz. (BTK’nin 2025/DK-YED/399 sayılı Kurul Kararı kapsamında, 01.04.2026 tarihinden itibaren SMS gönderimlerinde Abone Numarası yerine Gönderici Adı kullanımı zorunlu hâle gelecektir.)
  Gönderici adı tanılama işlemi için https://bilgibankasi.netgsm.com.tr/sms/toplu-sms/gonderici-adi-talebi#gonderici-ad-talebi linkini inceleyebilirsiniz.
• İYS kontrollü gönderim yapılacaksa, İYS entegrasyon adımlarını tamamlayın.
• Kullanılacak hizmet paketinin (SMS, OTP SMS) aboneliğinizde tanımlı olduğundan emin olun.
• SMS hizmeti yetkisi olan yeni bir API alt kullanıcısı oluşturun veya mevcut API alt kullanıcınıza SMS yetkisi verin.
  Detaylı adımlar için:
  API Alt Kullanıcısı Nasıl Oluşturulur?
• Entegrasyon dokümanları, Postman koleksiyonları ve SDK’lara şu adresten ulaşabilirsiniz:
  Netgsm Dokümanlar

 

b) İYS Entegrasyonu

• İYS panelinizden Netgsm İletişim ve Bilgi Teknolojileri A.Ş.’yi iş ortağı olarak tanımlayın.
• İYS hesabınızın aktif olması için İYS kredisi yükleyin.
• İYS panelinizden Marka Kodunuzu öğrenin.
• Netgsm web portalından NetİYS modülünü aktif edin.
• Dijital servisler yetkisi olan yeni bir API alt kullanıcısı oluşturun veya mevcut API alt kullanıcınıza dijital servis yetkisi verin.
  API Alt Kullanıcısı Nasıl Oluşturulur?
• Kullanılacak hizmet paketinin (NetİYS) aboneliğinizde tanımlı olduğundan emin olun.
• Entegrasyon dokümanları, Postman koleksiyonları ve SDK’lara şu adresten ulaşabilirsiniz:
  Netgsm Dokümanlar

 

c) Sesli Mesaj

• Sesli Mesaj hizmetinizin aktif olduğunu web portaldan kontrol edin.
• İYS kontrollü gönderim yapılacaksa, İYS entegrasyon adımlarını tamamlayın.
• Kullanılacak hizmet paketinin (Sesli Mesaj) aboneliğinizde tanımlı olduğundan emin olun.
• Sesli Mesaj yetkisi olan yeni bir API alt kullanıcısı oluşturun veya mevcut API alt kullanıcınıza Sesli Mesaj yetkisi verin.
  API Alt Kullanıcısı Nasıl Oluşturulur?
• Entegrasyon dokümanları, Postman koleksiyonları ve SDK’lara şu adresten ulaşabilirsiniz:
  Netgsm Dokümanlar

 

d) Ses – Netsantral Hizmeti

• Ses hizmetinizin aktif olduğunu web portaldan kontrol edin.
• İYS kontrollü arama yapılacaksa, İYS entegrasyon adımlarını tamamlayın.
• Kullanılacak hizmet paketinin (Ses-Netsantral) aboneliğinizde tanımlı olduğundan emin olun.
• Ses Hizmeti ve Netsantral yetkisi olan yeni bir API alt kullanıcısı oluşturun veya mevcut API alt kullanıcınıza bu yetkileri verin.
  API Alt Kullanıcısı Nasıl Oluşturulur?
• Entegrasyon dokümanları, Postman koleksiyonları ve SDK’lara şu adresten ulaşabilirsiniz:
  Netsantral API Dokümanları

 

3. API Erişimi Nasıl Aktif Edilir?

1. portal.netgsm.com.tr adresinden ana kullanıcı bilgilerinizle giriş yapın.
2. Abonelik İşlemleri > API İşlemleri > API Erişimini Aktifleştir menüsüne gidin.
3. Ekranda istenen gerekli alanları doldurun.
4. Kaydederek API erişimini aktif edin.