API-Übersicht

Mit RealSender können Sie E-Mail-Nachrichten über eine API (Programmierschnittstelle) versenden.

So können Sie E-Mails direkt aus Ihrer Anwendung versenden, ohne den Umweg über SMTP (Simple Mail Transfer Protocol). Aktuell unterstützen wir nur POST-Anfragen.

Serveradresse:
https://rsXXX-api.realsender.com/mail/send

Erforderliche/obligatorische Parameter:

Wenn alles in Ordnung ist, wird die Nachricht gesendet und Sie erhalten eine positive JSON-Antwort:
{"success":true}

Im Fehlerfall erhalten Sie eine Fehlermeldung wie diese:
{"success":false,"errorMsgs":["Bitte geben Sie den Wert für 'subject' an."]}

API-Details

Der Inhalt muss im internationalen Zeichensatz UTF-8.
Um dies zu testen, fügen Sie „€uro“ in den Betreff ein und senden Sie die E-Mail ab. Bei einem falschen Zeichensatz erhalten Sie folgende JSON-Warnung:

{"success":false,"errorMsgs":["Der Wert 'subject' ist nicht korrekt kodiert. Er muss UTF-8-kodiert sein."]}

Je nachdem, ob Sie eines oder beide Felder „text“ und/oder „html“ ausgefüllt haben, werden die Nachrichten mit einem der folgenden „Content-Type“-Typen gesendet:

Nicht erforderliche/optionale Parameter:

Die Felder „An“, „Cc“ und „Bcc“ können entweder eine einzelne E-Mail-Adresse oder eine durch Kommas getrennte Liste von E-Mail-Adressen.
!! Bei RealSender ist die Gesamtzahl der Empfänger pro E-Mail auf 25 begrenzt (sie kann auf bis zu 100 erhöht werden).

Die Serverantworten erfolgen im JSON-Format (JavaScript Object Notation):

API-Beispiele

POST-Anfrage
ohne cURL mit PHP

<?php $url = 'https://rsXXX-api.realsender.com/mail/send'; $data = array('apiuser' =>'die von uns bereitgestellte', 'apipass' => 'die von uns bereitgestellte', 'from' => 'sender@example.com', 'to' => 'recipient@example.com', 'subject' => 'Betreff der Nachricht', 'text' => 'E-Mail-Text im Klartext', 'html' => 'E-Mail-Text im HTML-Format'); // Verwenden Sie den Schlüssel 'http', auch wenn Sie die Anfrage an https:// senden... $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-Anfrage
CURL-Methode

curl -d 'apiuser=der von uns bereitgestellte Benutzername&apipass=der von uns bereitgestellte Benutzername&from=sender@example.com&to=recipient@example.com&subject=Betreff der Nachricht&text=E-Mail-Text im Klartext&html=E-Mail-Text im HTML-Format'https://rsXXX-api.realsender.com/mail/send

API-Beispiele mit Anhängen

POST-Anfrage mit Anhängen (max. 5: attach1, attach2, …) –
Methode ohne CURL mit PHP

<?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' => 'der von uns bereitgestellte Benutzername', 'apipass' => 'das von uns bereitgestellte Passwort', 'from' => 'sender@example.com', 'to' => 'recipient@example.com', 'subject' => 'Betreff der Nachricht', 'text' => 'E-Mail-Text im Klartext', 'html' => 'E-Mail-Text im HTML-Format'); 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); ?>

POST-Anfrage mit Anhängen
CURL-Methode

curl -F 'apiuser=die von uns bereitgestellte API-ID' \ -F 'apipass=die von uns bereitgestellte API-ID' \ -F 'from=sender@example.com' \ -F 'to=recipient@example.com' \ -F 'subject=Betreff der Nachricht' \ -F 'text=E-Mail-Text im Klartext' \ -F 'html=E-Mail-Text im HTML-Format' \ -F 'attach=@sample.pdf;type=application/pdf' \ -F 'attach=@sample.txt;type=text/plain' \ https://rsXXX-api.realsender.com/mail/send

Überblick

Mit RealSender können Sie HTTP-Anfragen, wie beispielsweise Inhalte von Webformularen, einfach per E-Mail senden.
So erhalten Sie die Ergebnisse Ihrer Feedback-Formulare direkt in Ihr Postfach.

Sie müssen keine speziellen Einstellungen vornehmen.
Die Formulare können auf jeder HTML-Webseite veröffentlicht oder direkt in Ihre E-Mails eingefügt werden.

