NetGSM & Twilio SMS Entegrasyonu

NetGSM’de alt kullanıcı ve API şifresi oluştur

Purvisor, NetGSM API’sine ana abone numaranızla değil, alt kullanıcı koduyla bağlanır. Bunu, ofisteki herkese ayrı bir giriş kartı vermeye benzet: ana hesap kasadır, API isteği ise sınırlı yetkili bir kartla yapılır.

NetGSM panelinde:

• Abonelik İşlemleri → Alt Kullanıcı Hesapları bölümüne git.
• Bir alt kullanıcı kodu belirle (genellikle abone numaranızla aynı olabilir) ve o alt kullanıcıya özel bir API şifresi üret (panel giriş şifreniz değil).
• API İşlemleri sayfasında API erişiminin “Açık” olduğundan emin ol.
• Alt kullanıcının SMS Hizmeti yetkisinin açık olduğunu doğrula — kapalıysa bakiye sorgusu geçse bile SMS’te Hata 30 alırsın.
• Gönderici başlığı (msgheader) başvurusu yap ve onaylanmasını bekle. Bu başlık, alıcının telefonunda “gönderen” olarak görünen isimdir (SMS’in arayan kimliği gibi düşün, örn. PURVISOR).

📸 [Ekran görüntüsü: NetGSM panel — Alt Kullanıcı Hesapları ve API şifresi üretme ekranı]

Purvisor’a NetGSM bilgilerini gir

Panelde Entegrasyonlar → NetGSM alanına şu üç değeri gir:

Kaydettiğinde arka planda şu istek çalışır:

POST /api/integrations/service-config
Content-Type: application/json
 
{
  "provider": "netgsm",
  "config": {
    "usercode": "8503021234",
    "password": "alt-kullanici-api-sifresi",
    "msgheader": "PURVISOR"
  },
  "isActive": true
}

usercode veya password eksikse istek 400 ile “NetGSM kullanıcı kodu ve şifre gerekli” döner. Kaydedildikten sonra password panelde maskeli (85••••••••) görünür — bu normaldir.

Bağlantıyı test et

Test butonu, gerçek SMS harcamadan önce kimlik bilgilerini doğrular. Arka planda Purvisor önce NetGSM’in bakiye ucunu (https://api.netgsm.com.tr/balance/list/get) çağırır; testNumber girersen ardından bir test SMS’i gönderir.

POST /api/integrations/service-config/test
Content-Type: application/json
 
{
  "provider": "netgsm",
  "config": {
    "usercode": "8503021234",
    "password": "alt-kullanici-api-sifresi",
    "msgheader": "PURVISOR",
    "testNumber": "+905551112233"
  }
}

Başarılı yanıt, hesabındaki onaylı başlıkları da listeler:

{
  "success": true,
  "message": "NetGSM bağlantısı başarılı! Mevcut başlıklar: PURVISOR",
  "availableHeaders": ["PURVISOR"]
}

Test SMS’inde numara otomatik normalize edilir: +90, 90 ve baştaki 0 temizlenip 10 haneli yerel numaraya indirgenir. Yani +90 555 111 22 33, 0555 111 22 33 ve 5551112233 aynı şekilde çalışır.

Twilio bilgilerini al ve gir

Twilio Console → Account SID ve Auth Token’ı kopyala; SMS gönderebilen bir Twilio numarası edin. Panelde Entegrasyonlar → Twilio:

Kaydederken en az bir Twilio alanı dolu olmalı; hiçbiri yoksa istek 400 “En az bir Twilio alanı gerekli” döner. Gerçek gönderim içinse üç alanın (SID, token, numara) da dolu olması gerekir.

Test et

Test butonu, Twilio hesabını doğrular (GET .../Accounts/{accountSid}.json) ve testNumber girdiysen bir test SMS’i yollar. Kimlik hatasında “Twilio kimlik doğrulama başarısız” mesajıyla Account SID / Auth Token kontrolü istenir.