presentazione

RealSender consente di inviare messaggi di posta elettronica tramite API (Application Programming Interface), in italiano Interfaccia di Programmazione di un’Applicazione.

In questo modo è possibile inviare la posta elettronica direttamente dalla vostra applicazione, senza passare attraverso il protocollo SMTP. Al momento sono supportate solo le richieste POST.

Indirizzo del server:
https://rsXXX-api.realsender.com/mail/send

Parametri obbligatori:

Se tutto è ok, il messaggio verrà inviato e riceverete una risposta JSON positiva:
{"success":true}

In caso di errori si ottiene una risposta simile a questa:
{"success":false,"errorMsgs":["Please provide the 'subject' value."]}

dettagli

I contenuti devono essere trasmessi utilizzando il set di caratteri internazionale UTF-8. Per verificarlo, aggiungere “€uro” nell’oggetto ed inviarlo. Se il set di caratteri è sbagliato, riceverete questo avviso JSON: {"success":false,"errorMsgs":["The 'subject' value is not correctly encoded. It must be UTF-8 encoded."]}

A seconda che siano stati compilati uno solo o entrami i campi “text” e “html”, i messaggi verranno inviati utilizzando uno dei seguenti “Content-Type”:

Parametri opzionali:

I valori to, cc e bcc possono contenere un singolo indirizzo email oppure una lista di indirizzi email separati da virgola.
!! In RealSender il numero di destinatari per ogni singolo messaggio è limitato a 100.

Le risposte del server sono in formato JSON (JavaScript Object Notation):

esempi

Richiesta POST
Metodo senza-CURL con PHP

<?php
$url = 'https://rsXXX-api.realsender.com/mail/send';
$data = array('apiuser' => 'quello che vi abbiamo inviato', 'apipass' => 'quella che vi abbiamo inviato', 'from' => 'mittente@nomedidominio.it', 'to' => 'destinatario@nomedidominio.it', 'subject' => 'oggetto del messaggio', 'text' => 'corpo della mail in testo semplice', 'html' => 'corpo della mail in formato HTML');

// utilizzare 'http' anche se si invia la richiesta a 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);
?>

Richiesta POST
Metodo CURL

curl -d 'apiuser=quello che vi abbiamo inviato&apipass=quella che vi abbiamo inviato&from=mittente@nomedidominio.it&to=destinatario@nomedidominio.it&subject=oggetto del messaggio&text=corpo della mail in testo semplice&html=corpo della mail in formato HTML' https://rsXXX-api.realsender.com/mail/send

esempi con allegati

Richiesta POST con allegati (max 5: attach1, attach2, …)
Metodo senza-CURL con 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' => 'quello che vi abbiamo inviato',
              'apipass' => 'quella che vi abbiamo inviato',
              'from' => 'mittente@nomedidominio.it',
              'to' => 'destinatario@nomedidominio.it',
              'subject' => 'oggetto del messaggio',
              'text' => 'corpo della mail in testo semplice',
              'html' => 'corpo della mail in formato 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);
?>

Richiesta POST con allegati
Metodo CURL

curl -F 'apiuser=quello che vi abbiamo inviato' \
      -F 'apipass=quella che vi abbiamo inviato' \
      -F 'from=mittente@nomedidominio.it' \
      -F 'to=destinatario@nomedidominio.it' \
      -F 'subject=oggetto del messaggio' \
      -F 'text=corpo della mail in testo semplice' \
      -F 'html=corpo della mail in formato HTML' \
      -F 'attach=@sample.pdf;type=application/pdf' \
      -F 'attach=@sample.txt;type=text/plain' \
      https://rsXXX-api.realsender.com/mail/send

presentazione

RealSender consente di inviare facilmente richieste http, come quelle generate da moduli HTML, tramite email.
In questo modo riceverete i risultati dei moduli di feedback direttamente nella vostra casella di posta.

Senza alcuna configurazione speciale da parte vostra.
I moduli possono essere pubblicati in qualsiasi pagina html o aggiunti direttamente all’interno dei vostri messaggi email.

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

Parametri obbigatori (hidden fields / campi nascosti):

Parametri obbigatori (non-hidden fields / campi visibili):

dettagli

Parametri opzionali (hidden fields / campi nascosti):

Parametri opzionali (non-hidden fields / campi visibili):

La codifica che verrà utilizzata per l’invio del modulo è il set di caratteri internazionale UTF-8.
Per verificarlo, aggiungere “€uro” in uno dei campi, inviare il modulo e controllare il messaggio di posta elettronica ricevuto.

form html esempio

Questo è un semplice modulo html d’esempio
con due parametri opzionali: “realname” e “note”

<form action="https://rsXXX.realsender.com/script/form.pl" method="post" accept-charset="utf-8">
    <input type="hidden" name="recipient" value="indirizzo_email-o-alias" />
    <input type="hidden" name="required" value="email" />
    <input type="hidden" name="redirect" value="/form/grazie.html" />
    <input type="hidden" name="missing_fields_redirect" value="/form/errore.html" />
        Nome:<br />
        <input name="realname" /><br />
        Email:<br />
        <input name="email" /><br />
        Note:<br />
        <textarea cols="40" rows="2" name="note"></textarea><br />
        <input type="submit" />