Skriptadresse:
<form action="https://rsXXX.realsender.com/script/form.pl" method="post" accept-charset="utf-8">

Erforderliche/obligatorische Parameter (versteckte Felder):

Erforderliche/obligatorische Parameter (nicht versteckte Felder):

Details

Nicht erforderliche/optionale Parameter (versteckte Felder):

Nicht erforderliche/optionale Parameter (nicht versteckte Felder):

Für die Formularübermittlung wird die internationale Zeichenkodierung UTF-8 verwendet.
Um dies zu testen, fügen Sie „€uro“ in ein beliebiges Feld ein, senden Sie das Formular ab und überprüfen Sie die E-Mail-Bestätigung.

Beispiel für ein Webformular

Dies ist ein einfaches HTML-Webformularbeispiel
mit zwei optionalen Parametern: „realname“ und „notes“.

<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" /> Name:<br /><input name="realname" /><br /> E-Mail:<br /><input name="email" /><br /> Anmerkungen:<br /><textarea cols="40" rows="2" name="notes"></textarea><br /><input type="submit" /></form>

Die Landingpages „redirect“ und „missing_fields_redirect“ können auf Ihrem Server gehostet werden.
Sie können beliebig viele Felder hinzufügen; serverseitig ist keine Konfiguration erforderlich.

SMS zu HTTP-Beispiel

Um SMS-Nachrichten direkt in Ihrem Postfach zu empfangen,
bieten Teltonika-Router die Option „SMS-Weiterleitung an HTTP-Konfiguration“ an.

Sie finden es in der Teltonika-Weboberfläche: Dienste > Mobile Utilities > SMS-Gateway.
!! Die Empfängerdomäne (yourdomain.com) muss von RealSender vorautorisiert werden !!

Name des Zahlenwerts: E-Mail Methode: POST URL: https://rsXXX.realsender.com/script/sms.pl Name des Nachrichtenwerts: Nachricht Zusätzliches Datenpaar 1: Empfänger | name@yourdomain.com Zusätzliches Datenpaar 2: Betreff | SMS

Option 1 – Nutzung mobiler Daten

Für die einwandfreie Funktion von RealSender ist eine 4G-Verbindung (LTE) erforderlich.
Sie können diese in der Teltonika-Weboberfläche einrichten: Netzwerk > Mobilfunk > SIM-Karteneinstellungen

Netzwerktyp: Nur 4G (LTE)

Option 2 – Verwendung von LAN-Gateway-Daten

Sie können das Internet-Gateway so konfigurieren, dass es über Ihr LAN läuft.
Teltonika WebUI: Netzwerk > LAN > Netzwerkschnittstellen > [Bearbeiten]

Konfigurieren Sie einfach das IPv4-Gateway und die DNS-Server.
Siehe das folgende Beispiel (passen Sie es mit Ihren eigenen Parametern an):

Schnittstellen: LAN ... IPv4-Gateway: 192.168.1.1 DNS-Server: 8.8.8.8 !! erforderlich !!

Die mobile Datenverbindung kann auf verschiedene Arten deaktiviert werden, siehe: Mobile Daten deaktivieren.
Wenn mobile Daten deaktiviert sind, funktioniert der SMS-Versand weiterhin.

Die einfachste Möglichkeit, mobile Daten zu deaktivieren, besteht darin, eine SMS an die Mobilnummer: <router_password> mobileoff
Die Änderungen können Sie auf die gleiche Weise mit dem Befehl „status“ überprüfen: <router_password> status

Beispiel einer empfangenen E-Mail-Nachricht

Betreff: SMS (+41790000000) Nachfolgend die empfangene SMS. Sie wurde am Montag, den 26. Juni 2023 um 08:31:29 Uhr MESZ von (+41790000000) gesendet. --------------------------------------------------------------------------- Testnachricht ---------------------------------------------------------------------------

Google News-Benachrichtigungen

Google News ist ein von Google entwickelter und betriebener Nachrichtenaggregator.
Er bietet einen kontinuierlichen Strom von Links zu Artikeln, die von Tausenden von Verlagen und Magazinen zusammengestellt werden.
Der Dienst ist in über 60 Ländern und in mehr als 35 Sprachen verfügbar.

Die Google News-Website erstellt automatisch eine Liste von Nachrichtenartikeln
aus großen Online-Zeitungen (des jeweiligen Landes)
und gruppiert diese nach inhaltlicher Ähnlichkeit, sortiert nach Thema und Veröffentlichungsdatum.
Die Nachrichten werden stets als kurze Zusammenfassungen veröffentlicht.

