overview

RealSender lets you send email messages via API (Application Programming Interface).

In this way you can dispatch the emails directly from your application, without passing through smtp (Simple Mail Transfer Protocol). We currently support POST requests only.

Server address:
https://rsXXX-api.realsender.com/mail/send

Required/mandatory parameters:

If everything is ok, the message will be sent and you will receive a positive JSON answer:
{"success":true}

In case of errors you will get something like this:
{"success":false,"errorMsgs":["Please provide the 'subject' value."]}

details

The contents must be sent using the UTF-8 international charset.
To test it, add “€uro” in your subject and submit it. If the charset is wrong, you will receive this JSON warning:

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

Depending on whether you have filled in one or both the fields “text” and “html”, the messages will be sent using one of these “Content-Type”:

Not required/optional parameters:

To, cc and bcc values can contain a single email address or a comma separated list of email addresses.
!! Within RealSender the total number of recipients for each piece of email is limited to 25 (it can be increased up to 100).

The server’s responses are in JSON (JavaScript Object Notation) format:

examples

POST request
CURL-less method with 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 request
CURL method

curl -d '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'https://rsXXX-api.realsender.com/mail/send

examples with attachments

POST request with attachments (max 5: attach1, attach2, …)
CURL-less method with 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 request with attachments
CURL method

curl -F 'apiuser=the one we provided you' \
      -F 'apipass=the one we provided you' \
      -F 'from=sender@example.com' \
      -F 'to=recipient@example.com' \
      -F 'subject=subject of the message' \
      -F 'text=email body in plain text' \
      -F 'html=email body in HTML format' \
      -F 'attach=@sample.pdf;type=application/pdf' \
      -F 'attach=@sample.txt;type=text/plain' \
      https://rsXXX-api.realsender.com/mail/send

overview

RealSender lets you easily submit http requests, such as web forms contents, via email messages.
In this way you can receive the results of your feedback forms directly in your mailbox.

There’s no need of any special configuration on your side.
The forms can be published in any html webpage or added directly within your email messages.

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

Required/mandatory parameters (hidden fields):

Required/mandatory parameters (non-hidden fields):

details

Not required/optional parameters (hidden fields):

Not required/optional parameters (non-hidden fields):

The encoding that will be used for the form submission is the UTF-8 international charset.
To test it, add “€uro” in any of your fields, submit the form and check the email message you’ll receive.

web form example

This is a simple html web form example
with two optional parameters: “realname” and “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>

The “redirect” and “missing_fields_redirect” landing pages can reside on your server.
You can add as many fields you need, no setup is required at server level.

sms to http example

To receive SMS messages directly in your mailbox
Teltonika routers offer the “SMS Forwarding To HTTP Configuration” option.

You can find it within the Teltonika WebUI: Services > Mobile Utilities > SMS Gateway.
!! The recipient’s domain (yourdomain.com) must be pre-authorized by RealSender !!

Number value name: email

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

Message value name: message
Extra data pair 1:  recipient | name@yourdomain.com
Extra data pair 2:  subject   | Text-Message

Option 1 - using MOBILE DATA

!! A 4G (LTE) connection is required to work properly with RealSender !!
You can setup it up inside Teltonika WebUI: Network > Mobile > SIM card settings

Network type: 4G (LTE) only

Option 2 - using LAN GATEWAY DATA

You can set the internet gateway to go through your LAN.
Teltonika WebUI: Network > LAN > NETWORK INTERFACES > [edit]

Just configure the IPv4 gateway and the DNS servers
see the example below (modify it with your own parameters):

INTERFACES: LAN 
...
IPv4 gateway: 192.168.1.1
DNS servers:  8.8.8.8     !! mandatory !!

The Mobile Data Connection can be disabled in a few ways, see: Disable Mobile Data.
When mobile data is disabled, SMS messaging remains operational.

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

Example of email message received

Subject: Text-Message (+41790000000)

Below is the received text message.  It was submitted by
 (+41790000000) on Monday, June 26, 2023 at 08:31:29 CEST
---------------------------------------------------------------------------

Test Message

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

formmail script

Receiving clear and structured information via the internet can be complicated.
It needs a user interface to fill in and a server application that sends the data.

RealSender’s “formmail” script lets you create simple and responsive forms,
therefore usable also on tablets and smartphones with small screens,
that will send the data directly to your email address.

Few “Drag & Drop” components will help you structure your questions:

The source is downloadable in a ready-to-use “form.html” file:

You can try the “formmail” script yourself at:
» formmail.realsender.com/forms

• add a “Text Input” field and a “Button” (in the “Buttons” tab), that will let you submit the form
• click the “Download” button (in the “Rendered” tab) to save the file locally
• open form.html, enter some text and press the button to submit the contents
  (NOTE: because it’s not published online, the “Thank You” page will be coarse)

The message is received in the RealSender’s “temporary email” service: inxbox.realsender.com

NOTE: in the form.html file, three parameters can be changed:
- recipient = the code associated with the recipient's email
  to prevent abuse, the email address is pre-encoded in the sending script
  leaving "0" the message is received in the RealSender's "temporary email"
- email = the email address of the person filling out the form (ID=email)
  it is only used if there is NO "email" field in the form
- subject = the subject of the email message email

Request a free trial if you want to publish the html file online.
You will thus get an elegant confirmation popup like the one below.
The entered data will be delivered directly to your email box.

flashmail script

You can try the “flashmail” builder at:
» flashmail.realsender.com/builder

Some examples

for more information on this month's promotion, click here:  
https://click.youremaildomain.com/s/flash.pl?promo=yes

if you wish to participate in the event, click here:  
https://click.youremaildomain.com/s/flash.pl?event=yes

to order the new product, click here: 
https://click.youremaildomain.com/s/flash.pl?newproduct=yes

