Présentation de l'API

RealSender vous permet d'envoyer des e-mails via une API (interface de programmation d'application).

Vous pouvez ainsi envoyer les e-mails directement depuis votre application, sans passer par le protocole SMTP (Simple Mail Transfer Protocol). Pour l'instant, nous ne prenons en charge que les requêtes POST.

Adresse du serveur :
https://rsXXX-api.realsender.com/mail/send

Paramètres obligatoires :

Si tout se passe bien, le message sera envoyé et vous recevrez une réponse JSON positive :
{"success":true}

En cas d'erreurs, vous obtiendrez quelque chose comme ceci :
{"success":false,"errorMsgs":["Please provide the 'subject' value."]}

Détails de l'API

Le contenu doit être envoyé en utilisant le jeu de caractères international UTF-8.
Pour le tester, ajoutez « €uro » dans votre objet et envoyez-le. Si le jeu de caractères est incorrect, vous recevrez cet avertissement au format JSON :

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

Selon que vous ayez renseigné le champ « text » ou les deux champs « text » et « html », les messages seront envoyés en utilisant l'un des types de contenu suivants :

Paramètres non obligatoires/facultatifs :

Les champs « À », « Cc » et « Cci » peuvent contenir une seule adresse e-mail ou une liste d'adresses e-mail séparées par des virgules.
!! Dans RealSender, le nombre total de destinataires pour chaque e-mail est limité à 25 (il peut être augmenté jusqu'à 100).

Les réponses du serveur sont au format JSON (JavaScript Object Notation) :

Exemples d'API

Requête POST
Méthode sans CURL avec 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);
?>

Requête POST
Méthode CURL

curl -d 'apiuser=celui que nous vous avons fourni&apipass=celui que nous vous avons fourni you&from=sender@example.com&to=recipient@example.com&subject=objet du message&text=corps de l'e-mail en texte brut&html=corps de l'e-mail au format HTML'https://rsXXX-api.realsender.com/mail/send

Exemples d'API avec pièces jointes

Requête POST avec pièces jointes (max. 5 : attach1, attach2, …)
Méthode sans CURL avec 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);
?>

Requête POST avec pièces jointes
Méthode CURL

curl -F 'apiuser=celui que nous vous avons fourni' \
      -F 'apipass=celui que nous vous avons fourni' \
      -F 'from=sender@example.com' \
      -F 'to=recipient@example.com' \
      -F 'subject=objet du message' \
      -F 'text=corps de l'e-mail en texte brut' \
      -F 'html=corps de l'e-mail au format HTML' \
      -F 'attach=@sample.pdf;type=application/pdf' \
      -F 'attach=@sample.txt;type=text/plain' \
      https://rsXXX-api.realsender.com/mail/send

aperçu

RealSender vous permet d'envoyer facilement des requêtes HTTP, telles que le contenu de formulaires Web, par e-mail.
Vous pouvez ainsi recevoir les résultats de vos formulaires de commentaires directement dans votre boîte de réception.

Aucune configuration particulière n'est nécessaire de votre part.
Les formulaires peuvent être publiés sur n'importe quelle page web HTML ou ajoutés directement dans vos e-mails.

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

Paramètres obligatoires (champs masqués) :

Paramètres obligatoires (champs non masqués) :

détails

Paramètres non obligatoires/facultatifs (champs masqués) :

Paramètres facultatifs (champs non masqués) :

Le codage utilisé pour l'envoi du formulaire est le jeu de caractères international UTF-8.
Pour le tester, saisissez « €uro » dans l'un de vos champs, envoyez le formulaire et vérifiez l'e-mail que vous recevrez.

Exemple de formulaire en ligne

Voici un exemple simple de formulaire Web HTML
avec deux paramètres facultatifs : « realname » et « 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>

Les pages de redirection « redirect » et « missing_fields_redirect » peuvent être hébergées sur votre serveur.
Vous pouvez ajouter autant de champs que nécessaire ; aucune configuration n'est requise au niveau du serveur.

Exemple d'envoi d'un SMS à une adresse http

Pour recevoir des SMS directement dans votre boîte mail
Les routeurs Teltonika proposent l'option « Configuration du transfert de SMS vers HTTP ».

Vous le trouverez dans l'interface Web de Teltonika : Services > Utilitaires mobiles > Passerelle SMS.
!! Le domaine du destinataire (votredomaine.com) doit être préalablement autorisé par RealSender !!

Nom de la valeur : email

Méthode : Post
URL :    https://rsXXX.realsender.com/script/sms.pl

Nom de la valeur du message : message
Paire de données supplémentaires 1 :  destinataire | name@yourdomain.com
Paire de données supplémentaires 2 :  objet   | Message texte

Option 1 - Utilisation des DONNÉES MOBILES

!! Une connexion 4G (LTE) est nécessaire pour que RealSender fonctionne correctement !!
Vous pouvez le configurer dans l'interface Web de Teltonika : Réseau > Mobile > Paramètres de la carte SIM