Der „Google News-Benachrichtigungs“-Ablauf für die Emailconnect-App
extrahiert den RSS-Feed und sendet E-Mail-Benachrichtigungen
im gewünschten Intervall zu einem bestimmten Thema an den zugehörigen Empfänger:

Duplizieren Sie einfach den Ablauf, bearbeiten Sie den ersten und letzten Knoten, und Sie erhalten
mehrere Benachrichtigungen zu verschiedenen Themen, die an mehrere Empfänger gesendet werden.

Wenn in den letzten 24 Stunden keine Neuigkeiten vorliegen, wird keine Nachricht versendet.
Mit der Schaltfläche links neben „Erstes Thema“ können Sie die Ausführung manuell erzwingen.

SMTP-Statusprüfung

Die SMTP-Statusprüfung verifiziert die Verfügbarkeit, Sicherheit und Funktionalität Ihres Mailservers.
Sie stellt sicher, dass der Server TCP-Verbindungen akzeptiert, sich ordnungsgemäß authentifiziert und E-Mails verarbeitet.

Die Überprüfung ist so konfiguriert, dass sie in regelmäßigen Abständen, alle zehn Minuten, ausgeführt wird.
Der Benutzer kann das vordefinierte Intervall selbst ändern.

Der Ablauf „SMTP-Statusprüfung“ der EmailConnect-App
überprüft die ordnungsgemäße Funktion des SMTP-Dienstes durch das Senden echter Nachrichten;
nur im Falle einer Fehlfunktion sendet das System eine Warn-E-Mail:

Duplizieren Sie einfach den Ablauf, bearbeiten Sie den ersten und letzten Knoten, und Sie erhalten
mehrere Benachrichtigungen für verschiedene SMTP-Server, die an die gewünschten Empfänger gesendet werden.

Benutzername und Passwort sind als „Umgebungsvariablen“ auf Systemebene festgelegt und können vom Benutzer nicht gelesen werden.
Mit der Schaltfläche links neben dem ersten „Firmenname“-Knoten können Sie die Ausführung manuell erzwingen
und das Ergebnis im Debug-Bereich auf der rechten Seite des Bildschirms anzeigen lassen.

Website-Statusprüfung

Die Website-Statusprüfung verifiziert die Verfügbarkeit, die SSL-Sicherheit und die Funktionalität Ihrer Website.
Sie überwacht den Betrieb Ihres Webservers, die Gültigkeit der SSL-Zertifikate und die Antwortzeit der Webseite.

Die Überprüfung ist so konfiguriert, dass sie in regelmäßigen Abständen, alle zehn Minuten, ausgeführt wird.
Der Benutzer kann das vordefinierte Intervall selbst ändern.

Der Ablauf der „Website-Statusprüfung“ der Emailconnect-App
sendet eine HTTP-Anfrage an die Adresse der Website und analysiert die Antwort;
nur im Falle einer Fehlfunktion sendet das System eine Warn-E-Mail:

Duplizieren Sie einfach den Ablauf, bearbeiten Sie den ersten und letzten Knoten, und Sie erhalten
mehrere Benachrichtigungen für verschiedene Websites, die an die gewünschten Empfänger gesendet werden.

Mit der Schaltfläche links neben dem ersten https://example.com-Knoten können Sie die Ausführung manuell erzwingen
und das Ergebnis im Debug-Bereich auf der rechten Seite des Bildschirms anzeigen lassen:

Reverse-Proxy für SMTP-Server

Wichtigste Vorteile:

• Sicherheit: Es kann bösartige Anfragen blockieren, den Datenverkehr verschlüsseln
  und Backend-Server vor direkten Angriffen schützen.
• Leistung: Der eingehende Datenverkehr wird auf mehrere Server verteilt, wodurch eine Überlastung
  einzelner Server verhindert und eine höhere Verfügbarkeit gewährleistet wird.
• Skalierbarkeit: Sie ermöglicht das Hinzufügen oder Entfernen von Backend-Servern ohne Serviceunterbrechung und
  bietet somit die Möglichkeit, wachsendes Datenaufkommen zu bewältigen.

zertifiziertes E-Mail-Gateway

Zertifizierte elektronische Post ist eine E-Mail, die den Versand und die Zustellung einer Nachricht bestätigen und Empfangsbestätigungen liefern kann, die gegenüber Dritten verwendet werden können.