If you add the email address at the end of the link, as indicated below,
the reply-to will be inserted, the response will go to the email of the person who clicked:

&email=name@example.com

To set the “landing page” displayed after sending the data,
add the “rdir” parameter to the end of the link, as shown below:

&rdir=/ok

Alternatively indicate your website address, for example:

&rdir=www.example.com/thankyou

Setup

To prevent the links included in your communications
from being considered as a “phishing attempt”,
a subdomain of the sending domain must be configured, for example:

click.youremaildomain.com     CNAME    click.realsender.com

The notification recipient, even more than one, is set in the script.
You will let us know it during the configuration phase.

Webmail

In the examples above, notifications reach
our temporary email, which can be found at:
https://inxbox.realsender.com/monitor

certified email gateway

Certified Electronic Mail is an email capable of certifying the sending and delivery of a message and providing receipts that can be used against third parties.

There are three operating modes, which can also be combined, to enable sending email messages via certified email:

• recipients with predefined domain extensions (e.g., pec.it, legalmail.it, pec.poste.it)
• destination email addresses with the “.xx” extension (e.g., domainname.com.xx),
  the “.xx” extension is then automatically removed
• certain specific senders (e.g., invoices@…)

These email messages are transmitted to another server that authenticates itself with the customer’s certified email SMTP service (such as Aruba, Legalmail, Register, to name a few).

The sender is automatically changed to the customer’s certified email address.

Bounced messages (e.g., user unknown/mailbox full) will be sent to the certified email address indicated as the sender.

Incorrect or no longer valid email addresses must be manually corrected or deleted to prevent further sending, as they could trigger spam protection in the recipient email inboxes.

single-line text emails

The “plainmail” app reduces your emails to a single line of text,
it makes email attachments disappear, sending links instead:

• Squeeze your emails
• Convert email attachments into links

Squeeze your emails

Simply add “.plain” to the recipients’ email domain,
they will receive only the subject:

Recipient: email@example.com.plain
Subject:   your short message, emoticons are allowed

Additional email content and attachments are ignored,
in their place, the following message will appear:

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

» back to top

Convert email attachments into links

Just write “[A]” in the subject and add an attachment to the email.
The “plainmail” app will automatically convert it into a link.

The domain in the link can be any dedicated domain or subdomain you wish to use.
The file will be DELETED after six months.

» back to top

notifications to the ntfy app

What is ntfy?

ntfy (pronounced “notify”) works as a “publish-subscribe” notification service, in which you send a message to a “topic.” A smartphone or computer running the ntfy app and subscribed to the same topic receives the message as a real-time push notification.

This allows for the delivery of instant alerts generated by scripts, servers, or any other service, allowing users to receive notifications without complex configuration.

How it works with RealSender:

• Publishers:
  you can publish messages on a topic via email by sending an email to a specific address. For example, you can publish a message by sending an email to topic@ntfy.youremaildomain.com.
  The message content matches the email subject.
  Only RealSender users are authorized to send emails to this address

• Subscribers:
  they receive notifications via their smartphone or computer,
  with the ntfy app installed and the topic they’ve subscribed to

• Topics:
  think of topics as channels, with unique names and streams of events that are published within them.
  You don’t need to explicitly create topics; just choose a name and use it.
  Topic names are public, so it’s wise to choose something that cannot be guessed easily

After the email is sent, the ntfy server receives the message and stores it for that topic’s subscribers.
A subscriber (via the ntfy app) is connected to the topic and receives the message in real time.

It’s a “decoupled system”, publishers don’t need to know their subscribers, and vice versa.
This simplifies its use and management, both for the publisher and the subscriber.

» back to top

Convert email attachments into links

Just write “[A]” in the subject and add an attachment to the email.
The “plainmail” app will automatically convert it into a link.

The domain in the link can be any dedicated domain or subdomain you wish to use.
The file will be DELETED after six months.

» back to top

messages to mobile numbers

Connect your emails to the mobile world,
maximize your business communication opportunities,
without changing your work habits:

• Send text messages from your email
• Receive text messages in your email
• Reply to text messages from your email
• Convert email attachments into links

Send text messages from your email

Push notifications are the most effective way to reach your customers quickly.
With super high open rates (up to 95%) and top response rates (up to 45%).
– source: Gartner study on Text Messages, year 2019

Recipient: mobilenumber@text.yourdomain.com
Subject:   the text message content, emoticons are allowed

(additional email content and attachments are ignored)

We will provide you with an industrial router pre-configured for your mobile operator.

Control over the sending and delivery of text messages must be carried out via the operator used.
Our system checks every ten minutes that the router is responding (check power and internet connection).

To avoid abuses, messages must be sent via RealSender, using pre-authorized senders,
with the SPF and DKIM “strict” alignment. Learn more on email authentication - advanced.

» back to top

Receive text messages in your email

The text message replies will be delivered directly to your preferred mailbox,
with an email message like this:

Subject: Text-Message (+41790000000)

Below is the received text message.  It was submitted by
 (+41790000000) on Monday, July 29, 2025 at 10:57:00 CEST
---------------------------------------------------------------------------

Test Message

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

» back to top

Reply to text messages from your email

RealSender’s “plainmail” app lets you send text messages directly from your EMAIL.

So you can reply from your favorite email application.
The recipient address is already filled with the original sender number:

Recipient: mobilenumber@text.yourdomain.com
Subject:   the content of the reply

(additional email content and attachments are ignored)

The conversation between email application and mobile device can thus continue.

» back to top

Convert email attachments into links

Just write “[A]” in the subject and add an attachment to the email.
The “plainmail” app will automatically convert it into a link.

The domain in the link can be any dedicated domain or subdomain you wish to use.
The file will be automatically DELETED after six months.

» back to top