Aperçu de l'API

RealSender vous permet d'envoyer des messages électroniques 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). Actuellement, seules les requêtes POST.

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

Paramètres requis/obligatoires :

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

En cas d'erreur, vous obtiendrez un résultat similaire à celui-ci :
{"success":false,"errorMsgs":["Veuillez fournir la valeur du sujet."]}

détails de l'API

Le contenu doit être envoyé en utilisant l' encodage de caractères international UTF-8.
Pour le tester, ajoutez « €uro » à l'objet et soumettez votre message. Si l'encodage est incorrect, vous recevrez l'avertissement JSON suivant :

{"success":false,"errorMsgs":["La valeur 'subject' n'est pas correctement encodée. Elle doit être encodée en UTF-8."]}

Selon que vous ayez rempli un ou les deux champs « text » et « html », les messages seront envoyés en utilisant l’un de ces « Content-Type » :

Paramètres non obligatoires/optionnels :

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
sans CURL avec PHP

<?php $url = 'https://rsXXX-api.realsender.com/mail/send'; $data = array('apiuser' =>'celle que nous vous avons fournie', 'apipass' => 'celle que nous vous avons fournie', 'from' => 'sender@example.com', 'to' => 'recipient@example.com', 'subject' => 'sujet du message', 'text' => 'corps de l'e-mail en texte brut', 'html' => 'corps de l'e-mail au format HTML'); // utiliser la clé 'http' même si vous envoyez la requête à 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); ?>

de requête POST
CURL

curl -d 'apiuser=celui que nous vous avons fourni&apipass=celui que nous vous avons fourni&from=sender@example.com&to=recipient@example.com&subject=sujet 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 (5 max : 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' => 'celui que nous vous avons fourni', 'apipass' => 'celui que nous vous avons fourni', 'from' => 'sender@example.com', 'to' => 'recipient@example.com', 'subject' => 'sujet du message', 'text' => 'corps de l'e-mail en texte brut', 'html' => 'corps de l'e-mail au format HTML'); 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=sujet 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, comme le contenu de formulaires web, par e-mail.
Vous recevez ainsi les résultats de vos formulaires de contact directement dans votre boîte mail.

Aucune configuration particulière n'est requise de votre côté.
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 requis/obligatoires (champs cachés) :

Paramètres requis/obligatoires (champs non cachés) :

détails

Paramètres facultatifs (champs cachés) :

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

L'encodage utilisé pour la soumission du formulaire est l'UTF-8.
Pour le tester, saisissez « €uro » dans un champ, soumettez le formulaire et vérifiez le courriel de confirmation.

exemple de formulaire web

Voici un exemple simple de formulaire web HTML
avec deux paramètres optionnels : « 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" /> Nom:<br /><input name="realname" /><br /> E-mail:<br /><input name="email" /><br /> Remarques :<br /><textarea cols="40" rows="2" name="notes"></textarea><br /><input type="submit" /></form>

Les pages de destination « 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 côté serveur.

Exemple de conversion SMS vers HTTP

Pour recevoir les SMS directement dans votre boîte mail,
les routeurs Teltonika proposent l'option « Configuration du transfert 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 numérique : 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 | nom@votredomaine.com Paire de données supplémentaires 2 : sujet | Message texte

Option 1 - utilisation des données mobiles

!! Une connexion 4G (LTE) est requise pour un fonctionnement optimal de RealSender !!
Vous pouvez la 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 avec vos propres paramètres) :

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

La connexion de données mobiles peut être désactivée de plusieurs manières ; voir : Désactiver les données mobiles.
Lorsque les données mobiles sont désactivées, l’envoi de SMS reste possible.

Le moyen le plus simple de désactiver les données mobilesest d' envoyer un SMS au numéro de téléphone : <router_password> mobileoff
Vous pouvez vérifier les modifications de la même manière, en utilisant la commande « status » : <router_password> status

Exemple de message électronique reçu

Objet : SMS (+41790000000) Ci-dessous le SMS reçu. Il a été envoyé par (+41790000000) le lundi 26 juin 2023 à 08:31:29 CEST. --------------------------------------------------------------------------- Message de test ---------------------------------------------------------------------------

alertes Google Actualités

Google Actualités est un service d'agrégation d'actualités développé et géré par Google.
Il propose un flux continu de liens vers des articles provenant de milliers d'éditeurs et de magazines.
Ce service est disponible dans plus de 60 pays et en plus de 35 langues.

