SMS Yapilandirmasi

SMS bildirimleri, SetGet calisma alaninizda kritik olaylar meydana geldiginde takim uyelerinin cep telefonlarina kisa metin uyarilari teslim eder. SMS, en dogrudan bildirim kanalidir ve aninda dikkat gerektiren zamana duyarli uyarilar icin tasarlanmistir.

SMS yapilandirmasi, Calisma Alani Ayarlari > Hatirlaticilar > SMS altinda calisma alani duzeyinde yonetilir.

Desteklenen saglayicilar

SetGet iki SMS teslimat yontemini destekler:

Saglayici	Aciklama	En iyi kullanim
Twilio	Kuresel teslimat, teslimat makbuzlari ve ayrintili analizler sunan endustri standardi SMS API'si	Tam teslimat takibiyle guvenilir, olceklenebilir SMS'e ihtiyac duyan takimlar
Genel HTTP webhook	SMS teslimat isteklerini kabul eden ozel HTTP uc noktasi	Farkli bir SMS saglayicisi, dahili gecit veya ozel bir hizmet uzerinden yonlendirme yapmak isteyen takimlar

Saglayici karsilastirmasi

Ozellik	Twilio	Genel HTTP webhook
Kurulum karmasikligi	Dusuk (yalnizca API kimlik bilgileri)	Orta (webhook uc noktasi gerektirir)
Teslimat makbuzlari	Evet (yerlesik)	Uc noktaniza bagli
Kuresel kapsam	180'den fazla ulke	Saglayiciniza bagli
Maliyet modeli	Twilio uzerinden mesaj basina fiyatlandirma	Saglayiciniza bagli
Telefon numarasi saglamasi	Twilio gonderen numaralari saglar	Kendi gonderenizizi siz saglarsiniz
Basarisizlikta yeniden deneme	Otomatik (Twilio yonetimli)	Webhook'unuzda uygulanmalidir
Izleme	Twilio paneli + SetGet gecmisi	Yalnizca SetGet gecmisi
Mesaj uzunlugu	Uzun mesajlar icin otomatik coklu parca	Uc noktaniza bagli

Twilio kurulumu

On kosullar

SetGet'te Twilio'yu yapilandirmadan once asagidakilere ihtiyaciniz vardir:

1. Bir Twilio hesabi (twilio.com adresinden kayit olun).
2. SMS gonderebilen bir Twilio telefon numarasi.
3. Twilio Konsol panosundan Twilio Hesap SID'niz ve Auth Token'iniz.

Yapilandirma adimlari

1. Calisma Alani Ayarlari > Hatirlaticilar > SMS bolumune gidin.
2. Saglayici olarak Twilio secin.
3. Asagidaki kimlik bilgilerini girin:

Alan	Aciklama	Nerede bulunur
Hesap SID	Twilio hesap tanimlayiciniz	Twilio Konsol > Pano > Hesap Bilgileri
Auth Token	Twilio kimlik dogrulama gizli anahtariniz	Twilio Konsol > Pano > Hesap Bilgileri
Gonderen numara	SMS gondermek icin kullanilacak Twilio telefon numarasi	Twilio Konsol > Telefon Numaralari > Yonet > Aktif Numaralar

4. Kaydet dusesine tiklayin.

WARNING

Auth Token hassas bir kimlik bilgisidir. Sunucuda sifreli olarak saklanir ve asla on yuz veya API yanitlarinda gosterilmez. Ekran goruntuleri, gunlukler veya destek biletlerinde paylasmayın.

Gonderen numara bicimi

"Gonderen numara" E.164 biciminde olmalidir:

Bicim	Ornek	Gecerli
Ulke koduyla E.164	+14155551234	Evet
Arti isareti olmadan	14155551234	Hayir
Yerel bicim	(415) 555-1234	Hayir
Kisa kod	12345	Evet (Twilio kisa kodu olarak saglanmissa)

Twilio deneme hesabi sinirliliklari

Twilio deneme hesabi kullaniyorsaniz:

• SMS yalnizca dogrulanmis telefon numaralarina gonderilebilir.
• Mesajlar "Sent from your Twilio trial account" oneki icerir.
• Sinirli bakiyeniz vardir.

Uretim kullanimi icin, ucretli bir Twilio hesabina yukseletin ve gonderen numaranizi dogrulayin.

Genel HTTP webhook kurulumu

Genel HTTP webhook, SMS teslimatini herhangi bir HTTP uc noktasi uzerinden yonlendirmenize olanak tanir. Kurulusunuz farkli bir SMS saglayicisi, dahili SMS geciti veya AWS SNS, MessageBird ya da Vonage gibi bir hizmet kullaniyorsa yararlidir.

Yapilandirma adimlari

