SMS Yapılandırması

SMS bildirimleri, SetGet çalışma alanınızda kritik olaylar meydana geldiğinde takım üyelerinin cep telefonlarına kısa metin uyarıları teslim eder. SMS, en doğrudan bildirim kanalıdır ve anında dikkat gerektiren zamana duyarlı uyarılar için tasarlanmıştır.

SMS yapılandırması, Çalışma Alanı Ayarları > Hatırlatıcılar > SMS altında çalışma alanı düzeyinde yönetilir.

Desteklenen sağlayıcılar

SetGet iki SMS teslimat yöntemini destekler:

Sağlayıcı	Açıklama	En iyi kullanım
Twilio	Küresel teslimat, teslimat makbuzları ve ayrıntılı analizler sunan endüstri standardı SMS API'si	Tam teslimat takibiyle güvenilir, ölçeklenebilir SMS'e ihtiyaç duyan takımlar
Genel HTTP webhook	SMS teslimat isteklerini kabul eden özel HTTP uç noktası	Farklı bir SMS sağlayıcısı, dahili geçit veya özel bir hizmet üzerinden yönlendirme yapmak isteyen takımlar

Sağlayıcı karşılaştırması

Özellik	Twilio	Genel HTTP webhook
Kurulum karmaşıklığı	Düşük (yalnızca API kimlik bilgileri)	Orta (webhook uç noktası gerektirir)
Teslimat makbuzları	Evet (yerleşik)	Uç noktanıza bağlı
Küresel kapsam	180'den fazla ülke	Sağlayıcınıza bağlı
Maliyet modeli	Twilio üzerinden mesaj başına fiyatlandırma	Sağlayıcınıza bağlı
Telefon numarası sağlaması	Twilio gönderen numaraları sağlar	Kendi göndereninizi siz sağlarsınız
Başarısızlıkta yeniden deneme	Otomatik (Twilio yönetimli)	Webhook'unuzda uygulanmalıdır
İzleme	Twilio panosu + SetGet geçmişi	Yalnızca SetGet geçmişi
Mesaj uzunluğu	Uzun mesajlar için otomatik çoklu parça	Uç noktanıza bağlı

Twilio kurulumu

Ön koşullar

SetGet'te Twilio'yu yapılandırmadan önce aşağıdakilere ihtiyacınız vardır:

1. Bir Twilio hesabı (twilio.com adresinden kayıt olun).
2. SMS gönderebilen bir Twilio telefon numarası.
3. Twilio Konsol panosundan Twilio Hesap SID'niz ve Auth Token'ınız.

Yapılandırma adımları

1. Çalışma Alanı Ayarları > Hatırlatıcılar > SMS bölümüne gidin.
2. Sağlayıcı olarak Twilio seçin.
3. Aşağıdaki kimlik bilgilerini girin:

Alan	Açıklama	Nerede bulunur
Hesap SID	Twilio hesap tanımlayıcınız	Twilio Konsol > Pano > Hesap Bilgileri
Auth Token	Twilio kimlik doğrulama gizli anahtarınız	Twilio Konsol > Pano > Hesap Bilgileri
Gönderen numara	SMS göndermek için kullanılacak Twilio telefon numarası	Twilio Konsol > Telefon Numaraları > Yönet > Aktif Numaralar

4. Kaydet düğmesine tıklayın.

UYARI

Auth Token hassas bir kimlik bilgisidir. Sunucuda şifreli olarak saklanır ve asla ön yüz veya API yanıtlarında gösterilmez. Ekran görüntüleri, günlükler veya destek biletlerinde paylaşmayın.

Gönderen numara biçimi

"Gönderen numara" E.164 biçiminde olmalıdır:

Biçim	Örnek	Geçerli
Ülke koduyla E.164	+14155551234	Evet
Artı işareti olmadan	14155551234	Hayır
Yerel biçim	(415) 555-1234	Hayır
Kısa kod	12345	Evet (Twilio kısa kodu olarak sağlanmışsa)

Twilio deneme hesabı sınırlılıkları

Twilio deneme hesabı kullanıyorsanız:

• SMS yalnızca doğrulanmış telefon numaralarına gönderilebilir.
• Mesajlar "Sent from your Twilio trial account" öneki içerir.
• Sınırlı bakiyeniz vardır.

Üretim kullanımı için, ücretli bir Twilio hesabına yükseltin ve gönderen numaranızı doğrulayın.

Genel HTTP webhook kurulumu

Genel HTTP webhook, SMS teslimatını herhangi bir HTTP uç noktası üzerinden yönlendirmenize olanak tanır. Kuruluşunuz farklı bir SMS sağlayıcısı, dahili SMS geçiti veya AWS SNS, MessageBird ya da Vonage gibi bir hizmet kullanıyorsa yararlıdır.

Yapılandırma adımları

