Uyarı Şablonları
SetGet, bildirimlerin nasıl biçimlendirildiği ve teslim edildiği tanımlayan 21 sistem e-posta şablonu içerir. Şablonlar, her bildirim türü için konu satırını, gövde yapısını ve değişken yer tutucularını kontrol eder. Tüm bildirim kanallarında tutarlı biçimlendirilmiş mesajlar üretmek için tetikleyiciler ve durum eşlemeleri tarafından kullanılır.
Şablonlar çalışma alanı düzeyinde yönetilir ve Çalışma Alanı Ayarları > Hatırlatıcılar > Şablonlar bölümünden erişilebilir.
Şablon kategorileri
21 şablon, temsil ettikleri olay türüne göre beş kategoride düzenlenmiştir.
İş öğesi yaşam döngüsü (11 şablon)
Bu şablonlar, bir iş öğesinin oluşturulmadan tamamlanma ve arşivlemeye kadar olan birincil yaşam döngüsü olaylarını kapsar.
| # | Şablon adı | Kullanım amacı | Konu satırı deseni |
|---|---|---|---|
| 1 | Durum Değişikliği | İş öğesi durum geçişleri | [Proje] İş Öğesi #ID Durum'a taşındı |
| 2 | Atama | İş öğesi atandı veya yeniden atandı | [Proje] İş Öğesi #ID Kullanıcı'ya atandı |
| 3 | İş Öğesi Oluşturuldu | Yeni iş öğesi oluşturuldu | [Proje] Yeni iş öğesi: Başlık |
| 4 | Öncelik Uyarısı | Öncelik düzeyi değiştirildi | [Proje] İş Öğesi #ID önceliği Düzey olarak değişti |
| 5 | Etiket Değişti | Etiketler eklendi veya kaldırıldı | [Proje] İş Öğesi #ID etiketleri güncellendi |
| 6 | İş Öğesi Tamamlandı | İş öğesi tamamlanmış duruma ulaştı | [Proje] İş Öğesi #ID tamamlandı |
| 7 | Özellik Değişikliği | Genel özellik değişikliği | [Proje] İş Öğesi #ID özelliği güncellendi |
| 8 | Tarih Değişti | Başlangıç tarihi veya son tarih değiştirildi | [Proje] İş Öğesi #ID tarihleri güncellendi |
| 9 | Bağlantı Güncellendi | Dış bağlantı eklendi veya kaldırıldı | [Proje] İş Öğesi #ID bağlantıları güncellendi |
| 10 | İlişki Değişti | İş öğesi ilişkisi eklendi veya kaldırıldı | [Proje] İş Öğesi #ID ilişkileri güncellendi |
| 11 | İş Öğesi Arşivlendi | İş öğesi arşivlendi veya arşivden çıkarıldı | [Proje] İş Öğesi #ID arşivlendi |
Son tarih (2 şablon)
Bu şablonlar, zamana duyarlı son tarih bildirimleri için özel olarak tasarlanmıştır.
| # | Şablon adı | Kullanım amacı | Konu satırı deseni |
|---|---|---|---|
| 12 | Son Tarih Hatırlatıcı | Yaklaşan son tarih uyarısı (son tarihten önce) | [Proje] İş Öğesi #ID N gün içinde sona eriyor |
| 13 | Son Tarih Geçti | Son tarih geçmiştir | [Proje] İş Öğesi #ID gecikti |
UYARI
Son Tarih Hatırlatıcı şablonu, son tarihten önceki proaktif uyarılar içindir. Son Tarih Geçti şablonu, son tarih geçtikten sonraki reaktif uyarılar içindir. Tetikleyicilerin amaçlanan zamanlamaya uygun şablonu kullandığından emin olun.
İşbirliği (4 şablon)
Bu şablonlar, takım etkileşim olaylarını kapsar.
| # | Şablon adı | Kullanım amacı | Konu satırı deseni |
|---|---|---|---|
| 14 | Yorum Eklendi | Bir iş öğesine yeni yorum | [Proje] İş Öğesi #ID'ye yeni yorum |
| 15 | Bahsetme | Kullanıcı yorum veya açıklamada @bahsedildi | [Proje] Kullanıcı sizi İş Öğesi #ID'de bahsetti |
| 16 | Döngüye İş Öğesi Eklendi | İş öğesi bir döngüye eklendi | [Proje] İş Öğesi #ID Döngü'ye eklendi |
| 17 | Modüle İş Öğesi Eklendi | İş öğesi bir modüle eklendi | [Proje] İş Öğesi #ID Modül'e eklendi |
Kimlik doğrulama (2 şablon)
Bu şablonlar, hesap güvenliği ve erişim akışlarını yönetir. Tetikleyici sistemi aracılığıyla yapılandırılamaz ve kimlik doğrulama alt sistemi tarafından otomatik olarak gönderilir.
| # | Şablon adı | Kullanım amacı | Konu satırı deseni |
|---|---|---|---|
| 18 | Şifre Sıfırlama | Şifre sıfırlama isteği | SetGet: Şifrenizi sıfırlayın |
| 19 | Sihirli Giriş Kodu | Şifresiz giriş kodu | SetGet: Giriş kodunuz |
İPUCU
Kimlik doğrulama şablonları tetikleyicilere bağlanamaz. Bir kullanıcı şifre sıfırlama veya sihirli giriş bağlantısı istediğinde otomatik olarak gönderilir. Burada bütünlük için listelenmiştir ve Şablonlar sayfasında önizlenebilir.
Çalışma alanı (2 şablon)
Bu şablonlar, çalışma alanı düzeyindeki iletişimleri yönetir.
| # | Şablon adı | Kullanım amacı | Konu satırı deseni |
|---|---|---|---|
| 20 | Çalışma Alanı Daveti | Çalışma alanına katılma daveti | SetGet'te ÇalışmaAlanı'na davet edildiniz |
| 21 | Hoş Geldiniz | Çalışma alanına katıldıktan sonraki karşılama mesajı | SetGet'te ÇalışmaAlanı'na hoş geldiniz |
Şablon değişkenleri
Her şablon, olay bağlamındaki verilerle otomatik olarak doldurulan değişkenler kullanır. Değişkenler çift süslü parantez içine alınır: {{degisken_adi}}.
Ortak değişkenler (tüm şablonlarda mevcuttur)
| Değişken | Açıklama | Örnek değer |
|---|---|---|
{{workspace_name}} | Çalışma alanının adı | Mühendislik |
{{workspace_slug}} | URL-uyumlu çalışma alanı tanımlayıcısı | mühendislik |
{{recipient_name}} | Bildirim alıcısının görünen adı | Ayşe Yılmaz |
{{recipient_email}} | Alıcının e-posta adresi | ayse@ornek.com |
{{app_url}} | SetGet örneğinin temel URL'si | https://app.setget.io |
{{current_date}} | Çalışma alanının yerel ayarında geçerli tarih | 29 Mart 2026 |
{{current_time}} | Çalışma alanının saat diliminde geçerli saat | 14:30 UTC |
İş öğesi değişkenleri (iş öğesiyle ilgili şablonlarda mevcuttur)
| Değişken | Açıklama | Örnek değer |
|---|---|---|
{{issue_id}} | Sıralı iş öğesi tanımlayıcısı | ENG-142 |
{{issue_title}} | İş öğesinin başlığı | Giriş yönlendirme döngüsü hatası düzelt |
{{issue_url}} | İş öğesine doğrudan URL | https://app.setget.io/engineering/issues/ENG-142 |
{{issue_state}} | Mevcut durum adı | Devam Ediyor |
{{issue_priority}} | Mevcut öncelik düzeyi | Yüksek |
{{issue_assignee}} | Mevcut atanan kişinin görünen adı | Ahmet Demir |
{{issue_creator}} | Oluşturucunun görünen adı | Ayşe Yılmaz |
{{issue_due_date}} | Ayarlıysa son tarih | 15 Nisan 2026 |
{{issue_labels}} | Virgülle ayrılmış etiket listesi | Hata, Backend, Kritik |
{{project_name}} | İş öğesini içeren projenin adı | Platform API |
{{project_identifier}} | Proje tanımlayıcı öneki | ENG |
Olaya özel değişkenler
| Değişken | Mevcut olduğu yer | Açıklama |
|---|---|---|
{{old_state}} | Durum Değişikliği, İş Öğesi Tamamlandı | Önceki durum adı |
{{new_state}} | Durum Değişikliği, İş Öğesi Tamamlandı | Yeni durum adı |
{{old_assignee}} | Atama | Önceki atanan adı (veya "Atanmamış") |
{{new_assignee}} | Atama | Yeni atanan adı (veya "Atanmamış") |
{{old_priority}} | Öncelik Uyarısı | Önceki öncelik düzeyi |
{{new_priority}} | Öncelik Uyarısı | Yeni öncelik düzeyi |
{{comment_body}} | Yorum Eklendi | Yorumun metin içeriği (500 karaktere kısaltılır) |
{{comment_author}} | Yorum Eklendi | Yorum yazarının görünen adı |
{{mention_context}} | Bahsetme | Bahsetmenin gerçekleştiği çevre metin |
{{mentioner_name}} | Bahsetme | Sizi bahseden kullanıcının görünen adı |
{{cycle_name}} | Döngüye İş Öğesi Eklendi | Döngünün adı |
{{module_name}} | Modüle İş Öğesi Eklendi | Modülün adı |
{{days_overdue}} | Son Tarih Geçti | Son tarihten bu yana geçen gün sayısı |
{{days_until_due}} | Son Tarih Hatırlatıcı | Son tarihe kalan gün sayısı |
{{link_url}} | Bağlantı Güncellendi | Eklenen veya kaldırılan bağlantının URL'si |
{{relation_type}} | İlişki Değişti | İlişki türü (engelliyor, engelleniyor vb.) |
{{related_issue_id}} | İlişki Değişti | İlişkili iş öğesinin ID'si |
{{actor_name}} | Tüm olay şablonları | Olayı tetikleyen kullanıcının görünen adı |
Kimlik doğrulama ve çalışma alanı değişkenleri
| Değişken | Mevcut olduğu yer | Açıklama |
|---|---|---|
{{reset_link}} | Şifre Sıfırlama | Şifre sıfırlama URL'si (süre sınırlı) |
{{signin_code}} | Sihirli Giriş Kodu | Altı haneli giriş kodu |
{{inviter_name}} | Çalışma Alanı Daveti | Daveti gönderen kullanıcının adı |
{{invite_link}} | Çalışma Alanı Daveti | Davet kabul URL'si |
{{workspace_description}} | Hoş Geldiniz | Çalışma alanının kısa açıklaması |
Şablonları önizleme
Şablon önizleme özelliği, bir şablonu tetikleyicide etkinleştirmeden önce örnek verilerle nasıl görüneceğini görmenizi sağlar.
Nasıl önizlenir
- Çalışma Alanı Ayarları > Hatırlatıcılar > Şablonlar bölümüne gidin.
- Listedeki herhangi bir şablona tıklayın.
- Sağ tarafta, şablonun örnek verilerle işlendiğini gösteren önizleme paneli açılır.
- Biçimlendirme ve düzeni değerlendirmeniz için tüm değişkenler gerçekçi yer tutucu değerlerle doldurulur.
Önizleme, alıcının e-posta istemcisinde göreceğine uyan HTML biçiminde işlenir. SMS önizlemeleri için bunun yerine düz metin gövdesi gösterilir.
Örnek veriler
Önizleme sistemi örnek verileri otomatik olarak üretir:
| Değişken kategorisi | Örnek veri kaynağı |
|---|---|
| Çalışma alanı alanları | Mevcut çalışma alanı adı ve slug'ı |
| Alıcı alanları | Kendi kullanıcı profiliniz |
| İş öğesi alanları | Sentetik örnek veriler (örneğin "ENG-42", "Giriş yönlendirme düzelt") |
| Olay alanları | Sentetik önceki/sonraki değerler |
| Tarihler ve saatler | Mevcut tarih ve saat |
Şablonları test etme
Önizlemenin ötesinde, uçtan uca teslimati doğrulamak için gerçek bir test bildirimi gönderebilirsiniz.
Test e-postası gönderme
- Şablon önizlemesini açın.
- Test E-postası Gönder düğmesine tıklayın.
- Sistem, şablonu örnek verilerle kayıtlı e-posta adresinize gönderir.
- Teslimati ve biçimlendirmeyi doğrulamak için gelen kutunuzu (ve spam klasörünüzü) kontrol edin.
Test SMS'i gönderme
- Şablon önizlemesini açın.
- Test SMS'i Gönder düğmesine tıklayın (yalnızca SMS yapılandırılmışsa kullanılabilir).
- Sistem, şablonun düz metin gövdesini kayıtlı telefon numaranıza gönderir.
- SMS'in ulaştığını ve mesaj içeriğinin okunabilir olduğunu doğrulayın.
İPUCU
SMTP yapılandırmanızda veya SMS sağlayıcı ayarlarınızda değişiklik yaptıktan sonra her zaman bir test bildirimi gönderin. Bu, teslimat hattının doğru çalıştığını doğrular.
UYARI
Test gönderimleri Geçmiş günlüğüne "test" etiketiyle kaydedilir. Günlük gönderim istatistiklerinize dahil edilir.
Dil duyarlı işleme
Şablonlar, alıcının yerel ayar tercihine dayalı olarak dil duyarlı işlemeyi destekler:
- Alıcının profilinde bir yerel ayar belirlenmişse, şablon tarih biçimleri, sayı biçimleri ve statik etiket metinlerini o yerel ayarda işler.
- Yerel ayar belirlenmemişse, çalışma alanı varsayılan yerel ayarı kullanılır.
- Değişken içerik (iş öğesi başlıkları, yorum gövdeleri, kullanıcı adları) yerel ayardan bağımsız olarak olduğu gibi işlenir, çünkü bu içerik kullanıcı tarafından oluşturulmuştur.
Desteklenen yerel ayar öğeleri:
| Öğe | Örnek (en-US) | Örnek (tr-TR) |
|---|---|---|
| Tarih biçimi | March 29, 2026 | 29 Mart 2026 |
| Saat biçimi | 2:30 PM | 14:30 |
| Öncelik etiketleri | High | Yüksek |
| Durum etiketleri | In Progress | Devam Ediyor |
| Düğme metni | View Issue | Görüntüye Git |
Şablon yapısı
Her şablon aşağıdaki bileşenlerden oluşur:
| Bileşen | Açıklama | Düzenlenebilir |
|---|---|---|
| Konu satırı | Değişken yer tutucularıyla e-posta konusu | Hayır (sistem tanımlı) |
| Üst bilgi | SetGet markası ve çalışma alanı bağlamı | Hayır (sistem tanımlı) |
| Gövde | Değişkenler ve biçimlendirmeyle ana bildirim içeriği | Hayır (sistem tanımlı) |
| Eylem düğmesi | SetGet'teki ilgili varlığa doğrudan bağlantı | Hayır (sistem tanımlı) |
| Alt bilgi | Abonelikten çıkma bağlantısı ve çalışma alanı bilgileri | Hayır (sistem tanımlı) |
| SMS gövdesi | SMS teslimati için düz metin kısa sürüm | Hayır (sistem tanımlı) |
İPUCU
Sistem şablonları SetGet'in mevcut sürümünde kullanıcı tarafından düzenlenemez. Standart bildirim senaryolarını kapsayacak şekilde tasarlanmıştır. Özel biçimlendirmeye ihtiyacınız varsa, destek aracılığıyla bir özellik isteği gönderin.
Şablondan tetikleyiciye eşleştirme
Her tetikleyici tam olarak bir şablona referans vermek zorundadır. Aşağıdaki tablo, olay türleri ve şablonlar arasındaki önerilen eşleştirmeyi özetler:
| Olay türü | Birincil şablon | Alternatif şablon |
|---|---|---|
state_changed | Durum Değişikliği | Özellik Değişikliği |
assignee_changed | Atama | Özellik Değişikliği |
priority_changed | Öncelik Uyarısı | Özellik Değişikliği |
comment_added | Yorum Eklendi | --- |
issue_created | İş Öğesi Oluşturuldu | --- |
due_date_passed | Son Tarih Geçti | Son Tarih Hatırlatıcı |
label_changed | Etiket Değişti | Özellik Değişikliği |
property_changed | Özellik Değişikliği | --- |
issue_completed | İş Öğesi Tamamlandı | Durum Değişikliği |
mentioned | Bahsetme | Yorum Eklendi |
date_changed | Tarih Değişti | Özellik Değişikliği |
cycle_changed | Döngüye İş Öğesi Eklendi | Özellik Değişikliği |
module_changed | Modüle İş Öğesi Eklendi | Özellik Değişikliği |
link_changed | Bağlantı Güncellendi | Özellik Değişikliği |
relation_changed | İlişki Değişti | Özellik Değişikliği |
archive_changed | İş Öğesi Arşivlendi | Özellik Değişikliği |
Şablon işleme hattı
Bir bildirim gönderildiğinde, şablon işleme şu hattı izler:
- Şablon seçimi --- Tetikleyici veya durum eşlemesi hangi şablonun kullanılacağını belirtir.
- Değişken çözümleme --- Sistem, olay bağlamındaki (iş öğesi, aktör, proje vb.) tüm değişken değerlerini toplar.
- Yerel ayar algılama --- Alıcının yerel ayar tercihi profilinden okunur. Ayarlanmamışsa, çalışma alanı varsayılan yerel ayarı kullanılır.
- HTML işleme --- E-posta için, şablon gövdesi değişken değiştirme, yerel ayar duyarlı biçimlendirme ve SetGet e-posta düzeni (üst bilgi, gövde, eylem düğmesi, alt bilgi) ile HTML olarak işlenir.
- Düz metin çıkarma --- SMS için, şablonun SMS gövdesi değişken değiştirmeyle düz metin olarak işlenir.
- Uygulama içi işleme --- Uygulama içi bildirimler için, şablonun yoğunlaştırılmış bir sürümü bildirim paneli biçiminde işlenir.
Değişken yedek değerleri
Bir değişken olay bağlamında mevcut değilse (örneğin, iş öğesi daha önce atanmamışken {{old_assignee}}), sistem mantıklı varsayılan değerler kullanır:
| Değişken | Yedek değer |
|---|---|
{{old_assignee}} | "Atanmamış" |
{{old_state}} | "Yok" |
{{old_priority}} | "Yok" |
{{issue_due_date}} | "Ayarlanmamış" |
{{issue_labels}} | "Yok" |
{{cycle_name}} | "Yok" |
{{module_name}} | "Yok" |
E-posta düzeni yapısı
Tüm e-posta şablonları tutarlı bir düzeni paylaşır:
+------------------------------------------+
| SetGet logosu + Çalışma alanı adı |
| (üst bilgi) |
+------------------------------------------+
| |
| Konu satırı / Olay başlığı |
| |
| Değişkenlerle olay ayrıntıları |
| (durum değişikliği, yorum gövdesi vb.) |
| |
| [ SetGet'te Görüntüle ] (eylem düğmesi) |
| |
+------------------------------------------+
| Bildirim tercihleri bağlantısı |
| (alt bilgi) |
| Abonelikten çıkma bağlantısı |
+------------------------------------------+Eylem düğmesi doğrudan SetGet'teki ilgili varlığa bağlanır. Tıklama, alıcıyı bildirimde referans verilen iş öğesine, yoruma veya diğer varlığa götürür.
Sıkça sorulan sorular
Özel şablonlar oluşturabilir miyim? Mevcut sürümde hayır. 21 sistem şablonu standart bildirim senaryolarını kapsar. Özel şablon desteği gelecek bir sürüm için planlanmıştır.
Bir şablonun konu satırını düzenleyebilir miyim? Hayır. Konu satırları tutarlılığı sağlamak için sistem tarafından tanımlanmıştır. Proje tanımlayıcısı, iş öğesi ID'si ve olaya özel bağlam içerirler.
Neden bazı şablonlar listede görünüyor ama tetikleyicilere atanamıyor? Kimlik Doğrulama şablonları (Şifre Sıfırlama, Sihirli Giriş Kodu) ve Çalışma Alanı şablonları (Davet, Hoş Geldiniz) ilgili alt sistemleri tarafından otomatik olarak gönderilir ve kullanıcı tarafından yapılandırılan tetikleyicilere atanamaz.
Bir şablon için hangi değişkenlerin mevcut olduğunu nasıl öğrenirim? Şablon önizleme paneli, mevcut tüm değişkenleri ve örnek değerlerini gösterir. Şablonun olay türüyle ilgili olmayan değişkenler görüntülenmez.
İlgili sayfalar
- Uyarılara genel bakış --- Uyarı sistemine giriş
- Tetikleyiciler --- Olay tabanlı bildirim tetikleyicilerini yapılandırın
- Durum eşlemeleri --- Durumdan duruma geçiş uyarıları
- SMS yapılandırması --- SMS teslimat sağlayıcıları yapılandırın
- 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
- Yönetici e-posta şablonları --- Örnek düzeyinde e-posta şablonu yönetimi