Es gibt drei Betriebsmodi, die auch kombiniert werden können, um den Versand von E-Mail-Nachrichten über zertifizierte E-Mail zu ermöglichen:

• Empfänger mit vordefinierten Domänenerweiterungen (z. B. pec.it, legalmail.it, pec.poste.it)
• Bei E-Mail-Adressen mit der Endung „.xx“ (z. B. domainname.com.xx)
  wird die Endung „.xx“ automatisch entfernt.
• bestimmte Absender (z. B. invoices@…)

Diese E-Mail-Nachrichten werden an einen anderen Server übermittelt, der sich beim zertifizierten E-Mail-SMTP-Dienst des Kunden authentifiziert (z. B. Aruba, Legalmail, Register, um nur einige zu nennen).

Der Absender wird automatisch auf die zertifizierte E-Mail-Adresse des Kunden geändert.

Unzustellbare Nachrichten (z. B. Benutzer unbekannt/Postfach voll) werden an die als Absender angegebene zertifizierte E-Mail-Adresse gesendet.

Falsche oder nicht mehr gültige E-Mail-Adressen müssen manuell korrigiert oder gelöscht werden, um den weiteren Versand zu verhindern, da sie den Spamschutz in den Postfächern der Empfänger auslösen könnten.

einzeilige Text-E-Mails

Die App „plainmail“ reduziert Ihre E-Mails auf eine einzige Textzeile,
entfernt E-Mail-Anhänge und versendet stattdessen Links:

• Komprimieren Sie Ihre E-Mails
• E-Mail-Anhänge in Links umwandeln

Komprimieren Sie Ihre E-Mails

Fügen Sie einfach „.plain“ an die E-Mail-Domain der Empfänger an,
diese erhalten dann nur noch den Betreff:

Empfänger: email@example.com.plain Betreff: Ihre Kurznachricht (Emoticons sind erlaubt)

Zusätzlicher E-Mail-Inhalt und Anhänge werden ignoriert;
stattdessen wird folgende Meldung angezeigt:

< PlainMail > Sämtlicher Inhalt außer der Betreffzeile wurde entfernt.

» Zurück zum Seitenanfang

E-Mail-Anhänge in Links umwandeln

Schreiben Sie einfach „[A]“ in die Betreffzeile und fügen Sie der E-Mail einen Anhang hinzu.
Die App „plainmail“ wandelt diesen automatisch in einen Link um.

Die Domain im Link kann eine beliebige dedizierte Domain oder Subdomain sein.
Die Datei wird nach sechs Monaten gelöscht.

» Zurück zum Seitenanfang

Benachrichtigungen an die ntfy-App

Was ist ntfy?

ntfy (ausgesprochen „notify“) funktioniert als „Publish-Subscribe“-Benachrichtigungsdienst, bei dem Sie eine Nachricht an ein „Thema“ senden. Ein Smartphone oder Computer, auf dem die ntfy-App läuft und der dasselbe Thema abonniert hat, empfängt die Nachricht als Push-Benachrichtigung in Echtzeit.

Dies ermöglicht die Zustellung von Sofortbenachrichtigungen, die von Skripten, Servern oder anderen Diensten generiert werden, sodass Benutzer Benachrichtigungen ohne aufwendige Konfiguration erhalten können.

So funktioniert es mit RealSender:

• Herausgeber:
  Sie können Beiträge zu einem Thema per E-Mail veröffentlichen, indem Sie eine E-Mail an eine bestimmte Adresse senden. Beispielsweise können Sie einen Beitrag veröffentlichen, indem Sie eine E-Mail an topic@ntfy.youremaildomain.com.
  Der Inhalt des Beitrags entspricht dem Betreff der E-Mail.
  Nur RealSender-Benutzer sind berechtigt, E-Mails an diese Adresse zu senden.

• Abonnenten:
  Sie erhalten Benachrichtigungen über ihr Smartphone oder ihren Computer,
  sofern die ntfy-App installiert ist und sie das abonnierte Thema abonniert haben.

• Themen:
  Stellen Sie sich Themen wie Kanäle vor, mit eindeutigen Namen und darin veröffentlichten Ereignisströmen.
  Sie müssen Themen nicht explizit erstellen; wählen Sie einfach einen Namen und verwenden Sie ihn.
  Themennamen sind öffentlich, daher ist es ratsam, einen Namen zu wählen, der nicht leicht zu erraten ist.