1. Çalışma Alanı Ayarları > Hatırlatıcılar > SMS bölümüne gidin.
2. Sağlayıcı olarak Genel HTTP Webhook seçin.
3. Webhook URL'sini girin:

Alan	Açıklama
Webhook URL'si	SMS teslimat isteklerini alacak HTTP(S) uç noktası

4. Kaydet düğmesine tıklayın.

Webhook istek biçimi

SetGet'in SMS göndermesi gerektiğinde, webhook URL'nize aşağıdaki JSON gövdesiyle bir POST isteği gönderir:

{
  "to": "+14155551234",
  "body": "SetGet: İş Öğesi ENG-142 önceliği Acil olarak değişti. Görüntüle: https://app.setget.io/...",
  "workspace_id": "ws_abc123",
  "event_type": "priority_changed",
  "timestamp": "2026-03-29T14:30:00Z"
}

Alan	Tür	Açıklama
to	string	E.164 biçiminde alıcı telefon numarası
body	string	SMS mesaj gövdesi (düz metin)
workspace_id	string	Bağlam için çalışma alanı tanımlayıcısı
event_type	string	Bu SMS'i tetikleyen olay türü
timestamp	string	Olayın ISO 8601 zaman damgası

Beklenen yanıt

Webhook'unuz şu değerleri döndürmelidir:

Durum kodu	Anlamı
200 veya 201	SMS teslimat için kabul edildi (SetGet "gönderildi" olarak işaretler)
4xx	İstemci hatası (SetGet hata mesajıyla "başarısız" olarak işaretler)
5xx	Sunucu hatası (SetGet "başarısız" olarak işaretler ve yeniden deneyebilir)

Webhook güvenliği

İsteklerin SetGet örneğinizden geldiğini doğrulamak için:

• Webhook URL'niz için HTTPS kullanın.
• İsteğe bağlı olarak webhook URL'sine sorgu parametresi olarak bir gizli jeton ekleyin (örneğin https://gecidiniz.com/sms?token=gizli_anahtariniz).
• workspace_id alanını bilinen çalışma alanı tanımlayıcılarınızla doğrulayın.

SMS teslimatını test etme

Herhangi bir sağlayıcıyı yapılandırdıktan sonra, kurulumu doğrulamak için bir test mesajı gönderin.

Test SMS'i gönderme

1. Çalışma Alanı Ayarları > Hatırlatıcılar > SMS bölümüne gidin.
2. Test SMS'i Gönder düğmesine tıklayın.
3. Bir telefon numarası girin (kayıtlı numaranız varsayılan olarak kullanılır).
4. Gönder düğmesine tıklayın.
5. Test mesajının hedef telefona ulaştığını doğrulayın.

Test mesajı, mesaj biçimlendirmesini ve uzunluğunu değerlendirmeniz için örnek bir uyarı gövdesi içerir.

Test mesaj örneği

SetGet Uyarı: [Test] İş öğesi ENG-42 "Giriş yönlendirme düzelt"
önceliği Acil olarak değişti.
Görüntüle: https://app.setget.io/engineering/issues/ENG-42

İPUCU

İlk kurulumdan sonra ve her kimlik bilgisi değişikliğinden sonra her zaman SMS testi yapın. Başarılı bir test, tam teslimat hattının çalıştığını doğrular: SetGet backend'inden SMS sağlayıcısına, mobil operatöre, cihaza kadar.

SMS şablon gövdesi

SMS mesajları, e-posta şablonundan türetilen düz metin gövdesi kullanır. SMS gövdesi, e-posta şablonunun aşağıdakileri içeren yoğun bir sürümüdür:

• Olay açıklaması (örneğin "Durum Devam Ediyor'dan İncelemede'ye değişti")
• İş öğesi tanımlayıcısı ve başlığı
• SetGet'teki iş öğesine doğrudan URL

SMS gövdeleri, operatör sınırlamalarına uymak için otomatik olarak kısaltılır:

Kodlama	Karakter sınırı	Notlar
GSM-7 (standart)	Segment başına 160 karakter	Çoğu Latin alfabe mesajları
UCS-2 (Unicode)	Segment başına 70 karakter	Latin olmayan karakterler içeren mesajlar

Uzun mesajlar operatör tarafından otomatik olarak birden fazla segmente bölünür. Twilio çoklu segment birleşimini otomatik olarak yönetir. Genel webhook'lar için, çoklu segment yönetimi sağlayıcınızın sorumluluğundadır.

Telefon numarası kaydı

Bir kullanıcının SMS bildirimleri alabilmesi için profillerinde bir telefon numarası kaydetmeleri gerekir.

1. Profil Ayarları bölümüne gidin.
2. E.164 biçiminde telefon numaranızı girin (örneğin +14155551234).
3. Profilinizi kaydedin.

Kayıtlı telefon numarası olmayan kullanıcılar, bildirim tercihlerinde SMS etkinleştirilmiş olsa bile SMS bildirimleri almaz.

