Bu rehberde: Netgsm hesabınızı kullanıcı kodu, API şifresi ve onaylı mesaj başlığınızla bağlarsınız. Workflow'lardan tekil SMS, Kampanyalar sayfasından ve Toplu mesaj kutusundan SMS kampanyası gönderirsiniz; ticari mesajlar Netgsm'in İYS filtresinden geçer, teslim raporları mesaj durumlarını günceller.
⏱ 10 dakika
Kimlik kartı
| Alan | Değer |
|---|---|
| Sağlayıcı anahtarı | NETGSM |
| Kategori | Mesajlaşma (SMS) |
| Kimlik doğrulama | Kullanıcı kodu + API şifresi (HTTP Basic, REST v2) |
| Kapsam | Organizasyon |
| Webhook | Hayır (teslim raporları 5 dakikada bir sorgulanır) |
| Yetenekler | Mesaj gönderme, toplu mesaj |
| Kullanan kutular | Mesaj gönder (kanal SMS veya SMS – Netgsm), Toplu mesaj |
Ne işe yarar?
- Tekil SMS: sipariş, randevu, ödeme hatırlatması gibi bildirimleri Mesaj gönder kutusuyla gönderirsiniz. Kanal SMS seçiliyse bağlı SMS hesabınız (Twilio yoksa Netgsm) kullanılır; SMS – Netgsm seçerseniz her zaman Netgsm kullanılır.
- SMS kampanyası: Kampanyalar sayfası ve Toplu mesaj kutusu, telefon numarası olan ve çıkış yapmamış adaylara dakika başı hız sınırıyla gönderir.
- Teslim raporları: gönderilen her SMS'in Netgsm iş numarası (
jobid) saklanır; OrqLabs raporları 5 dakikada bir sorgular, mesaj ve kampanya durumu iletildi veya başarısız (ör. "İYS reddi", "numara kara listede") olur. - Numaralar otomatik olarak
905XXXXXXXXXbiçimine çevrilir (0555 123 45 67,+90 555…,5551234567hepsi kabul edilir).
Not: Netgsm bu entegrasyonda tek yönlüdür; alfanümerik başlıkla gönderilen SMS'lere yanıt gelmez. İki yönlü SMS sohbeti için Verimor veya Twilio kullanın.
Ön koşullar
- Bir Netgsm aboneliği ve SMS paketi.
- Onaylı mesaj başlığı (gönderici adı): Netgsm panelinde başlık başvurusu yapıp onaylatmanız gerekir; onaysız başlıkla gönderim yapılamaz (hata kodu 40).
- API yetkisi olan bir kullanıcı: Netgsm panelinde Abonelik İşlemleri → Alt Kullanıcı Hesapları'ndan API erişimi verilmiş bir alt kullanıcı oluşturmanız önerilir. IP kısıtı kullanıyorsanız OrqLabs'ın çıkış IP'sine izin verin.
- Ticari SMS için: Netgsm hesabınızda İYS marka tanımı (Netgsm'e İYS'de yetki verilmiş olmalı).
Adım adım kurulum
- Netgsm panelinde API yetkili kullanıcınızın kullanıcı kodunu (abone numaranız,
850xxxxxxxgibi, başında 0 olmadan) ve şifresini not edin. - Mesaj başlığı listenizden kullanacağınız onaylı başlığı birebir aynı yazımla kopyalayın.
- OrqLabs → Entegrasyonlar → Netgsm SMS → Bağla.
| Alan | Değer |
|---|---|
| Kullanıcı kodu | 8501234567 |
| API şifresi | API yetkili kullanıcının şifresi |
| Mesaj başlığı | Onaylı başlığınız (ör. MARKAM) |
| İYS modu | Otomatik (önerilen), Her zaman bilgilendirme, Her zaman ticari – bireysel / tacir |
- Bağlantıyı test et: hesaptaki onaylı başlıklar listelenir ve girdiğiniz başlığın aralarında olduğu doğrulanır; kalan kredi bilgisi gösterilir.
- Kendi numaranıza Mesaj gönder (kanal SMS – Netgsm) ile deneme SMS'i atın.
İYS modu ve 6563 sayılı Kanun
6563 sayılı Elektronik Ticaretin Düzenlenmesi Hakkında Kanun gereği tüketicilere (bireysel alıcılar) ticari elektronik ileti göndermeden önce onay alınmalı ve bu onay İYS'de (İleti Yönetim Sistemi) kayıtlı olmalıdır. Tacirlere (B2B) ret bildirimi yapılmadıkça gönderilebilir.
OrqLabs, Netgsm'in iysfilter alanını kullanır:
| İYS modu | Kampanya mesajı | Tekil mesaj (bildirim, OTP) |
|---|---|---|
| Otomatik (varsayılan) | Ticari – bireysel (iysfilter=11) | Bilgilendirme (iysfilter=0) |
| Her zaman bilgilendirme | Bilgilendirme (0) | Bilgilendirme (0) |
| Her zaman ticari – bireysel | 11 | 11 |
| Her zaman ticari – tacir | 12 | 12 |
Ticari gönderimlerde Netgsm, İYS'de onayı olmayan numaralara SMS iletmez; rapor "İYS reddi" olarak döner. Ayrıca İYS entegrasyonu bağlıysa OrqLabs kampanya öncesinde onayı olmayan alıcıları "İYS onayı yok" gerekçesiyle hiç sıraya almaz.
Uyarı: "Her zaman bilgilendirme" yalnızca gerçekten ticari olmayan mesajlar (sipariş durumu, randevu, şifre) için seçilmelidir. Kampanya, indirim, duyuru gibi içerikler ticari iletidir; sorumluluk gönderici markadadır.
Teslim raporları
- OrqLabs her 5 dakikada bir, son 3 günde gönderilen ve hâlâ "gönderildi" durumundaki Netgsm SMS'lerinin raporunu
jobidile sorgular (Netgsm dakikada 10 rapor sorgusuna izin verir; tek sorguda 100 iş). - Rapor durumları: 1 iletildi; 2 zaman aşımı, 3 hatalı numara, 4 operatöre iletilmedi, 11 reddedildi, 12 iletim hatası, 13 mükerrer, 14 bakiye yetersiz, 15 kara liste, 16 İYS reddi, 17 İYS hatası → başarısız.
- Kampanya istatistikleri (iletildi / başarısız) bu raporlarla güncellenir.
Limitler
| Konu | Sınır |
|---|---|
| Karakter | 160 karakter / boy (GSM); Türkçe karakter (ş, ğ, ı, İ, ç) içeren mesajlar encoding=TR ile gider ve boy başına daha az karakter taşır |
| Mükerrer gönderim | Aynı numaraya 1 dakikada en fazla 20 görev (kod 85) |
| Rapor sorgusu | Dakikada 10 sorgu |
| OrqLabs toplu mesaj | Dakikada varsayılan 20 mesaj (kampanyada değiştirilebilir) |
Sık karşılaşılan hatalar
| Netgsm kodu | OrqLabs hatası | Neden / çözüm |
|---|---|---|
| 30 | AUTH | Kullanıcı kodu / şifre hatalı, API yetkisi yok veya IP izni yok. Entegrasyon "süresi doldu" olur; bilgileri güncelleyin |
| 40 / 41 | CONFIG | Mesaj başlığı hesapta tanımlı değil veya geçersiz; onaylı başlığı birebir girin |
| 20 | INVALID | Mesaj metni hatalı veya çok uzun |
| 50 / 51 | FORBIDDEN | Hesabınız İYS kontrollü gönderim yapamıyor / İYS marka bilgisi yok. Netgsm'de İYS tanımını yapın veya İYS modunu "bilgilendirme" seçin (yalnızca ticari olmayan mesajlar için) |
| 70 | INVALID | Parametre hatası (ör. geçersiz numara) |
| 80 / 85 | RATE_LIMIT | Gönderim sınırı / mükerrer sınırı; mesaj bir dakika sonra yeniden denenir |
| 100 / 101 | UPSTREAM | Netgsm sistem hatası; kuyruk yeniden dener |
Sık sorulan sorular
SMS ücretini kim öder? SMS'ler sizin Netgsm hesabınızdan ve paketinizden düşer; OrqLabs SMS için ek ücret almaz (maliyet ekranında yalnızca bilgi amaçlı tahmini tutar görünür).
Kampanya mesajları neden "İYS reddi" ile başarısız oluyor? Ticari gönderimde Netgsm, İYS'de onayı olmayan numaralara iletmez. Alıcının onayını İYS'ye kaydedin (İYS entegrasyonu → İzin ekle) veya bu alıcıları kampanyadan çıkarın.
Yanıt SMS'leri Gelen Kutusu'na düşer mi? Hayır; Netgsm entegrasyonu tek yönlüdür. İki yönlü SMS için Verimor (0850 numarası) veya Twilio kullanın.
Sonraki adım
- İYS entegrasyonu – kampanya öncesi onay kontrolü ve izin kaydı
- Broadcast kampanyaları ve izin yönetimi
- İleti Merkezi SMS, Verimor SMS