API'ye genel bakış

RealSender, API (Uygulama Programlama Arayüzü) aracılığıyla e-posta mesajları göndermenizi sağlar.

Bu sayede e-postaları SMTP (Basit Posta Transfer Protokolü) üzerinden geçirmeden doğrudan uygulamanızdan gönderebilirsiniz. Şu anda yalnızca POST isteklerini.

Sunucu adresi:
https://rsXXX-api.realsender.com/mail/send

Gerekli/zorunlu parametreler:

Her şey yolunda ise mesaj gönderilecek ve olumlu bir JSON yanıtı alacaksınız:
{"success":true}

Hata oluşması durumunda şöyle bir şey alacaksınız:
{"success":false,"errorMsgs":["Lütfen 'subject' değerini belirtin."]}

API detayları

E-posta içeriği UTF-8 uluslararası karakter seti kullanılarak gönderilmelidir .
Bunu test etmek için, konu kısmına “€uro” ekleyin ve gönderin. Karakter seti yanlışsa, şu JSON uyarısını alacaksınız:

{"success":false,"errorMsgs":["'Konu' değeri doğru şekilde kodlanmamış. UTF-8 olarak kodlanmalıdır."]}

"Metin" ve "HTML" alanlarından birini veya her ikisini de doldurmanıza bağlı olarak, mesajlar şu "Content-Type" seçeneklerinden biri kullanılarak gönderilecektir:

Zorunlu olmayan/isteğe bağlı parametreler:

"Kime", "cc" ve "bcc" değerleri tek bir e-posta adresi veya virgülle ayrılmış bir e-posta adresi listesi içerebilir .
!! RealSender'da her bir e-posta için toplam alıcı sayısı 25 ile sınırlıdır (100'e kadar artırılabilir).

Sunucunun yanıtları JSON (JavaScript Object Notation) formatındadır:

API örnekleri

PHP ile CURL kullanmadan
POST isteği gönderme yöntemi

<?php $url = 'https://rsXXX-api.realsender.com/mail/send'; $data = array('apiuser' =>'size verdiğimiz', 'apipass' => 'size verdiğimiz', 'from' => 'sender@example.com', 'to' => 'recipient@example.com', 'subject' => 'mesajın konusu', 'text' => 'e-posta gövdesi düz metin olarak', 'html' => 'e-posta gövdesi HTML formatında'); // İsteği https://... adresine gönderseniz bile 'http' anahtarını kullanın $options = array( 'http' => array( 'header' => "Content-type: application/x-www-form-urlencoded\r\n", 'method' => 'POST', 'content' => http_build_query($data), ), ); $context = stream_context_create($options); $result = file_get_contents($url, false, $context); var_dump($result); ?>

POST isteği
CURL yöntemi

curl -d 'apiuser=size verdiğimiz şifre&apipass=size verdiğimiz şifre&from=sender@example.com&to=recipient@example.com&subject=mesajın konusu&text=e-posta gövdesi düz metin olarak&html=e-posta gövdesi HTML formatında'https://rsXXX-api.realsender.com/mail/send

Ekli API örnekleri

Ekli dosyalarla (en fazla 5: attach1, attach2, …) POST isteği,
PHP ile CURL gerektirmeyen yöntem.

<?php require_once 'HTTP/Request2.php'; $config = array('use_brackets' =>false, ); $request = new HTTP_Request2('https://rsXXX-api.realsender.com/mail/send', HTTP_Request2::METHOD_POST, $config); $data = array('apiuser' => 'size verdiğimiz kullanıcı adı', 'apipass' => 'size verdiğimiz kullanıcı adı', 'from' => 'sender@example.com', 'to' => 'recipient@example.com', 'subject' => 'mesajın konusu', 'text' => 'e-posta gövdesi düz metin olarak', 'html' => 'e-posta gövdesi HTML formatında'); foreach ($data as $k => $d) { $request->addPostParameter($k, $d); }; $request->addUpload('attach1', './sample.pdf', 'sample.pdf', 'application/pdf'); $request->addUpload('attach2', './sample.txt', 'sample.txt', 'text/plain'); $result = $request->send(); var_dump($result); ?>

Ekli dosyalarla POST isteği
CURL yöntemi

curl -F 'apiuser=size verdiğimiz şifre' \ -F 'apipass=size verdiğimiz şifre' \ -F 'from=sender@example.com' \ -F 'to=recipient@example.com' \ -F 'subject=mesajın konusu' \ -F 'text=e-posta gövdesi düz metin olarak' \ -F 'html=e-posta gövdesi HTML formatında' \ -F 'attach=@sample.pdf;type=application/pdf' \ -F 'attach=@sample.txt;type=text/plain' \ https://rsXXX-api.realsender.com/mail/send

