Descripción general de la API

RealSender te permite enviar mensajes de correo electrónico a través de una API (interfaz de programación de aplicaciones).

De esta forma, puedes enviar los correos electrónicos directamente desde tu aplicación, sin pasar por el protocolo SMTP (Simple Mail Transfer Protocol). Actualmente solo admitimos solicitudes POST.

Dirección del servidor:
https://rsXXX-api.realsender.com/mail/send

Parámetros obligatorios:

Si todo va bien, el mensaje se enviará y recibirás una respuesta JSON positiva:
{"success":true}

Si se producen errores, aparecerá un mensaje similar a este:
{"success":false,"errorMsgs":["Please provide the 'subject' value."]}

Detalles de la API

El contenido debe enviarse utilizando el juego de caracteres internacional UTF-8.
Para comprobarlo, añade «€uro» en el asunto y envíalo. Si el juego de caracteres es incorrecto, recibirás esta advertencia en formato JSON:

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

Dependiendo de si has rellenado uno o ambos campos, «texto» y «html», los mensajes se enviarán utilizando uno de estos «Content-Type»:

Parámetros no obligatorios/opcionales:

Los campos «Para», «CC» y «CCO» pueden contener una sola dirección de correo electrónico o una lista de direcciones separadas por comas.
!! En RealSender, el número total de destinatarios por cada correo electrónico está limitado a 25 (se puede aumentar hasta 100).

Las respuestas del servidor están en formato JSON (JavaScript Object Notation):

Ejemplos de API

Solicitud POST a
Método sin CURL con 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);
?>

Solicitud POST
Método CURL

curl -d 'apiuser=el que te hemos facilitado&apipass=el que te hemos facilitado you&from=sender@example.com&to=recipient@example.com&subject=asunto del mensaje&text=cuerpo del correo electrónico en texto sin formato&html=cuerpo del correo electrónico en formato HTML'https://rsXXX-api.realsender.com/mail/send

Ejemplos de API con archivos adjuntos

Solicitud POST con archivos adjuntos (máx. 5: attach1, attach2, …)
Método sin 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' => '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);
?>

Solicitud POST con archivos adjuntos
Método CURL

curl -F 'apiuser=el que te hemos facilitado' \
      -F 'apipass=el que te hemos facilitado' \
      -F 'from=sender@example.com' \
      -F 'to=recipient@example.com' \
      -F 'subject=asunto del mensaje' \
      -F 'text=cuerpo del correo electrónico en texto sin formato' \
      -F 'html=cuerpo del correo electrónico en formato HTML' \
      -F 'attach=@sample.pdf;type=application/pdf' \
      -F 'attach=@sample.txt;type=text/plain' \
      https://rsXXX-api.realsender.com/mail/send

resumen

RealSender te permite enviar fácilmente solicitudes HTTP, como el contenido de formularios web, a través de mensajes de correo electrónico.
De esta forma, podrás recibir los resultados de tus formularios de comentarios directamente en tu buzón de correo.

No es necesario que realices ninguna configuración especial.
Los formularios se pueden publicar en cualquier página web HTML o añadir directamente a tus mensajes de correo electrónico.

Dirección del script:
<form action="https://rsXXX.realsender.com/script/form.pl" method="post" accept-charset="utf-8">

Parámetros obligatorios (campos ocultos):

Parámetros obligatorios (campos no ocultos):

detalles

Parámetros no obligatorios/opcionales (campos ocultos):

Parámetros no obligatorios/opcionales (campos no ocultos):

La codificación que se utilizará para el envío del formulario es el juego de caracteres internacional UTF-8.
Para probarlo, escribe «€uro» en cualquiera de los campos, envía el formulario y comprueba el mensaje de correo electrónico que recibirás.

Ejemplo de formulario web

Este es un ejemplo sencillo de formulario web en HTML
con dos parámetros opcionales: «realname» y «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>

Las páginas de destino «redirect» y «missing_fields_redirect» pueden alojarse en tu servidor.
Puedes añadir tantos campos como necesites; no se requiere ninguna configuración a nivel del servidor.

Ejemplo de envío de SMS a http

Para recibir mensajes SMS directamente en tu buzón de correo
Los routers Teltonika ofrecen la opción «Configuración de reenvío de SMS a HTTP».

Lo encontrarás en la interfaz web de Teltonika: Servicios > Utilidades móviles > Pasarela SMS.
!! El dominio del destinatario (tudominio.com) debe estar preautorizado por RealSender !!

Nombre del valor numérico: email

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

Nombre del valor del mensaje: message
Par de datos adicionales 1:  recipient | name@yourdomain.com
Par de datos adicionales 2:  subject   | Text-Message

Opción 1: utilizando DATOS MÓVILES

!! Se necesita una conexión 4G (LTE) para que RealSender funcione correctamente !!
Puedes configurarlo desde la interfaz web de Teltonika: Red > Móvil > Ajustes de la tarjeta SIM