UYARI

Telefon numaraları sunucuda saklanır ve diğer çalışma alanı üyelerine ön yüzde gösterilmez. Yalnızca kullanıcının kendisi ve çalışma alanı yöneticileri bir üyenin kayıtlı telefon numarasını görebilir.

SMS teslimat sorunlarını giderme

Yaygın sorunlar

Belirti	Olası neden	Çözüm
Test SMS'i alınmadı	Yanlış telefon numarası biçimi	Ülke koduyla E.164 biçimini doğrulayın
Test SMS'i alınmadı	Twilio deneme hesabı sınırlaması	Alıcı numarayı Twilio konsolunda doğrulayın
Test SMS'i alınmadı	Webhook uç noktası erişilemez	Webhook URL'sinin SetGet sunucusundan erişilebilir olduğunu kontrol edin
Geçmişte "Başarısız" durumu	Geçersiz Twilio kimlik bilgileri	Hesap SID ve Auth Token'ı yeniden girin
Geçmişte "Başarısız" durumu	Twilio bakiyesi tükenmiş	Twilio hesabınıza fon ekleyin
Geçmişte "Başarısız" durumu	Webhook 4xx/5xx döndürüyor	Webhook uç noktası günlüklerinizi kontrol edin
Mesajlar gecikmiş	Operatör kuyruk yoğunluğu	Bazı operatörler için normaldir; genellikle dakikalar içinde çözülür
Mesajlar kısaltılmış	Uzun mesaj gövdesi	SMS için beklenen davranıştır; çoklu segment yönetimini kontrol edin
Unicode karakterler bozuk	Operatör kodlama uyuşmazlığı	Operatörün UCS-2 kodlamasını desteklediğini doğrulayın

Teslimat durumunu kontrol etme

1. Çalışma Alanı Ayarları > Hatırlatıcılar > Geçmiş bölümüne gidin.
2. Kanal: SMS ile filtreleyin.
3. Her SMS gönderimi için Durum sütununu inceleyin.
4. Hata mesajını görmek için başarısız bir gönderime tıklayın.

Twilio için, ayrıntılı operatör düzeyinde teslimat bilgileri için Twilio Konsol > Mesajlaşma > Günlükler bölümünü de kontrol edebilirsiniz.

Güvenlik değerlendirmeleri

SMS teslimati hassas veriler ve kimlik bilgileri içerir. Şu uygulamaları takip edin:

Uygulama	Ayrıntılar
Kimlik bilgisi depolaması	Twilio Auth Token beklemede şifreli olarak saklanır ve asla API yanıtlarında döndürülmez
Telefon numarası gizliliği	Kullanıcı telefon numaraları yalnızca sunucu tarafındadır ve diğer üyelere gösterilmez
Webhook HTTPS	Aktarım sırasında mesaj içeriğini korumak için genel webhook URL'leri için her zaman HTTPS kullanın
Minimal mesaj içeriği	SMS gövdeleri, veri ifşa sınırını sınırlamak için tam iş öğesi ayrıntıları yerine SetGet'e bir bağlantı içerir
Erişim kontrolü	Yalnızca çalışma alanı yöneticileri SMS sağlayıcı ayarlarını yapılandırabilir
Denetim izi	Tüm SMS gönderimleri, gönderen, alıcı ve durumla birlikte Geçmiş'e kaydedilir

UYARI

SMS mesajlarında hassas proje ayrıntılarını eklemeyin. Varsayılan şablonlar yalnızca iş öğesi tanımlayıcısını, kısa bir açıklamayı ve bir bağlantı içerir. Tam bağlam, bağlantı aracılığıyla uygulama içinde mevcuttur.

Maliyet yönetimi

SMS, sağlayıcınıza ve hedef ülkeye bağlı olarak mesaj başına maliyet oluşturur. Maliyetleri yönetmek için:

• SMS'i gerçekten acil olaylar için ayırın (geciken son tarihler, engelleyici durumlar, kritik öncelik değişiklikleri).
• Hangi olayların SMS tetikleyeceğini sınırlamak için bildirim tercihlerini kullanın.
• SMS gönderim hacmini Geçmiş sayfasında ve istatistik panosunda izleyin.
• Beklenmeyen ücretlerden kaçınmak için Twilio harcama uyarıları oluşturun.

İlgili sayfalar

• Uyarılara genel bakış --- Uyarı sistemine giriş
• Tetikleyiciler --- Olay tabanlı bildirim tetikleyicilerini yapılandırın
• Şablonlar --- E-posta şablon kataloğu ve değişken referansı
• Bildirim tercihleri --- Kullanıcı başına kanal yapılandırması
• Uyarı geçmişi --- Gönderim günlüklerini ve teslimat durumunu görüntüleyin
• En iyi uygulamalar --- Etkili bir bildirim stratejisi tasarlayın