genel bakış

RealSender, web form içerikleri gibi HTTP isteklerini e-posta yoluyla kolayca göndermenizi sağlar.
Bu sayede geri bildirim formlarınızın sonuçlarını doğrudan posta kutunuza alabilirsiniz.

Sizin tarafınızdan herhangi bir özel yapılandırmaya gerek yok.
Formlar herhangi bir HTML web sayfasında yayınlanabilir veya doğrudan e-posta mesajlarınıza eklenebilir.

Komut dosyasının adresi:
<form action="https://rsXXX.realsender.com/script/form.pl" method="post" accept-charset="utf-8">

Gerekli/zorunlu parametreler (gizli alanlar):

Gerekli/zorunlu parametreler (gizli olmayan alanlar):

detaylar

Zorunlu olmayan/isteğe bağlı parametreler (gizli alanlar):

Zorunlu olmayan/isteğe bağlı parametreler (gizli olmayan alanlar):

Form gönderimi için kullanılacak kodlama, UTF-8 uluslararası karakter setidir.
Bunu test etmek için, alanlarınızdan herhangi birine "€uro" ekleyin, formu gönderin ve alacağınız e-posta mesajını kontrol edin.

web formu örneği

Bu , "gerçekad" ve "notlar" olmak üzere iki isteğe bağlı parametreye sahip
basit bir HTML web formu örneğidir

<form action="https://rsXXX.realsender.com/script/form.pl" method="post" accept-charset="utf-8"><input type="hidden" name="recipient" value="email_address-or-alias" /><input type="hidden" name="required" value="email" /><input type="hidden" name="redirect" value="/form/thankyou.html" /><input type="hidden" name="missing_fields_redirect" value="/form/error.html" /> İsim:<br /><input name="realname" /><br /> E-posta:<br /><input name="email" /><br /> Notlar:<br /><textarea cols="40" rows="2" name="notes"></textarea><br /><input type="submit" /></form>

“Yönlendirme” ve “eksik_alanlar_yönlendirme” açılış sayfaları sunucunuzda yer alabilir.
İstediğiniz kadar alan ekleyebilirsiniz, sunucu düzeyinde herhangi bir kurulum gerekmez.

SMS'ten HTTP'ye örnek

SMS mesajlarını doğrudan posta kutunuza almak için
"SMS'i HTTP Yapılandırmasına Yönlendirme" seçeneğini sunar.

Bunu Teltonika Web arayüzünde bulabilirsiniz: Hizmetler > Mobil Araçlar > SMS Ağ Geçidi.
!! Alıcının alan adı (yourdomain.com) RealSender tarafından önceden yetkilendirilmiş olmalıdır !!

Sayısal değer adı: e-posta Yöntem: POST URL: https://rsXXX.realsender.com/script/sms.pl Mesaj değeri adı: mesaj Ek veri çifti 1: alıcı | name@yourdomain.com Ek veri çifti 2: konu | Metin Mesajı

Seçenek 1 - Mobil Veri Kullanımı

!! RealSender'ın düzgün çalışması için 4G (LTE) bağlantısı gereklidir !!
Bunu Teltonika Web arayüzünden şu şekilde ayarlayabilirsiniz: Ağ > Mobil > SIM kart ayarları

Ağ türü: Yalnızca 4G (LTE)

Seçenek 2 - LAN AĞ GEÇİDİ VERİLERİNİ KULLANMA

İnternet ağ geçidini yerel ağınız (LAN) üzerinden geçecek şekilde ayarlayabilirsiniz.
Teltonika Web arayüzü: Ağ > LAN > AĞ ARAYÜZLERİ > [düzenle]

IPv4 ağ geçidini ve DNS sunucularını
(kendi parametrelerinizle değiştirin):

ARAYÜZLER: LAN ... IPv4 ağ geçidi: 192.168.1.1 DNS sunucuları: 8.8.8.8 !! zorunlu !!

Mobil veri bağlantısı birkaç şekilde devre dışı bırakılabilir, bkz: Mobil Veriyi Devre Dışı Bırakma.
Mobil veri devre dışı bırakıldığında, SMS mesajlaşması çalışmaya devam eder.

Mobil veriyi devre dışı bırakmanın en kolay yolu , cep telefonu numarasına kısa mesaj göndermektir :<router_password> mobileoff
Aynı şekilde, "status" komutunu kullanarak değişiklikleri kontrol edebilirsiniz:<router_password> status

Alınan e-posta mesajına örnek