Tipo de red: solo 4G (LTE)

Opción 2: utilizando los datos de la pasarela LAN

Puedes configurar la puerta de enlace de Internet para que pase por tu LAN.
Interfaz web de Teltonika: Red > LAN > INTERFACES DE RED > [editar]

Solo tienes que configurar la puerta de enlace IPv4 y los servidores DNS
Consulta el ejemplo siguiente (modifícalo con tus propios parámetros):

INTERFACES: LAN 
...
Puerta de enlace IPv4: 192.168.1.1
Servidores DNS:  8.8.8.8     !! obligatorio !!

La conexión de datos móviles se puede desactivar de varias maneras; consulta: Desactivar datos móviles.
Cuando se desactivan los datos móviles, el servicio de mensajes SMS sigue funcionando.

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

Ejemplo de un mensaje de correo electrónico recibido

Asunto: Mensaje de texto (+41790000000)

A continuación se muestra el mensaje de texto recibido. Fue enviado por:
 (+41790000000) el lunes, 26 de junio de 2023 a las 08:31:29 CEST
---------------------------------------------------------------------------

Mensaje de prueba

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

proxy inverso para servidores SMTP

Ventajas principales:

• Seguridad Puede bloquear solicitudes maliciosas, cifrar el tráfico,
  y proteger los servidores de backend frente a ataques directos.
• Rendimiento Distribuye el tráfico entrante entre varios servidores, lo que evita la sobrecarga
  de un solo servidor y garantiza una mayor disponibilidad.
• Escalabilidad Permite añadir o eliminar servidores de backend sin interrumpir el servicio,
  lo que permite gestionar el aumento del tráfico.

pasarela de correo electrónico certificada

El correo electrónico certificado es un tipo de correo electrónico que permite certificar el envío y la entrega de un mensaje y proporcionar acuses de recibo que pueden utilizarse frente a terceros.

Hay tres modos de funcionamiento, que también se pueden combinar, para permitir el envío de mensajes de correo electrónico a través del correo certificado:

• destinatarios con extensiones de dominio predefinidas (por ejemplo, pec.it, legalmail.it, pec.poste.it)
• direcciones de correo electrónico de destino con la extensión «.xx» (por ejemplo, nombrededominio.com.xx),
  la extensión «.xx» se elimina automáticamente
• determinados remitentes concretos (por ejemplo, facturas@…)

Estos mensajes de correo electrónico se envían a otro servidor que se autentica ante el servicio SMTP de correo electrónico certificado del cliente (como Aruba, Legalmail o Register, por citar algunos).

El remitente se cambia automáticamente a la dirección de correo electrónico certificada del cliente.

Los mensajes devueltos (por ejemplo, usuario desconocido o buzón lleno) se enviarán a la dirección de correo electrónico certificada indicada como remitente.

Las direcciones de correo electrónico incorrectas o que ya no sean válidas deben corregirse o eliminarse manualmente para evitar que se sigan enviando mensajes, ya que podrían activar los filtros antispam de los buzones de correo electrónico de los destinatarios.

correos electrónicos con texto de una sola línea

La aplicación «plainmail» reduce tus correos electrónicos a una sola línea de texto,
hace que desaparezcan los archivos adjuntos y, en su lugar, envía enlaces:

• Optimiza tus correos electrónicos
• Convertir archivos adjuntos de correo electrónico en enlaces

Optimiza tus correos electrónicos

Solo tienes que añadir «.plain» al dominio de correo electrónico de los destinatarios,
y recibirán únicamente el asunto:

Destinatario: email@example.com.plain
Asunto:   tu mensaje breve; se permiten emoticonos

Se ignorarán los contenidos adicionales del correo electrónico y los archivos adjuntos,
y, en su lugar, aparecerá el siguiente mensaje:

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

» Volver al inicio

Convertir archivos adjuntos de correo electrónico en enlaces

Solo tienes que escribir «[A]» en el asunto y añadir un archivo adjunto al correo electrónico.
La aplicación «plainmail» lo convertirá automáticamente en un enlace.

El dominio del enlace puede ser cualquier dominio o subdominio específico que desees utilizar.
El archivo se BORRARÁ al cabo de seis meses.

» Volver al inicio

notificaciones a la aplicación ntfy

¿Qué es ntfy?

ntfy (que se pronuncia «notify») funciona como un servicio de notificaciones de tipo «publicar-suscribirse», en el que se envía un mensaje a un «tema». Un smartphone o un ordenador que tenga instalada la aplicación ntfy y esté suscrito al mismo tema recibe el mensaje como una notificación push en tiempo real.

Esto permite enviar alertas instantáneas generadas por scripts, servidores o cualquier otro servicio, lo que permite a los usuarios recibir notificaciones sin necesidad de una configuración compleja.