Nach dem Versand der E-Mail empfängt der ntfy-Server die Nachricht und speichert sie für die Abonnenten des jeweiligen Themas.
Ein Abonnent (über die ntfy-App) ist mit dem Thema verbunden und empfängt die Nachricht in Echtzeit.

Es handelt sich um ein „entkoppeltes System“: Herausgeber müssen ihre Abonnenten nicht kennen und umgekehrt.
Dies vereinfacht die Nutzung und Verwaltung sowohl für Herausgeber als auch für Abonnenten.

» Zurück zum Seitenanfang

E-Mail-Anhänge in Links umwandeln

Schreiben Sie einfach „[A]“ in die Betreffzeile und fügen Sie der E-Mail einen Anhang hinzu.
Die App „plainmail“ wandelt diesen automatisch in einen Link um.

Die Domain im Link kann eine beliebige dedizierte Domain oder Subdomain sein.
Die Datei wird nach sechs Monaten gelöscht.

» Zurück zum Seitenanfang

Nachrichten an Mobilnummern

Verbinden Sie Ihre E-Mails mit der mobilen Welt,
maximieren Sie Ihre Möglichkeiten der Geschäftskommunikation,
ohne Ihre Arbeitsgewohnheiten zu ändern:

• Senden Sie SMS von Ihrer E-Mail-Adresse
• Empfangen Sie SMS-Nachrichten per E-Mail
• Beantworten Sie SMS aus Ihrer E-Mail-Adresse
• E-Mail-Anhänge in Links umwandeln

Senden Sie SMS von Ihrer E-Mail-Adresse

Push-Benachrichtigungen sind der effektivste Weg, Ihre Kunden schnell zu erreichen.
Sie zeichnen sich durch extrem hohe Öffnungsraten (bis zu 95 %) und Spitzenantwortraten (bis zu 45 %) aus.
– Quelle: Gartner-Studie zu SMS, Jahr 2019

Empfänger: mobilenumber@text.yourdomain.com Betreff: Der Text der SMS, Emoticons sind erlaubt (zusätzlicher E-Mail-Inhalt und Anhänge werden ignoriert)

Wir liefern Ihnen einen Industrierouter, der für Ihren Mobilfunkbetreiber vorkonfiguriert ist.

Die Kontrolle über das Senden und Empfangen von SMS muss über den verwendeten Mobilfunkanbieter erfolgen.
Unser System prüft alle zehn Minuten, ob der Router reagiert (Stromversorgung und Internetverbindung prüfen).

Um Missbrauch zu verhindern, müssen Nachrichten über RealSender mit vorab autorisierten Absendern und
unter Einhaltung der SPF- und DKIM-Standards („strict“) versendet werden. Weitere Informationen zur E-Mail-Authentifizierung (Fortgeschritten).

» Zurück zum Seitenanfang

Empfangen Sie SMS-Nachrichten per E-Mail

Die SMS-Antworten werden direkt an Ihr bevorzugtes Postfach zugestellt,
zusammen mit einer E-Mail-Nachricht wie dieser:

Betreff: SMS (+41790000000) Nachfolgend die empfangene SMS. Sie wurde am Montag, den 29. Juli 2025 um 10:57:00 Uhr MESZ von (+41790000000) gesendet. --------------------------------------------------------------------------- Testnachricht ---------------------------------------------------------------------------

» Zurück zum Seitenanfang

Beantworten Sie SMS aus Ihrer E-Mail-Adresse

Mit der „plainmail“-App von RealSender können Sie Textnachrichten direkt aus Ihrem E-Mail-Konto versenden.

Sie können also über Ihr bevorzugtes E-Mail-Programm antworten.
Die Empfängeradresse ist bereits mit der ursprünglichen Absendernummer ausgefüllt:

Empfänger: mobilenumber@text.yourdomain.com Betreff: Inhalt der Antwort (zusätzlicher E-Mail-Inhalt und Anhänge werden ignoriert)

Die Kommunikation zwischen E-Mail-Anwendung und Mobilgerät kann somit fortgesetzt werden.

» Zurück zum Seitenanfang

E-Mail-Anhänge in Links umwandeln

Schreiben Sie einfach „[A]“ in die Betreffzeile und fügen Sie der E-Mail einen Anhang hinzu.
Die App „plainmail“ wandelt diesen automatisch in einen Link um.

Die Domain im Link kann eine beliebige dedizierte Domain oder Subdomain sein.
Die Datei wird nach sechs Monaten automatisch gelöscht.

» Zurück zum Seitenanfang