Konu: Kısa Mesaj (+41790000000) Aşağıda alınan kısa mesaj bulunmaktadır. Bu mesaj, (+41790000000) tarafından 26 Haziran 2023 Pazartesi günü 08:31:29 CEST tarihinde gönderilmiştir. ---------------------------------------------------------------------------- Test Mesajı --------------------------------------------------------------------------

Google haber uyarıları

Google Haberler, Google tarafından geliştirilen ve sürdürülen bir haber toplama hizmetidir.
Binlerce yayıncı ve dergiden derlenen makalelere sürekli bir bağlantı akışı sunar.
Hizmet 60'tan fazla ülkede ve 35'ten fazla dilde sunulmaktadır.

Google Haberler web sitesi , bulunduğu ülkedeki büyük çevrimiçi gazetelerden
otomatik olarak haber listesi oluşturur
ve bunları benzer içeriklere göre gruplandırarak konu ve makale yayın tarihine göre sıralar.
Haberler her zaman kısa özetler halinde yayınlanır.

Emailconnect uygulaması için "Google Haberler uyarıları" akışı,
RSS akışını çıkarır ve
istenen aralıkta, belirli bir konu hakkında, ilgili alıcıya e-posta bildirimleri gönderir:

Akışı kopyalayın, ilk ve son düğümü düzenleyin; böylece
farklı konular için birden fazla alıcıya gönderilen birden fazla uyarıya sahip olacaksınız.

Son 24 saat içinde herhangi bir haber yoksa, mesaj gönderilmeyecektir.
"İlk konu"nun solundaki düğme, mesajın manuel olarak gönderilmesini zorlamanıza olanak tanır.

SMTP durum kontrolü

SMTP durum kontrolü, posta sunucunuzun kullanılabilirliğini, güvenliğini ve işlevselliğini doğrular.
Sunucunun TCP bağlantılarını kabul ettiğinden, doğru şekilde kimlik doğrulaması yaptığından ve e-postaları işlediğinden emin olur.

Kontrol işlemi, her on dakikada bir düzenli aralıklarla çalışacak şekilde yapılandırılmıştır.
Kullanıcı, önceden tanımlanmış aralığı kendisi değiştirebilir.

EmailConnect uygulamasındaki "SMTP durum kontrolü" akışı,
gerçek mesajlar göndererek SMTP hizmetinin düzgün çalıştığını doğrular;
sistem yalnızca bir arıza durumunda uyarı e-postası gönderir:

Akışı kopyalayın, ilk ve son düğümü düzenleyin; böylece
farklı SMTP sunucuları için istediğiniz alıcılara gönderilecek birden fazla uyarıya sahip olacaksınız.

Kullanıcı adı ve parola sistem düzeyinde "ortam değişkenleri" olarak ayarlanır, kullanıcı bunları okuyamaz.
İlk "şirket adı" düğümünün solundaki düğme, manuel olarak çalıştırmayı zorlamanıza
ve sonucu ekranın sağ tarafındaki hata ayıklama alanında görmenize olanak tanır:

web sitesi durum kontrolü

Web sitesi durum kontrolü, web sitenizin kullanılabilirliğini, SSL güvenliğini ve işlevselliğini doğrular.
Web sunucunuzun çalışmasını, SSL sertifikalarının geçerliliğini ve web sayfasının yanıt vermesini izler.

Kontrol işlemi, her on dakikada bir düzenli aralıklarla çalışacak şekilde yapılandırılmıştır.
Kullanıcı, önceden tanımlanmış aralığı kendisi değiştirebilir.

Emailconnect uygulamasının "web sitesi durum kontrolü" akışı,
sitenin adresine bir HTTP isteği gönderir ve yanıtı analiz eder;
yalnızca bir arıza durumunda sistem bir uyarı e-postası gönderir:

Akışı kopyalayın, ilk ve son düğümü düzenleyin; böylece
farklı web siteleri için istediğiniz alıcılara gönderilecek birden fazla uyarıya sahip olacaksınız.

İlk https://example.com düğümünün solundaki düğme, çalıştırmayı manuel olarak zorlamanıza
ve sonucu ekranın sağ tarafındaki hata ayıklama alanında görmenize olanak tanır:

SMTP sunucuları için ters proxy

Başlıca Faydaları:

• Güvenlik açısından, kötü amaçlı istekleri engelleyebilir, trafiği şifreleyebilir
  ve arka uç sunucularını doğrudan saldırılardan koruyabilir.
• Performans: Gelen trafiği birden fazla sunucuya dağıtarak
  tek bir sunucunun aşırı yüklenmesini önler ve daha yüksek kullanılabilirlik sağlar.