Cómo funciona con RealSender:

• 
  Puedes publicar mensajes en un tema enviando un correo electrónico a una dirección específica. Por ejemplo, puedes publicar un mensaje enviando un correo electrónico a topic@ntfy.youremaildomain.com.
  El contenido del mensaje debe coincidir con el asunto del correo electrónico.
  Solo los usuarios de RealSender están autorizados a enviar correos electrónicos a esta dirección

• Suscriptores:
  reciben notificaciones a través de su smartphone u ordenador,
  siempre que tengan instalada la aplicación ntfy y estén suscritos al tema correspondiente

• Temas:
  Piensa en los temas como canales, con nombres únicos y flujos de eventos que se publican en ellos.
  No es necesario crear los temas de forma explícita; basta con elegir un nombre y utilizarlo.
  Los nombres de los temas son públicos, por lo que es recomendable elegir algo que no se pueda adivinar fácilmente

Una vez enviado el correo electrónico, el servidor de ntfy recibe el mensaje y lo almacena para los suscriptores de ese tema.
Un suscriptor (a través de la aplicación de ntfy) se conecta al tema y recibe el mensaje en tiempo real.

Se trata de un «sistema desacoplado»: los editores no necesitan conocer a sus suscriptores, y viceversa.
Esto simplifica su uso y gestión, tanto para el editor como para el suscriptor.

» Volver al inicio

Convertir archivos adjuntos de correo electrónico en enlaces

Solo tienes que escribir «[A]» en el asunto y añadir un archivo adjunto al correo electrónico.
La aplicación «plainmail» lo convertirá automáticamente en un enlace.

El dominio del enlace puede ser cualquier dominio o subdominio específico que desees utilizar.
El archivo se BORRARÁ al cabo de seis meses.

» Volver al inicio

mensajes a números de móvil

Conecta tu correo electrónico con el mundo móvil,
saca el máximo partido a las oportunidades de comunicación de tu empresa,
sin cambiar tus hábitos de trabajo:

• Envía mensajes de texto desde tu correo electrónico
• Recibe mensajes de texto en tu correo electrónico
• Responde a los mensajes de texto desde tu correo electrónico
• Convertir archivos adjuntos de correo electrónico en enlaces

Envía mensajes de texto desde tu correo electrónico

Las notificaciones push son la forma más eficaz de llegar rápidamente a tus clientes.
Con tasas de apertura muy elevadas (hasta un 95 %) y tasas de respuesta muy altas (hasta un 45 %).
– Fuente: estudio de Gartner sobre mensajes de texto, año 2019

Destinatario: mobilenumber@text.yourdomain.com
Asunto:   el contenido del mensaje de texto; se permiten los emoticonos

(el resto del contenido del correo electrónico y los archivos adjuntos se ignoran)

Te proporcionaremos un router industrial preconfigurado para tu operador de telefonía móvil.

El control del envío y la entrega de mensajes de texto debe realizarse a través del operador utilizado.
Nuestro sistema comprueba cada diez minutos que el router responde (comprueba la alimentación y la conexión a Internet).

Para evitar abusos, los mensajes deben enviarse a través de RealSender, utilizando remitentes preautorizados,
con la configuración «estricta» de SPF y DKIM. Más información sobre la autenticación del correo electrónico: nivel avanzado.

» Volver al inicio

Recibe mensajes de texto en tu correo electrónico

Las respuestas a los mensajes de texto se enviarán directamente a tu buzón de correo electrónico preferido,
, con un mensaje de correo electrónico como este:

Asunto: Mensaje de texto (+41790000000)

A continuación se muestra el mensaje de texto recibido. Fue enviado por
 (+41790000000) el lunes 29 de julio de 2025 a las 10:57:00 CEST
---------------------------------------------------------------------------

Mensaje de prueba

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

» Volver al inicio

Responde a los mensajes de texto desde tu correo electrónico

La aplicación «plainmail» de RealSender te permite enviar mensajes de texto directamente desde tu CORREO ELECTRÓNICO.

Así podrás responder desde tu aplicación de correo electrónico favorita.
La dirección del destinatario ya aparece rellenada con el número del remitente original:

Destinatario: mobilenumber@text.yourdomain.com
Asunto:   el contenido de la respuesta

(el resto del contenido del correo electrónico y los archivos adjuntos se ignoran)

De este modo, la comunicación entre la aplicación de correo electrónico y el dispositivo móvil puede continuar.

» Volver al inicio

Convertir archivos adjuntos de correo electrónico en enlaces

Solo tienes que escribir «[A]» en el asunto y añadir un archivo adjunto al correo electrónico.
La aplicación «plainmail» lo convertirá automáticamente en un enlace.

El dominio del enlace puede ser cualquier dominio o subdominio específico que desees utilizar.
El archivo se BORRARÁ automáticamente al cabo de seis meses.

» Volver al inicio