</form>

Le pagine di atterraggio “redirect” e “missing_fields_redirect” possono risiedere sul vostro server.
Potete aggiungere quanti campi vi occorrono, non è richiesta alcuna impostazione lato server.

sms ad http esempio

Per ricevere i messaggi sms direttamente nella vostra casella email
I router Teltonika offrono l’opzione “SMS Forwarding To HTTP Configuration” (Inoltro SMS ad HTTP configurazione).

Potete trovarla all’interno dell’interfaccia Web: Services > Mobile Utilities > SMS Gateway.
!! Il dominio del destinatario (yourdomain.com) deve essere pre-autorizzato da 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

Opzione 1: utilizzo di DATI MOBILI

!! Per funzionare correttamente con RealSender è necessaria una connessione 4G (LTE) !!
Potete configurarla all’interno dell’interfaccia Web: Network > Mobile > SIM card settings

Network type: 4G (LTE) only

Opzione 2: utilizzo dei DATI LAN GATEWAY

È possibile impostare il gateway Internet in modo che passi attraverso la LAN.
Teltonika WebUI: Network > LAN > NETWORK INTERFACES > [modifica]

Occorre solo configurare il gateway IPv4 ed anche i server DNS
vedi l’esempio qui sotto (modificatelo con i vostri parametri):

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

La Connessione Dati Mobili può essere disattivata in vari modi, vedi: Disable Mobile Data.
Quando i dati mobili sono disabilitati, la messaggistica SMS rimane operativa.

Il modo più semplice per Disabilitare i dati mobili è inviare un SMS al numero di cellulare: <router_password> mobileoff
Potete controllare le modifiche allo stesso modo, utilizzando il comando “status”: <router_password> status

Esempio di messaggio email ricevuto:

Oggetto: Text-Message (+393380000000)

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

Messaggio di prova

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

script formmail

Lo script “formmail” di RealSender vi consente di creare moduli semplici e “responsive”,
quindi utilizzabili anche su tablet e smartphone con schermi di dimensioni ridotte,
che invieranno i dati direttamente al vostro indirizzo di posta elettronica.

Pochi componenti “Trascina e Rilascia” (Drag & Drop)
vi aiuteranno a strutturare le vostre domande:

Il sorgente è scaricabile in un file “form.html” pronto all’uso:

Potete provare lo script “formmail” qui:
» formmail.realsender.com/forms

• aggiungete un campo “Text Input” ed un “Button” (dalla scheda “Buttons”), che permetterà di inviare il modulo
• per salvare il file in locale, cliccate il pulsante “Download” (dalla scheda “Rendered”)
• aprite form.html, inserite del testo e premete il pulsante per inviare i contenuti
  (NOTA: poiché non è pubblicato online, la pagina di ringraziamento sarà grossolana)

Il messaggio viene ricevuto nel servizio “email temporanea” di RealSender: inxbox.realsender.com

NOTA: nel file form.html, sono modificabili tre parametri:
- recipient = il codice associato all'email del destinatario
  per evitare abusi, l'indirizzo email è pre-codificato nello script di invio
  lasciando "0" il messaggio viene ricevuto nella "email temporanea" di RealSender
- email = l'indirizzo email di chi compila il modulo (ID / name = email)
  viene utilizzato solo se NON è presente un campo "email" nel modulo
- subject = l'oggetto del messaggio email

Se volete pubblicare il file form.html online, richiedete una prova gratuita.

Otterrete così un elegante popup di conferma come quello qui sotto riportato.
I dati inseriti verranno recapitati direttamente nella vostra casella di posta elettronica.

script flashmail

Alcuni esempi

per ricevere maggiori informazioni sulla promozione di questo mese, clicca qui:  
https://click.nomedidominio.it/script/flash.pl?promo=si

se desideri partecipare all'evento, clicca qui:  
https://click.nomedidominio.it/script/flash.pl?evento=si

per ordinare il nuovo prodotto, clicca qui:  
https://click.nomedidominio.it/script/flash.pl?nuovoprodotto=si

Se viene aggiunto in coda al link l’indirizzo email, come sotto indicato,
verrà inserito il reply-to, la risposta andrà all’email di chi ha cliccato:

&email=nome@mail.it

Configurazione

Per evitare che i link inseriti nelle vostre comunicazioni
vengano considerati come “tentativo di phishing”,
occorre configurare un sottodominio del dominio mittente, ad esempio:

click.nomedidominio.it     CNAME    click.realsender.com

Il destinatario della notifica, anche più di uno, è impostato nello script.
Ce lo comunicherete in fase di configurazione.

Webmail

Negli esempi sopra riportati, le notifiche raggiungono
la nostra email temporanea, consultabile all’indirizzo:
https://inxbox.realsender.com/monitor