Le site web Google Actualités génère automatiquement une liste d'articles
provenant des principaux journaux en ligne (du pays où il est hébergé)
et les regroupe par contenu similaire, en les triant par sujet et par date de publication.
Les articles sont toujours publiés sous forme de courts résumés.

Le flux « Alertes Google Actualités » pour l’application emailconnect
extrait le flux RSS et envoie des notifications par e-mail
à l’intervalle souhaité, sur un sujet spécifique, au destinataire associé :

Il suffit de dupliquer le flux, de modifier le premier et le dernier nœud, et vous obtiendrez
plusieurs alertes, pour différents sujets, envoyées à plusieurs destinataires.

Si aucune information n'est disponible depuis 24 heures, aucun message ne sera envoyé.
Le bouton situé à gauche de « Premier sujet » permet de forcer manuellement l'exécution.

vérification de l'état SMTP

La vérification de l'état SMTP contrôle la disponibilité, la sécurité et le bon fonctionnement de votre serveur de messagerie.
Elle garantit que le serveur accepte les connexions TCP, s'authentifie correctement et traite les courriels.

La vérification est configurée pour s'exécuter à intervalles réguliers, toutes les dix minutes.
L'utilisateur peut modifier lui-même cet intervalle prédéfini.

Le flux de « vérification de l'état SMTP » de l'application EmailConnect
vérifie que le service SMTP fonctionne correctement en envoyant de vrais messages ;
le système n'envoie un e-mail d'alerte qu'en cas de dysfonctionnement.

Il suffit de dupliquer le flux, de modifier le premier et le dernier nœud, et vous obtiendrez
plusieurs alertes, pour différents serveurs SMTP, envoyées aux destinataires souhaités.

L'utilisateur et le mot de passe sont définis au niveau système comme des variables d'environnement ; l'utilisateur ne peut pas les lire.
Le bouton situé à gauche du premier nœud « companyname » permet de forcer manuellement l'exécution
et d'afficher le résultat dans la zone de débogage, à droite de l'écran.

vérification de l'état du site web

La vérification de l'état du site web contrôle sa disponibilité, sa sécurité SSL et son bon fonctionnement.
Elle surveille le fonctionnement de votre serveur web, la validité des certificats SSL et le comportement des pages web.

La vérification est configurée pour s'exécuter à intervalles réguliers, toutes les dix minutes.
L'utilisateur peut modifier lui-même cet intervalle prédéfini.

Le flux de « vérification de l'état du site web » de l'application emailconnect
envoie une requête HTTP à l'adresse du site et analyse la réponse ;
le système n'envoie un e-mail d'alerte qu'en cas de dysfonctionnement :

Il suffit de dupliquer le flux, de modifier le premier et le dernier nœud, et vous obtiendrez
plusieurs alertes, pour différents sites web, envoyées aux destinataires souhaités.

Le bouton situé à gauche du premier https://example.com vous permet de forcer manuellement l'exécution
et d'afficher le résultat dans la zone de débogage, sur le côté droit de l'écran :

proxy inverse pour serveurs SMTP

Principaux avantages :

• Sécurité : Il peut bloquer les requêtes malveillantes, chiffrer le trafic
  et protéger les serveurs backend contre les attaques directes.
• Performances : Il répartit le trafic entrant sur plusieurs serveurs, évitant ainsi la surcharge
  d'un seul serveur et garantissant une plus grande disponibilité.
• Évolutivité : Elle vous permet d'ajouter ou de supprimer des serveurs backend sans interruption de service,
  offrant ainsi la possibilité de gérer un trafic croissant.

passerelle de messagerie certifiée

Le courrier électronique certifié est un courrier électronique capable de certifier l'envoi et la livraison d'un message et de fournir des reçus pouvant être utilisés contre des tiers.

Il existe trois modes de fonctionnement, qui peuvent également être combinés, pour permettre l'envoi de messages électroniques via un système de messagerie certifiée :

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

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

L'expéditeur est automatiquement modifié pour correspondre à l'adresse électronique certifiée du client.

Les messages non distribués (par exemple, utilisateur inconnu/boîte aux lettres pleine) seront envoyés à l'adresse électronique certifiée indiquée comme expéditeur.

