Otomasyon - Özel SMTP ile E-Posta Gönderimi (sendWithSMTP)

1-) Özel SMTP Kurulumu ve JS Fonksiyonları

Bu bölüm, Supsis Ai Otomasyon modülündeki JavaScript bloğu (Run JavaScript) içerisine eklenen yeni supsis.email.sendWithSMTP(...) fonksiyonunun kullanımını içerir. Supsis'in kendi mail altyapısını (AWS SES) kullanmak yerine e-postaları doğrudan kendi kurumsal SMTP sunucularınız üzerinden göndermek istediğiniz durumlarda bu fonksiyonu kullanabilirsiniz. İsteğe bağlı olarak, gönderilen e-postaların bir kopyasını Supsis sisteminde de kayıt altında tutabilirsiniz.

1.a – Otomasyon Editörü ve Autocomplete Desteği

Otomasyon sayfanızda bir kod bloğu (JavaScript) açtığınızda sistem size yazım kolaylığı sağlar.

  • a – Otomatik Tamamlama (Autocomplete):
    Kod editörüne supsis.email. yazmaya başladığınızda açılan listeden sendWithSMTP seçeneği otomatik olarak önerilir. Bu sayede tüm parametrelerin şablonu hızlıca editöre eklenir.

1.b – Kod Yapısı ve SMTP Parametreleri

sendWithSMTP fonksiyonu, mailin kimden, kime ve hangi sunucu üzerinden gideceğini belirleyen belirli parametrelere ihtiyaç duyar.

  • b – SMTP Bağlantı Bilgileri (smtp):
    E-postanın çıkış yapacağı sunucu ayarlarıdır. host, port (varsayılan 587), secure (port 465 ise true), user ve pass değerleri zorunludur.
  • c – Gönderim ve İçerik Parametreleri:
  • from: Gerçek gönderen adresidir (Zorunlu).
  • to: Alıcı e-posta adresidir (Zorunlu).
  • subject & content: E-postanın konusu ve HTML içeriğidir (Zorunlu).
  • Opsiyonel Alanlar: senderName (Gönderen adı), replyTo, cc, bcc ve hazır şablon kullanımı için templateId / templateParams.

1.c – Supsis'te Kopya Saklama (saveToSupsis)

Kendi sunucunuzdan giden maillerin takibini Supsis üzerinden de yapmak isterseniz kopya saklama özelliğini aktif edebilirsiniz.

  • saveToSupsis: true: E-postanın bir kopyasının Supsis Mail ekranına da düşmesini sağlar. Bu durumda fonksiyon başarılı olursa fazladan bir emailId değeri döner.
  • supsisFrom: Yalnızca Supsis panelinde tutulan kopyada "gönderen" olarak görünmesini istediğiniz adrestir. (Örn: Gerçekte no-reply@ adresinden giden bir mailin, Supsis panelinde destek ekibi görsün diye destek@ adresinden gitmiş gibi listelenmesini sağlar).

Örnek Kod Kullanımı:

const result = await supsis.email.sendWithSMTP({
  smtp: { host: "smtp.sirket.com", port: 587, secure: false, user: "kullanici@sirket.com", pass: "smtp-sifresi" },
  from: "no-reply@sirket.com",
  to: "musteri@ornek.com",
  subject: "Hoşgeldiniz!",
  content: "Merhaba, kaydınız başarıyla oluşturuldu.",
  senderName: "Şirket Destek",
  saveToSupsis: true,
  supsisFrom: "destek@sirket.com"
});

return { success: result.success, messageId: result.messageId, emailId: result.emailId };

1.d – Örnek Kullanım Senaryoları

Özel SMTP fonksiyonu ile iş süreçlerinizi iyileştirecek bazı senaryolar şunlardır:

  • Marka İtibarı ve Özel Altyapı: Supsis AWS SES altyapısı yerine doğrudan kendi şirket domaininizin IP'leri üzerinden gönderim yaparak teslimat (deliverability) ve marka tutarlılığını en üst düzeye çıkarabilirsiniz.
  • Gölge (Shadow) Mail Yönetimi: Müşteriye faturayı muhasebe yazılımı (kendi SMTP'niz) üzerinden gönderirken, müşteri temsilcilerinizin konudan haberdar olması için mailin kopyasını supsisFrom yönlendirmesiyle Supsis gelen kutusuna kaydedebilirsiniz.
  • Otomatik Şablon Kullanımı: Otomasyon içerisinde templateId (şablon ID) çağırarak kişiselleştirilmiş toplu veya tekil bilgilendirme maillerini kendi sunucunuzdan güvenle çıkabilirsiniz.