• Ölçeklenebilirlik: Hizmet kesintisi olmadan arka uç sunucuları eklemenize veya kaldırmanıza olanak tanıyarak
  artan trafiği yönetme yeteneği sunar.

sertifikalı e-posta ağ geçidi

Onaylı Elektronik Posta, bir mesajın gönderildiğini ve teslim edildiğini onaylayabilen ve üçüncü taraflara karşı kullanılabilecek makbuzlar sağlayabilen bir e-posta türüdür.

Onaylı e-posta yoluyla e-posta mesajları göndermeyi sağlayan, ayrıca birleştirilebilen üç çalışma modu bulunmaktadır:

• Önceden tanımlanmış alan adı uzantılarına sahip alıcılar (örneğin, pec.it, legalmail.it, pec.poste.it)
• “.xx” uzantılı (örneğin, domainname.com.xx) hedef e-posta adreslerinde,
  “.xx” uzantısı otomatik olarak kaldırılır.
• belirli göndericiler (örneğin, invoices@…)

Bu e-posta mesajları, müşterinin onaylı e-posta SMTP hizmetiyle (örneğin Aruba, Legalmail, Register gibi) kimliğini doğrulayan başka bir sunucuya iletilir.

Gönderen adresi otomatik olarak müşterinin onaylı e-posta adresine değiştirilir.

Gönderilmeyen mesajlar (örneğin, kullanıcı bilinmiyor/posta kutusu dolu) gönderen olarak belirtilen onaylı e-posta adresine gönderilecektir.

Yanlış veya artık geçerli olmayan e-posta adresleri, alıcının e-posta kutusundaki spam korumasını tetikleyebileceğinden, daha fazla gönderimi önlemek için manuel olarak düzeltilmeli veya silinmelidir.

tek satırlı metin e-postaları

"Plainmail" uygulaması e-postalarınızı tek satırlık metne indirgiyor,
e-posta eklerini ortadan kaldırıyor ve bunun yerine bağlantılar gönderiyor:

• E-postalarınızı sıkıştırın
• E-posta eklerini bağlantılara dönüştürün

E-postalarınızı sıkıştırın

Alıcıların e-posta alan adına “.plain” eklemeniz yeterlidir;
yalnızca konu başlığını alacaklardır:

Alıcı: email@example.com.plain Konu: kısa mesajınız, emojiler kullanılabilir

Ek e-posta içeriği ve ekleri dikkate alınmayacak,
bunların yerine aşağıdaki mesaj görünecektir:

< PlainMail > Konu satırı hariç tüm içerik silindi.

» başa dön

E-posta eklerini bağlantılara dönüştürün

Konu kısmına “[A]” yazmanız ve e-postaya bir dosya eklemeniz yeterli.
“Plainmail” uygulaması bunu otomatik olarak bir bağlantıya dönüştürecektir.

Bağlantıdaki alan adı, kullanmak istediğiniz herhangi bir özel alan adı veya alt alan adı olabilir.
Dosya altı ay sonra SİLİNECEKTİR.

» başa dön

NTfy uygulamasına gelen bildirimler

NTfy nedir?

ntfy (okunuşu “notify”), “yayınla-abone ol” prensibiyle çalışan bir bildirim hizmetidir; bir “konuya” mesaj gönderirsiniz. ntfy uygulamasını çalıştıran ve aynı konuya abone olan bir akıllı telefon veya bilgisayar, mesajı gerçek zamanlı anlık bildirim olarak alır.

Bu, komut dosyaları, sunucular veya diğer herhangi bir hizmet tarafından oluşturulan anlık uyarıların iletilmesini sağlayarak kullanıcıların karmaşık yapılandırmalara gerek kalmadan bildirim almalarına olanak tanır.

RealSender ile nasıl çalışır:

• Yayıncılar:
  Belirli bir adrese e-posta göndererek bir konu hakkında mesaj yayınlayabilirsiniz. Örneğin, topic@ntfy.youremaildomain.com.
  Mesaj içeriği, e-posta konusuyla eşleşir.
  Bu adrese yalnızca RealSender kullanıcılarının e-posta gönderme yetkisi vardır.

• Aboneler:
  NTfy uygulamasını yükledikleri ve abone oldukları konu hakkında
  bildirimleri akıllı telefonları veya bilgisayarları üzerinden alırlar.

• Konular:
  Konuları, benzersiz adlara ve içlerinde yayınlanan olay akışlarına sahip kanallar olarak düşünün.
  Konuları açıkça oluşturmanıza gerek yok; sadece bir ad seçin ve kullanın.
  Konu adları herkese açık olduğundan, kolayca tahmin edilemeyecek bir şey seçmek akıllıca olur.