1. Calisma Alani Ayarlari > Hatirlaticilar > SMS bolumune gidin.
2. Saglayici olarak Genel HTTP Webhook secin.
3. Webhook URL'sini girin:

Alan	Aciklama
Webhook URL'si	SMS teslimat isteklerini alacak HTTP(S) uc noktasi

4. Kaydet dusesine tiklayin.

Webhook istek bicimi

SetGet'in SMS gondermesi gerektiginde, webhook URL'nize asagidaki JSON govdesiyle bir POST istegi gonderir:

{
  "to": "+14155551234",
  "body": "SetGet: Is Ogesi ENG-142 onceligi Acil olarak degisti. Goruntule: https://app.setget.io/...",
  "workspace_id": "ws_abc123",
  "event_type": "priority_changed",
  "timestamp": "2026-03-29T14:30:00Z"
}

Alan	Tur	Aciklama
to	string	E.164 biciminde alici telefon numarasi
body	string	SMS mesaj govdesi (duz metin)
workspace_id	string	Baglam icin calisma alani tanimlayicisi
event_type	string	Bu SMS'i tetikleyen olay turu
timestamp	string	Olayin ISO 8601 zaman damgasi

Beklenen yanit

Webhook'unuz su degerleri dondurmelidir:

Durum kodu	Anlami
200 veya 201	SMS teslimat icin kabul edildi (SetGet "gonderildi" olarak isaretler)
4xx	Istemci hatasi (SetGet hata mesajiyla "basarisiz" olarak isaretler)
5xx	Sunucu hatasi (SetGet "basarisiz" olarak isaretler ve yeniden deneyebilir)

Webhook guvenligi

Isteklerin SetGet orneginizden geldigini dogrulamak icin:

• Webhook URL'niz icin HTTPS kullanin.
• Istege bagli olarak webhook URL'sine sorgu parametresi olarak bir gizli jeton ekleyin (ornegin https://gecidiniz.com/sms?token=gizli_anahtariniz).
• workspace_id alanini bilinen calisma alani tanimlayicilarinizla dogrulayin.

SMS teslimatini test etme

Herhangi bir saglayiciyi yapilandirdiktan sonra, kurulumu dogrulamak icin bir test mesaji gonderin.

Test SMS'i gonderme

1. Calisma Alani Ayarlari > Hatirlaticilar > SMS bolumune gidin.
2. Test SMS'i Gonder dusesine tiklayin.
3. Bir telefon numarasi girin (kayitli numaraniz varsayilan olarak kullanilir).
4. Gonder dusesine tiklayin.
5. Test mesajinin hedef telefona ulastigini dogrulayin.

Test mesaji, mesaj bicimlendirmesini ve uzunlugunu degerlendirmeniz icin ornek bir uyari govdesi icerir.

Test mesaj ornegi

SetGet Uyari: [Test] Is ogesi ENG-42 "Giris yonlendirme duzelt"
onceligi Acil olarak degisti.
Goruntule: https://app.setget.io/engineering/issues/ENG-42

TIP

Ilk kurulumdan sonra ve her kimlik bilgisi degisikliginden sonra her zaman SMS testi yapin. Basarili bir test, tam teslimat hattinin calistigini dogrular: SetGet backend'inden SMS saglayicisina, mobil operatore, cihaza kadar.

SMS sablon govdesi

SMS mesajlari, e-posta sablonundan turetilen duz metin govdesi kullanir. SMS govdesi, e-posta sablonunun asagidakileri iceren yogun bir surumudur:

• Olay aciklamasi (ornegin "Durum Devam Ediyor'dan Incelemede'ye degisti")
• Is ogesi tanimlayicisi ve basligi
• SetGet'teki is ogesine dogrudan URL

SMS govdeleri, operatur sinirlamalarina uymak icin otomatik olarak kisaltilir:

Kodlama	Karakter siniri	Notlar
GSM-7 (standart)	Segment basina 160 karakter	Cogu Latin alfabe mesajlari
UCS-2 (Unicode)	Segment basina 70 karakter	Latin olmayan karakterler iceren mesajlar

Uzun mesajlar operatur tarafindan otomatik olarak birden fazla segmente bolunur. Twilio coklu segment birlesimini otomatik olarak yonetir. Genel webhook'lar icin, coklu segment yonetimi saglayicinizin sorumlulugundadir.

Telefon numarasi kaydi

Bir kullanicinin SMS bildirimleri alabilmesi icin profillerinde bir telefon numarasi kaydetmeleri gerekir.

1. Profil Ayarlari bolumune gidin.
2. E.164 biciminde telefon numaranizi girin (ornegin +14155551234).
3. Profilinizi kaydedin.

Kayitli telefon numarasi olmayan kullanicilar, bildirim tercihlerinde SMS etkinlestirilmis olsa bile SMS bildirimleri almaz.

