API-Übersicht

Mit RealSender können Sie E-Mails über eine API (Application Programming Interface) versenden.

Auf diese Weise können Sie die E-Mails direkt aus Ihrer Anwendung versenden, ohne den Umweg über SMTP (Simple Mail Transfer Protocol) zu nehmen. Derzeit unterstützen wir ausschließlich 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 Falle von Fehlern wird etwa Folgendes angezeigt:
{"success":false,"errorMsgs":["Please provide the 'subject' value."]}

API-Details

Der Inhalt muss im internationalen Zeichensatz UTF-8 gesendet werden.
Um dies zu testen, fügen Sie „€uro“ in Ihre Betreffzeile ein und senden Sie die Nachricht ab. Wenn der Zeichensatz falsch ist, erhalten Sie folgende JSON-Warnung:

{"success":false,"errorMsgs":["The 'subject' value is not correctly encoded. It must be UTF-8 encoded."]}

Je nachdem, ob Sie das Feld „text“ oder beide Felder („text“ und „html“) ausgefüllt haben, werden die Nachrichten mit einem der folgenden „Content-Type“-Angaben versendet :

Nicht erforderliche/optionale Parameter:

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

Die Antworten des Servers liegen im JSON-Format (JavaScript Object Notation) vor:

API-Beispiele

POST-Anfrage an
CURL-freie Methode mit PHP

<?php
$url = 'https://rsXXX-api.realsender.com/mail/send';
$data = array('apiuser' => 'the one we provided you', 'apipass' => 'the one we provided you', 'from' => 'sender@example.com', 'to' => 'recipient@example.com', 'subject' => 'subject of the message', 'text' => 'email body in plain text', 'html' => 'email body in HTML format');

// use key 'http' even if you send the request to https://...
$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 an
CURL-Methode

curl -d 'apiuser=der von uns bereitgestellte&apipass=der von uns bereitgestellte you&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, …)
CURL-freie Methode 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' => 'the one we provided you',
              'apipass' => 'the one we provided you',
              'from' => 'sender@example.com',
              'to' => 'recipient@example.com',
              'subject' => 'subject of the message',
              'text' => 'email body in plain text',
              'html' => 'email body in 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=der von uns bereitgestellte' \
      -F 'apipass=der von uns bereitgestellte' \
      -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

Übersicht

Mit RealSender können Sie ganz einfach HTTP-Anfragen, wie beispielsweise Inhalte von Webformularen, per E-Mail versenden.
Auf diese Weise erhalten Sie die Ergebnisse Ihrer Feedback-Formulare direkt in Ihrem E-Mail-Postfach.

Es sind keine besonderen Einstellungen Ihrerseits erforderlich.
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 (ausgeblendete Felder):

Erforderliche/obligatorische Parameter (nicht ausgeblendete Felder):

Details

Nicht erforderliche/optionale Parameter (ausgeblendete Felder):

Nicht erforderliche/optionale Parameter (nicht ausgeblendete Felder):

Für die Übermittlung des Formulars wird der internationale Zeichensatz UTF-8 verwendet.
Um dies zu testen, fügen Sie in einem beliebigen Feld „€uro“ ein, senden Sie das Formular ab und überprüfen Sie die E-Mail-Nachricht, die Sie erhalten.

Beispiel für ein Webformular

Dies ist ein einfaches Beispiel für ein HTML-Webformular
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 />
        Email:<br />
        <input name="email" /><br />
        Notes:<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 so viele Felder hinzufügen, wie Sie benötigen; auf Serverebene ist keine Einrichtung erforderlich.

Beispiel für eine SMS an http

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

Sie finden diese Option in der Teltonika-WebUI unter: Dienste > Mobile Dienste > SMS-Gateway.
!! Die Domain des Empfängers (yourdomain.com) muss zuvor von RealSender autorisiert worden sein !!

Name des Zahlenwerts: email

Methode: Post
URL:    https://rsXXX.realsender.com/script/sms.pl

Name des Nachrichtenwerts: message
Zusatzdatenpaar 1:  recipient | name@yourdomain.com
Zusatzdatenpaar 2:  subject   | Text-Message

Option 1 – Nutzung von MOBILEN DATEN

!! Für die ordnungsgemäße Funktion von RealSender ist eine 4G-Verbindung (LTE) erforderlich !!
Sie können dies in der Teltonika-WebUI einrichten: Netzwerk > Mobilfunk > SIM-Karteneinstellungen

Netzwerktyp: Nur 4G (LTE)