Type de réseau : 4G (LTE) uniquement

Option 2 - Utilisation des données de la passerelle LAN

Vous pouvez configurer la passerelle Internet pour qu'elle passe par votre réseau local.
Interface Web Teltonika : Réseau > LAN > INTERFACES RÉSEAU > [modifier]

Il suffit de configurer la passerelle IPv4 et les serveurs DNS
voir l'exemple ci-dessous (modifiez-le en fonction de vos propres paramètres) :

INTERFACES : LAN 
...
Passerelle IPv4 : 192.168.1.1
Serveurs DNS :  8.8.8.8     !! obligatoire !!

Il existe plusieurs façons de désactiver la connexion de données mobiles. Voir : Désactiver les données mobiles.
Lorsque les données mobiles sont désactivées, la messagerie SMS continue de fonctionner.

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

Exemple d'e-mail reçu

Objet : SMS (+41790000000)

Vous trouverez ci-dessous le SMS reçu. Il a été envoyé par
 (+41790000000) le lundi 26 juin 2023 à 08 h 31 min 29 s CEST
---------------------------------------------------------------------------

Message test

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

proxy inverse pour les serveurs SMTP

Principaux avantages :

• Sécurité Il permet de bloquer les requêtes malveillantes, de chiffrer le trafic,
  et de protéger les serveurs backend contre les attaques directes.
• Performances Il répartit le trafic entrant entre plusieurs serveurs, ce qui évite la surcharge
  d'un seul serveur et garantit une meilleure disponibilité.
• Évolutivité Cette solution vous permet d'ajouter ou de supprimer des serveurs backend sans interruption de service,
  ce qui vous permet de gérer une augmentation du trafic.

passerelle de messagerie certifiée

Le courrier électronique certifié est un service de messagerie électronique permettant de certifier l'envoi et la remise d'un message et de fournir des accusés de réception opposables à des tiers.

Il existe trois modes de fonctionnement, qui peuvent également être combinés, permettant d'envoyer des messages par courrier électronique certifié :

• destinataires disposant d'extensions de domaine prédéfinies (par exemple, pec.it, legalmail.it, pec.poste.it)
• adresses e-mail de destination avec l'extension « .xx » (par exemple, nomdedomaine.com.xx),
  l'extension « .xx » est alors automatiquement supprimée
• certains expéditeurs spécifiques (par exemple, factures@…)

Ces e-mails sont transmis à un autre serveur qui s'authentifie auprès du service SMTP de messagerie certifiée du client (comme Aruba, Legalmail ou Register, pour n'en citer que quelques-uns).

L'expéditeur est automatiquement remplacé par l'adresse e-mail certifiée du client.

Les messages rejetés (par exemple, utilisateur inconnu ou boîte de réception pleine) seront envoyés à l'adresse e-mail certifiée indiquée comme expéditeur.

Les adresses e-mail erronées ou qui ne sont plus valides doivent être corrigées ou supprimées manuellement afin d'éviter tout nouvel envoi, car elles pourraient déclencher le système anti-spam dans les boîtes de réception des destinataires.

e-mails contenant une seule ligne de texte

L'application « plainmail » réduit vos e-mails à une seule ligne de texte,
elle fait disparaître les pièces jointes et envoie des liens à la place :

• Comprimez vos e-mails
• Convertir les pièces jointes des e-mails en liens

Comprimez vos e-mails

Il suffit d'ajouter « .plain » au domaine de messagerie des destinataires,
ils ne recevront alors que l'objet :

Destinataire : email@example.com.plain
Objet :   votre message court (les émoticônes sont autorisées)

Le contenu supplémentaire des e-mails et les pièces jointes sont ignorés,
à la place, le message suivant s'affichera :

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

» Retour en haut de la page

Convertir les pièces jointes des e-mails en liens

Il suffit d'indiquer « [A] » dans l'objet et d'ajouter une pièce jointe à l'e-mail.
L'application « plainmail » le transformera automatiquement en lien.

Le domaine indiqué dans le lien peut être n'importe quel domaine ou sous-domaine dédié que vous souhaitez utiliser.
Le fichier sera SUPPRIMÉ au bout de six mois.

» Retour en haut de la page

notifications vers l'application ntfy

Qu'est-ce que ntfy ?

ntfy (qui se prononce « notify ») fonctionne comme un service de notification de type « publication-abonnement », dans lequel vous envoyez un message vers un « sujet ». Un smartphone ou un ordinateur équipé de l'application ntfy et abonné au même sujet reçoit le message sous forme de notification push en temps réel.

Cela permet l'envoi d'alertes instantanées générées par des scripts, des serveurs ou tout autre service, permettant ainsi aux utilisateurs de recevoir des notifications sans configuration complexe.

Comment cela fonctionne avec RealSender :