WARNING

Telefon numaralari sunucuda saklanir ve diger calisma alani uyelerine on yuzde gosterilmez. Yalnizca kullanicinin kendisi ve calisma alani yoneticileri bir uyenin kayitli telefon numarasini gorebilir.

SMS teslimat sorunlarini giderme

Yaygin sorunlar

Belirti	Olasi neden	Cozum
Test SMS'i alinmadi	Yanlis telefon numarasi bicimi	Ulke koduyla E.164 bicimini dogrulayin
Test SMS'i alinmadi	Twilio deneme hesabi sinirlamasi	Alici numarayi Twilio konsolunda dogrulayin
Test SMS'i alinmadi	Webhook uc noktasi erisilemez	Webhook URL'sinin SetGet sunucusundan erisilebilir oldugunu kontrol edin
Gecmiste "Basarisiz" durumu	Gecersiz Twilio kimlik bilgileri	Hesap SID ve Auth Token'i yeniden girin
Gecmiste "Basarisiz" durumu	Twilio bakiyesi tukenmis	Twilio hesabiniza fon ekleyin
Gecmiste "Basarisiz" durumu	Webhook 4xx/5xx donduruyor	Webhook uc noktasi gunluklerinizi kontrol edin
Mesajlar gecikmis	Operatur kuyruk yogunlugu	Bazi operatorler icin normaldir; genellikle dakikalar icinde cozulur
Mesajlar kisaltilmis	Uzun mesaj govdesi	SMS icin beklenen davranistir; coklu segment yonetimini kontrol edin
Unicode karakterler bozuk	Operatur kodlama uyusmazligi	Operatorun UCS-2 kodlamasini destekledigini dogrulayin

Teslimat durumunu kontrol etme

1. Calisma Alani Ayarlari > Hatirlaticilar > Gecmis bolumune gidin.
2. Kanal: SMS ile filtreleyin.
3. Her SMS gonderimi icin Durum sutununu inceleyin.
4. Hata mesajini gormek icin basarisiz bir gonderime tiklayin.

Twilio icin, ayrintili operatur duzeyinde teslimat bilgileri icin Twilio Konsol > Mesajlasma > Gunlukler bolumunu de kontrol edebilirsiniz.

Guvenlik degerlendirmeleri

SMS teslimati hassas veriler ve kimlik bilgileri icerir. Su uygulamalari takip edin:

Uygulama	Ayrintilar
Kimlik bilgisi depolamasi	Twilio Auth Token beklemede sifreli olarak saklanir ve asla API yanitlarinda dondurulmez
Telefon numarasi gizliligi	Kullanici telefon numaralari yalnizca sunucu tarafindadir ve diger uyelere gosterilmez
Webhook HTTPS	Aktarim sirasinda mesaj icerigini korumak icin genel webhook URL'leri icin her zaman HTTPS kullanin
Minimal mesaj icerigi	SMS govdeleri, veri ifsa sinirini sinirlamak icin tam is ogesi ayrintilari yerine SetGet'e bir baglanti icerir
Erisim kontrolu	Yalnizca calisma alani yoneticileri SMS saglayici ayarlarini yapilandirabilir
Denetim izi	Tum SMS gonderimleri, gonderen, alici ve durumla birlikte Gecmis'e kaydedilir

WARNING

SMS mesajlarinda hassas proje ayrintilarini eklemeyin. Varsayilan sablonlar yalnizca is ogesi tanimlayicisini, kisa bir aciklamayi ve bir baglanti icerir. Tam baglam, baglanti araciligiyla uygulama icinde mevcuttur.

Maliyet yonetimi

SMS, saglayiciniza ve hedef ulkeye bagli olarak mesaj basina maliyet olusturur. Maliyetleri yonetmek icin:

• SMS'i gercekten acil olaylar icin ayirin (geciken son tarihler, engelleyici durumlar, kritik oncelik degisiklikleri).
• Hangi olaylarin SMS tetikleyecegini sinirlamak icin bildirim tercihlerini kullanin.
• SMS gonderim hacmini Gecmis sayfasinda ve istatistik panosunda izleyin.
• Beklenmeyen ucretlerden kacinmak icin Twilio harcama uyarilari olusturun.

Ilgili sayfalar

• Uyarilara genel bakis --- Uyari sistemine giris
• Tetikleyiciler --- Olay tabanli bildirim tetikleyicilerini yapilandirin
• Sablonlar --- E-posta sablon katalogu ve degisken referansi
• Bildirim tercihleri --- Kullanici basina kanal yapilandirmasi
• Uyari gecmisi --- Gonderim gunluklerini ve teslimat durumunu goruntuleyin
• En iyi uygulamalar --- Etkili bir bildirim stratejisi tasarlayin