Option 2 – Verwendung von LAN-Gateway-Daten

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

Konfigurieren Sie einfach das IPv4-Gateway und die DNS-Server unter
siehe das folgende Beispiel (passen Sie es an Ihre eigenen Parameter an):

SCHNITTSTELLEN: LAN 
...
IPv4-Gateway: 192.168.1.1
DNS-Server:  8.8.8.8     !! obligatorisch !!

Die mobile Datenverbindung kann auf verschiedene Weise deaktiviert werden, siehe: „Mobile Daten deaktivieren“.
Wenn die mobilen Daten deaktiviert sind, funktioniert der SMS-Versand weiterhin.

The easiest way to Disable Mobile Data, is to TEXT to the mobile number: <router_password> mobileoff
You can check the changes in the same way, using the “status” command: <router_password> status

Beispiel für eine empfangene E-Mail

Betreff: SMS (+41790000000)

Nachfolgend finden Sie die empfangene SMS. Sie wurde von
 (+41790000000) am Montag, 26. Juni 2023 um 08:31:29 MESZ eingereicht
---------------------------------------------------------------------------

Testnachricht

---------------------------------------------------------------------------

Reverse-Proxy für SMTP-Server

Die wichtigsten Vorteile:

• Sicherheit Es kann böswillige Anfragen blockieren, den Datenverkehr verschlüsseln,
  und Backend-Server vor direkten Angriffen schützen.
• Leistung Es verteilt den eingehenden Datenverkehr auf mehrere Server, wodurch eine Überlastung
  eines einzelnen Servers verhindert und eine höhere Verfügbarkeit gewährleistet wird.
• Skalierbarkeit Damit können Sie Backend-Server ohne Unterbrechung des Dienstes hinzufügen oder entfernen,
  wodurch Sie in der Lage sind, steigendes Datenaufkommen zu bewältigen.

zertifiziertes E-Mail-Gateway

Zertifizierte E-Mail ist eine E-Mail-Form, mit der der Versand und die Zustellung einer Nachricht bestätigt werden können und die Empfangsbestätigungen liefert, die gegenüber Dritten geltend gemacht werden können.

Es gibt drei Betriebsmodi, die auch kombiniert werden können, um das Versenden von E-Mail-Nachrichten per zertifizierter E-Mail zu ermöglichen:

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

Diese E-Mails werden an einen anderen Server weitergeleitet, der sich beim zertifizierten E-Mail-SMTP-Dienst des Kunden (wie beispielsweise Aruba, Legalmail oder Register, um nur einige zu nennen) authentifiziert.

Der Absender wird automatisch auf die zertifizierte E-Mail-Adresse des Kunden gesetzt.