E-posta gönderildikten sonra, NTfy sunucusu mesajı alır ve ilgili konunun aboneleri için saklar.
Abone (NTfy uygulaması aracılığıyla) konuya bağlanır ve mesajı gerçek zamanlı olarak alır.

Bu bir "bağımsız sistem"; yayıncıların abonelerini tanımasına gerek yok ve bunun tersi de geçerli.
Bu durum, hem yayıncı hem de abone için kullanımını ve yönetimini basitleştiriyor.

» başa dön

E-posta eklerini bağlantılara dönüştürün

Konu kısmına “[A]” yazmanız ve e-postaya bir dosya eklemeniz yeterli.
“Plainmail” uygulaması bunu otomatik olarak bir bağlantıya dönüştürecektir.

Bağlantıdaki alan adı, kullanmak istediğiniz herhangi bir özel alan adı veya alt alan adı olabilir.
Dosya altı ay sonra SİLİNECEKTİR.

» başa dön

cep telefonu numaralarına gönderilen mesajlar

E-postalarınızı mobil dünyaya bağlayın,
iş alışkanlıklarınızı değiştirmeden
iş iletişimi fırsatlarınızı en üst düzeye çıkarın :

• E-postanızdan kısa mesaj gönderin
• E-postanıza kısa mesajlar alın
• E-postanızdan gelen metin mesajlarına yanıt verin
• E-posta eklerini bağlantılara dönüştürün

E-postanızdan kısa mesaj gönderin

Anlık bildirimler, müşterilerinize hızlı bir şekilde ulaşmanın en etkili yoludur.
Çok yüksek açılma oranları (%95'e varan) ve en yüksek yanıt oranları (%45'e varan) ile öne çıkar.
– Kaynak: Gartner'ın 2019 yılı SMS araştırmasına göre.

Alıcı: mobilenumber@text.yourdomain.com Konu: metin mesajı içeriği, emojiler kullanılabilir (ek e-posta içeriği ve ekler dikkate alınmaz)

Size mobil operatörünüz için önceden yapılandırılmış bir endüstriyel yönlendirici sağlayacağız.

Kısa mesajların gönderilmesi ve iletilmesi üzerindeki kontrol, kullanılan operatör aracılığıyla gerçekleştirilmelidir.
Sistemimiz, yönlendiricinin yanıt verip vermediğini (güç ve internet bağlantısını kontrol ederek) her on dakikada bir kontrol eder.

Kötüye kullanımları önlemek için, mesajlar RealSender üzerinden, önceden yetkilendirilmiş göndericiler kullanılarak ve SPF ile DKIM "sıkı" uyumluluğuyla . E-posta kimlik doğrulaması hakkında daha fazla bilgi edinin - gelişmiş .
gönderilmelidir

» başa dön

E-postanıza kısa mesajlar alın

Kısa mesaj yanıtları, tercih ettiğiniz posta kutusuna aşağıdaki gibi bir e-posta mesajıyla
doğrudan iletilecektir :

Konu: Kısa Mesaj (+41790000000) Aşağıda alınan kısa mesaj bulunmaktadır. Bu mesaj, (+41790000000) tarafından 29 Temmuz 2025 Pazartesi günü saat 10:57:00 CEST'te gönderilmiştir. ---------------------------------------------------------------------------- Test Mesajı --------------------------------------------------------------------------

» başa dön

E-postanızdan gelen metin mesajlarına yanıt verin

RealSender'ın "plainmail" uygulaması, e-postanızdan doğrudan kısa mesaj göndermenizi sağlar.

Böylece en sevdiğiniz e-posta uygulamasından yanıt verebilirsiniz.
Alıcı adresi zaten orijinal gönderenin numarasıyla doldurulmuştur:

Alıcı: mobilenumber@text.yourdomain.com Konu: Yanıtın içeriği (ek e-posta içeriği ve ekler dikkate alınmaz)

Bu sayede e-posta uygulaması ile mobil cihaz arasındaki iletişim devam edebilir.

» başa dön

E-posta eklerini bağlantılara dönüştürün

Konu kısmına “[A]” yazmanız ve e-postaya bir dosya eklemeniz yeterli.
“Plainmail” uygulaması bunu otomatik olarak bir bağlantıya dönüştürecektir.

Bağlantıdaki alan adı, kullanmak istediğiniz herhangi bir özel alan adı veya alt alan adı olabilir.
Dosya altı ay sonra otomatik olarak silinecektir.

» başa dön