Les adresses électroniques incorrectes ou obsolètes doivent être corrigées ou supprimées manuellement afin d'empêcher tout envoi ultérieur, car elles pourraient déclencher la protection anti-spam dans les boîtes de réception des destinataires.

courriels en texte d'une seule ligne

L'application « plainmail » réduit vos courriels à une seule ligne de texte,
elle supprime les pièces jointes et envoie des liens à la place :

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

Optimisez vos emails

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

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

Le contenu supplémentaire des courriels et les pièces jointes sont ignorés ;
à leur place, le message suivant s'affichera :

< PlainMail > Tout le contenu, à l'exception de l'objet, a été supprimé.

» Retour en haut de page

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

Il suffit d'écrire « [A] » dans l'objet et d'ajouter une pièce jointe.
L'application « plainmail » la convertira automatiquement en lien.

Le domaine indiqué dans le lien peut être n'importe quel domaine ou sous-domaine dédié.
Le fichier sera supprimé après six mois.

» Retour en haut de page

notifications à l'application NTFY

Qu'est-ce que ntfy ?

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

Cela permet la diffusion 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.

Fonctionnement avec RealSender :

• Éditeurs :
  vous pouvez publier des messages sur un sujet 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.votre_domaine_email.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 via leur smartphone ou leur ordinateur,
  après avoir installé l’application NTFY et sélectionné le sujet auquel ils sont abonnés.

• Sujets :
  considérez les sujets comme des chaînes, chacune avec un nom unique et un flux d’événements qui y sont publiés.
  Il n’est pas nécessaire de créer explicitement les sujets ; choisissez simplement un nom et utilisez-le.
  Les noms de sujets étant publics, il est judicieux d’en choisir un difficilement devinable.

Une fois l'e-mail envoyé, le serveur NTFY reçoit le message et le stocke pour les abonnés à 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 page

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

Il suffit d'écrire « [A] » dans l'objet et d'ajouter une pièce jointe.
L'application « plainmail » la convertira automatiquement en lien.

Le domaine indiqué dans le lien peut être n'importe quel domaine ou sous-domaine dédié.
Le fichier sera supprimé après six mois.

» Retour en haut de page

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

Connectez vos e-mails au monde mobile,
optimisez vos opportunités de communication professionnelle,
sans changer vos habitudes de travail :

• Envoyez des SMS depuis votre email
• Recevez des SMS dans votre boîte mail
• Répondre aux SMS depuis votre adresse e-mail
• Convertir les pièces jointes des e-mails en liens

Envoyez des SMS depuis votre email

Les notifications push constituent le moyen le plus efficace de toucher rapidement vos clients.
Elles affichent des taux d'ouverture exceptionnels (jusqu'à 95 %) et des taux de réponse optimaux (jusqu'à 45 %).
– Source : Étude Gartner sur les SMS, 2019

Destinataire : numéro_de_mobile@texte.votre_domaine.com Objet : le contenu du SMS (les émoticônes sont autorisées ; le contenu supplémentaire 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.

Le contrôle de l'envoi et de la réception des SMS doit être effectué par l'opérateur utilisé.
Notre système vérifie toutes les dix minutes que le routeur répond (alimentation et connexion internet).

Pour éviter les abus, les messages doivent être envoyés via RealSender, en utilisant des expéditeurs pré-autorisés et
en respectant les règles SPF et DKIM « strictes ». En savoir plus sur l’authentification des e-mails (niveau avancé).

» Retour en haut de page

Recevez des SMS dans votre boîte mail

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

Objet : SMS (+41790000000) Ci-dessous le SMS reçu. Il a été envoyé par (+41790000000) le lundi 29 juillet 2025 à 10:57:00 CEST. --------------------------------------------------------------------------- Message de test ---------------------------------------------------------------------------

» Retour en haut de page

Répondre aux SMS depuis votre adresse e-mail

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

Vous pouvez donc répondre depuis votre application de messagerie préférée.
L'adresse du destinataire est déjà préremplie 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 courriel et les pièces jointes sont ignorés)

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

» Retour en haut de page

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

Il suffit d'écrire « [A] » dans l'objet et d'ajouter une pièce jointe.
L'application « plainmail » la convertira automatiquement en lien.

Le domaine indiqué dans le lien peut être n'importe quel domaine ou sous-domaine dédié.
Le fichier sera automatiquement supprimé après six mois.

» Retour en haut de page