Zurückgesendete Nachrichten (z. B. „Empfänger unbekannt“ oder „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 einen weiteren Versand zu verhindern, da sie den Spam-Schutz in den Posteingängen der Empfänger auslösen könnten.

E-Mails mit einzeiligem Text

Die App „plainmail“ reduziert Ihre E-Mails auf eine einzige Textzeile,
sie blendet E-Mail-Anhänge aus 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 des Empfängers an, z. B.
. Der Empfänger erhält dann nur die Betreffzeile:

Empfänger: email@example.com.plain
Betreff:   Ihre kurze Nachricht, Emoticons sind erlaubt

Zusätzliche E-Mail-Inhalte und Anhänge werden ignoriert,
stattdessen erscheint folgende Meldung:

< PlainMail >
All content except the subject line has been removed.

» Zurück zum Anfang

E-Mail-Anhänge in Links umwandeln

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

Die Domain im Link kann eine beliebige eigene Domain oder Subdomain sein, die Sie verwenden möchten.
Die Datei wird nach sechs Monaten GELÖSCHT.

» Zurück zum Anfang

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 das bzw. der dasselbe Thema abonniert hat, erhält die Nachricht als Echtzeit-Push-Benachrichtigung.

Dadurch können sofortige Benachrichtigungen übermittelt werden, die von Skripten, Servern oder anderen Diensten generiert werden, sodass Benutzer Benachrichtigungen ohne aufwendige Konfiguration erhalten können.

So funktioniert es mit RealSender:

• Veröffentlicher:
  Sie können Nachrichten zu einem Thema per E-Mail veröffentlichen, indem Sie eine E-Mail an eine bestimmte Adresse senden. Beispielsweise können Sie eine Nachricht veröffentlichen, indem Sie eine E-Mail an topic@ntfy.youremaildomain.com senden.
  Der Inhalt der Nachricht entspricht dem Betreff der E-Mail.
  Nur RealSender-Benutzer sind berechtigt, E-Mails an diese Adresse zu senden

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

• Themen:
  Stellen Sie sich Themen als Kanäle vor, die über eindeutige Namen verfügen und in denen Ereignisströme veröffentlicht werden.
  Sie müssen Themen nicht explizit erstellen; wählen Sie einfach einen Namen aus und verwenden Sie ihn.
  Themennamen sind öffentlich, daher ist es ratsam, einen Namen zu wählen, der nicht leicht zu erraten ist

Nachdem die E-Mail versendet wurde, empfängt der ntfy-Server die Nachricht und speichert sie für die Abonnenten dieses Themas.
Ein Abonnent (über die ntfy-App) ist mit dem Thema verbunden und erhält die Nachricht in Echtzeit.

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

» Zurück zum Anfang

E-Mail-Anhänge in Links umwandeln

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

Die Domain im Link kann eine beliebige eigene Domain oder Subdomain sein, die Sie verwenden möchten.
Die Datei wird nach sechs Monaten GELÖSCHT.

» Zurück zum Anfang

Nachrichten an Handynummern

Verbinden Sie Ihre E-Mails mit der mobilen Welt,
optimieren Sie Ihre geschäftlichen Kommunikationsmöglichkeiten,
ohne Ihre Arbeitsgewohnheiten zu ändern:

• SMS-Nachrichten über Ihre E-Mail versenden
• SMS-Nachrichten per E-Mail empfangen
• Beantworte SMS-Nachrichten direkt aus deinem E-Mail-Postfach
• E-Mail-Anhänge in Links umwandeln

SMS-Nachrichten über Ihre E-Mail versenden

Push-Benachrichtigungen sind der effektivste Weg, um Ihre Kunden schnell zu erreichen.
Mit extrem hohen Öffnungsraten (bis zu 95 %) und Spitzen-Antwortraten (bis zu 45 %).
– Quelle: Gartner-Studie zu Textnachrichten, Jahr 2019

Empfänger: mobilenumber@text.yourdomain.com
Betreff:   Inhalt der SMS, Emoticons sind erlaubt

(weiterer E-Mail-Inhalt und Anhänge werden ignoriert)

Wir stellen Ihnen einen für Ihren Mobilfunkanbieter vorkonfigurierten Industrierouter zur Verfügung.

Die Steuerung des Versands und der Zustellung von SMS-Nachrichten muss über den jeweiligen Netzbetreiber erfolgen.
Unser System überprüft alle zehn Minuten, ob der Router reagiert (bitte überprüfen Sie die Stromversorgung und die Internetverbindung).

Um Missbrauch zu vermeiden, müssen Nachrichten über RealSender unter Verwendung vorab autorisierter Absender gesendet werden,
mit „strenger“ SPF- und DKIM-Konformität. Erfahren Sie mehr über E-Mail-Authentifizierung – Fortgeschrittene.

» Zurück zum Anfang

SMS-Nachrichten per E-Mail empfangen

Die SMS-Antworten werden direkt an Ihre bevorzugte E-Mail-Adresse
gesendet, zusammen mit einer E-Mail-Nachricht wie dieser:

Betreff: SMS (+41790000000)

Nachfolgend finden Sie die empfangene SMS. Sie wurde von
 (+41790000000) am Montag, 29. Juli 2025 um 10:57:00 Uhr MESZ übermittelt
---------------------------------------------------------------------------

Testnachricht

---------------------------------------------------------------------------

» Zurück zum Anfang

Beantworte SMS-Nachrichten direkt aus deinem E-Mail-Postfach

Mit der „plainmail“-App von RealSender kannst du Textnachrichten direkt aus deiner E-Mail heraus versenden.

So können Sie direkt aus Ihrer bevorzugten E-Mail-Anwendung antworten.
Die Empfängeradresse ist bereits mit der Nummer des ursprünglichen Absenders ausgefüllt:

Empfänger: mobilenumber@text.yourdomain.com
Betreff:   der Inhalt der Antwort

(weiterer E-Mail-Inhalt und Anhänge werden ignoriert)

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

» Zurück zum Anfang

E-Mail-Anhänge in Links umwandeln

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

Die Domain im Link kann eine beliebige eigene Domain oder Subdomain sein, die Sie verwenden möchten.
Die Datei wird nach sechs Monaten automatisch gelöscht.

» Zurück zum Anfang