• Éditeurs :
  Vous pouvez publier des messages sur un sujet donné par e-mail en envoyant un message à une adresse spécifique. Par exemple, vous pouvez publier un message en envoyant un e-mail à topic@ntfy.youremaildomain.com.
  Le contenu du message correspond à l'objet de l'e-mail.
  Seuls les utilisateurs de RealSender sont autorisés à envoyer des e-mails à cette adresse

• Abonnés :
  Ils reçoivent des notifications sur leur smartphone ou leur ordinateur,
  à condition d'avoir installé l'application ntfy et de s'être abonnés au sujet

• Sujets :
  Considérez les sujets comme des canaux, dotés de noms uniques et de flux d'événements qui y sont publiés.
  Vous n'avez pas besoin de créer explicitement des sujets ; il suffit de choisir un nom et de l'utiliser.
  Les noms de sujets sont publics ; il est donc judicieux de choisir un nom difficile à deviner

Une fois l'e-mail envoyé, le serveur ntfy reçoit le message et le stocke pour les abonnés de ce sujet.
Un abonné (via l'application ntfy) est connecté au sujet et reçoit le message en temps réel.

Il s'agit d'un « système découplé » : les éditeurs n'ont pas besoin de connaître leurs abonnés, et inversement.
Cela simplifie son utilisation et sa gestion, tant pour l'éditeur que pour l'abonné.

» Retour en haut de la page

Convertir les pièces jointes des e-mails en liens

Il suffit d'indiquer « [A] » dans l'objet et d'ajouter une pièce jointe à l'e-mail.
L'application « plainmail » le transformera automatiquement en lien.

Le domaine indiqué dans le lien peut être n'importe quel domaine ou sous-domaine dédié que vous souhaitez utiliser.
Le fichier sera SUPPRIMÉ au bout de six mois.

» Retour en haut de la page

messages vers des numéros de téléphone portable

Connectez vos e-mails à l'univers mobile,
optimisez vos opportunités de communication professionnelle,
sans changer vos habitudes de travail :

• Envoyez des SMS depuis votre messagerie électronique
• Recevez vos SMS dans votre boîte mail
• Répondre à des SMS depuis votre messagerie électronique
• Convertir les pièces jointes des e-mails en liens

Envoyez des SMS depuis votre messagerie électronique

Les notifications push constituent le moyen le plus efficace pour atteindre rapidement vos clients.
Avec des taux d'ouverture extrêmement élevés (jusqu'à 95 %) et des taux de réponse exceptionnels (jusqu'à 45 %).
– source : étude Gartner sur les SMS, année 2019

Destinataire : mobilenumber@text.yourdomain.com
Objet :   le contenu du SMS ; les émoticônes sont autorisées

(le reste du contenu de l'e-mail et les pièces jointes sont ignorés)

Nous vous fournirons un routeur industriel préconfiguré pour votre opérateur mobile.

La gestion de l'envoi et de la réception des SMS doit être effectuée par l'intermédiaire de l'opérateur utilisé.
Notre système vérifie toutes les dix minutes que le routeur répond (vérifiez l'alimentation électrique et la connexion Internet).

Pour éviter tout abus, les messages doivent être envoyés via RealSender, en utilisant des expéditeurs pré-autorisés,
avec un alignement « strict » des protocoles SPF et DKIM. En savoir plus sur l'authentification des e-mails - niveau avancé.

» Retour en haut de la page

Recevez vos SMS dans votre boîte mail

Les réponses par SMS seront envoyées directement à votre boîte de réception préférée,
, sous la forme d'un e-mail comme celui-ci :

Objet : SMS (+41790000000)

Vous trouverez ci-dessous le SMS reçu. Il a été envoyé par
 (+41790000000) le lundi 29 juillet 2025 à 10 h 57 CEST
---------------------------------------------------------------------------

Message test

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

» Retour en haut de la page

Répondre à des SMS depuis votre messagerie électronique

L'application « plainmail » de RealSender vous permet d'envoyer des SMS directement depuis votre messagerie électronique.

Vous pouvez ainsi répondre depuis votre application de messagerie préférée.
L'adresse du destinataire est déjà renseignée avec le numéro de l'expéditeur d'origine :

Destinataire : mobilenumber@text.yourdomain.com
Objet :   le contenu de la réponse

(le reste du contenu de l'e-mail et les pièces jointes sont ignorés)

La communication entre l'application de messagerie et l'appareil mobile peut ainsi se poursuivre.

» Retour en haut de la page

Convertir les pièces jointes des e-mails en liens

Il suffit d'indiquer « [A] » dans l'objet et d'ajouter une pièce jointe à l'e-mail.
L'application « plainmail » le transformera automatiquement en lien.

Le domaine indiqué dans le lien peut être n'importe quel domaine ou sous-domaine dédié que vous souhaitez utiliser.
Le fichier sera automatiquement SUPPRIMÉ au bout de six mois.

» Retour en haut de la page