Send Mail Aksiyonu Uygulama Adımları

  • Kuika platformuna giriş yapın ve ilgili projeyi açın.
  • UI Design modülüne geçin.
  • E-posta gönderimini tetikleyecek elementi seçin.
  • Sağ panelde + ADD ACTION menüsünü açın.
  • + ADD ACTION menüsünden istediğiniz tetikleyici olaya (Initial Actions, OnClick, OnBlur vb.) göre Notification > Send Email aksiyonunu ekleyin.

Mail Tipi Seçimi

  • Custom: E-posta içeriğini tamamen manuel oluşturmanıza olanak tanır.
  • Template: Kuika’nın sunduğu hazır şablonlardan birini seçerek hızlı yapılandırma yapmanızı sağlar.

Custom Mail Yapılandırması

  • Receivers: E-posta gönderilecek kullanıcıların e-posta adreslerini girin.
  • Subject: Gönderilecek e-postanın konu başlığını belirtin.
  • Body: E-posta içeriğini manuel olarak yazın.

Hazır Şablon Seçenekleri

Kuika platformunda Send Mail aksiyonu altında kullanılabilen şablonlar, sık kullanılan e-posta senaryoları için önceden yapılandırılmıştır. Her bir şablon, farklı kullanım amaçlarına hizmet eder ve ilgili alanlarla birlikte çalışır.

1. Kuika (Genel Şablon)

  • Basit bir e-posta içeriği oluşturmak için kullanılır. Şirket duyuruları, bilgilendirmeler veya kullanıcıya genel mesajlar göndermek için idealdir.
  • Parametreler:
    • Receivers: E-posta alıcıları
    • Subject: E-posta başlığı

2. Reset Password (Şifre Sıfırlama)

  • Kullanıcının parolasını sıfırlaması gereken durumlar için kullanılır. Genellikle "Şifremi Unuttum" işlemleri sonrası tetiklenir. E-posta içinde bir bağlantı veya doğrulama kodu yer alabilir.
  • Parametreler:
    • Receivers: Şifre sıfırlama talebinde bulunan kullanıcının e-posta adresi
    • Subject: Şifre sıfırlama mesaj başlığı
    • Verification Code: Kullanıcıya gönderilecek doğrulama kodu (isteğe bağlı olarak linkle birleştirilebilir)

3. Set Password (Parola Ayarlama)

  • Yeni kullanıcı oluşturma ya da davet gönderme senaryolarında, kullanıcıya ilk defa şifre belirlemesi için gönderilen e-postadır.
  • Parametreler:
    • Receivers: E-posta gönderilecek kullanıcı
    • Subject: E-posta başlığı
    • Verification Code: Parola belirleme işlemini başlatacak doğrulama kodu
    • User Name: E-postada gösterilecek kullanıcı adı

4. Task Notification (Görev Bildirimi)

  • İş akışı içerisinde bir kullanıcıya görev atandığında veya görevi tamamlaması beklendiğinde gönderilen sistem bildirimidir. E-posta içerisinde göreve ait bağlantı da yer alabilir.
  • Parametreler:
    • Receivers: Görev bildirimi alacak kullanıcılar
    • Subject: E-posta başlığı
    • Process Definition: Bildirimin ait olduğu iş süreci adı
    • Task Definition: Görev tipi veya tanımı
    • Task Link: Görev detayına yönlendiren bağlantı adresi

5. Verify Email (E-posta Doğrulama)

  • Kullanıcının e-posta adresini doğrulamak için kullanılır. Genellikle kayıt sonrası veya e-posta güncellemesi gibi durumlarda tercih edilir.
  • Parametreler:
    • Receivers: Doğrulama yapılacak e-posta adresi
    • Subject: Doğrulama e-postasının başlığı
    • Verification Code: E-postada gösterilecek doğrulama kodu

Bu şablonlar sayesinde Kuika kullanıcıları, sık karşılaşılan e-posta senaryolarında hem hız kazanır hem de hatasız ve tutarlı mesajlar iletebilir. Ayrıca şablonlara dinamik veri bağlamaları yapılabildiği için kişiselleştirilmiş ve otomatikleştirilmiş iletiler oluşturmak da mümkündür.

+ ADD OPTIONAL PARAMETER ile Eklenebilecek Parametreler:

  • Sender: E-postayı gönderen kullanıcı veya sistem adı.
  • CC: E-posta alıcılarının kopyalanacağı adresler.
  • BCC: Gizli alıcılar.
  • File Attachment: Eklenecek dosyanın adı.
  • Language: E-postanın gönderileceği dil (örn. "en", "tr").

Tüm parametreler, Symbol Picker aracılığıyla Action Result, Method Input, Current, Screen Input, Fixed, veya Component kaynaklarından bağlanabilir.

Dönüş Değeri (SendMailResult)

Send Mail aksiyonu, gönderim sonucunu artık tekil bir Boolean (başarılı/başarısız) olarak değil, gönderime dair detaylı bilgi içeren SendMailResult adlı bir DTO (Data Transfer Object) olarak döndürür. Bu sayede aksiyonun devamında, gönderim sonucuna göre daha ayrıntılı koşullar kurulabilir, loglama yapılabilir veya kullanıcıya özelleştirilmiş geri bildirim gösterilebilir.

SendMailResult içeriği:

  • success (Boolean): Mailin başarıyla gönderilip gönderilmediğini belirtir.
  • status (String): Gönderim durumuna ait detaylı açıklama veya durum kodu sunar.
  • provider (String): Mailin hangi mail sağlayıcısı (SMTP servisi) üzerinden gönderildiğini belirtir.
  • messageId (String): Gönderilen maile ait benzersiz mesaj kimliğidir; izleme ve loglama amacıyla kullanılabilir.
  • sizeBytes (Number): Gönderilen mailin boyutunu byte cinsinden belirtir.
  • receivers (Array): Mailin gönderildiği alıcı listesini içerir.

Dönen bu değerlere, aksiyonun ardından Symbol Picker → Action Result üzerinden erişilebilir. Örneğin, gönderim başarısız olduğunda kullanıcıya bir hata mesajı göstermek için SendEmailResult.success alanı bir koşulda kullanılabilir.