API 概述

RealSender 允许您通过 API（应用程序接口）发送电子邮件。

这样，您就可以直接从应用程序发送电子邮件，无需通过 SMTP（简单邮件传输协议）。目前我们仅支持POST 请求。

服务器地址：
https://rsXXX-api.realsender.com/mail/send

必填参数：

如果一切正常，消息将被发送，您将收到一条成功的 JSON 响应：
{"success":true}

如果出现错误，你会看到类似以下的内容：
{"success":false,"errorMsgs":["Please provide the 'subject' value."]}

API 详情

内容必须使用UTF-8 国际字符集发送。
要进行测试，请在主题中添加“€uro”并提交。如果字符集不正确，您将收到以下 JSON 警告：

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

根据您是否填写了“text”和“html”其中一个或两个字段，消息将使用以下其中一种“Content-Type”进行发送：

非必需/可选参数：

“收件人”、“抄送”和“密送”字段可以包含单个电子邮件地址，也可以包含以逗号分隔的电子邮件地址列表。
!! 在 RealSender 中，每封电子邮件的收件人总数限制为 25 个（最多可增加至 100 个）。

服务器的响应采用 JSON（JavaScript 对象表示法）格式：

API 示例

向
发送POST 请求 使用 PHP 实现（不使用 CURL）

<?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 请求
CURL 方法

curl -d 'apiuser=我们提供的用户名&apipass=我们提供的密码 you&from=sender@example.com&to=recipient@example.com&subject=邮件主题&text=纯文本格式的邮件正文&html=HTML格式的邮件正文'https://rsXXX-api.realsender.com/mail/send

带附件的 API 示例

带有附件的 POST 请求（最多 5 个：attach1、attach2、…）
使用 PHP 的非 CURL 方法

<?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 请求
CURL 方法

curl -F 'apiuser=我们提供的用户名' \
      -F 'apipass=我们提供的密码' \
      -F 'from=sender@example.com' \
      -F 'to=recipient@example.com' \
      -F 'subject=邮件主题' \
      -F 'text=纯文本格式的邮件正文' \
      -F 'html=HTML格式的邮件正文' \
      -F 'attach=@sample.pdf;type=application/pdf' \
      -F 'attach=@sample.txt;type=text/plain' \
      https://rsXXX-api.realsender.com/mail/send

概述

RealSender 允许您通过电子邮件轻松提交 HTTP 请求，例如网页表单内容。
这样，您就可以直接在邮箱中收到反馈表单的结果。

您无需进行任何特殊配置。
这些表单可以发布在任何 HTML 网页上，也可以直接添加到您的电子邮件中。

脚本地址：
<form action="https://rsXXX.realsender.com/script/form.pl" method="post" accept-charset="utf-8">

必填参数（隐藏字段）：

必填参数（非隐藏字段）：

详情

非必填/可选参数（隐藏字段）：

非必填/可选参数（非隐藏字段）：

表单提交将采用 UTF-8 国际字符集进行编码。
要进行测试，请在任意字段中输入“€uro”，提交表单，然后查看收到的电子邮件。

网页表单示例

这是一个简单的 HTML 网页表单示例
包含两个可选参数：“realname” 和 “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>

“redirect” 和 “missing_fields_redirect” 着陆页可以托管在您的服务器上。
您可以根据需要添加任意数量的字段，无需在服务器端进行任何设置。

向 http 发送短信的示例

如需直接在邮箱中接收短信，请访问
Teltonika 路由器提供了“短信转发至 HTTP 配置”选项。

您可以在 Teltonika WebUI 中找到该功能：服务 > 移动工具 > SMS 网关。
!! 收件人的域名（yourdomain.com）必须已获得 RealSender 的预授权 !!

数值名称：email

方法：Post
URL：    https://rsXXX.realsender.com/script/sms.pl

消息名称：message
附加数据对 1：  recipient | name@yourdomain.com
附加数据对 2：  subject   | Text-Message

选项 1 - 使用移动数据

!! 需连接 4G（LTE）网络才能正常使用 RealSender !!
您可以在 Teltonika WebUI 中进行设置：网络 > 移动网络 > SIM 卡设置

网络类型：仅支持 4G (LTE)

选项 2 - 使用局域网网关数据

您可以将互联网网关设置为通过局域网（LAN）进行连接。
Teltonika WebUI：网络 > LAN > 网络接口 > [编辑]

只需配置 IPv4网关和DNS 服务器
请参阅下面的示例（请根据实际情况修改参数）：

接口：局域网 (LAN) 
...
IPv4 网关：192.168.1.1
DNS 服务器：8.8.8.8     !! 必填 !!

可以通过几种方式禁用移动数据连接，请参阅：禁用移动数据。
当移动数据被禁用时，短信功能仍可正常使用。

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

收到的电子邮件示例

主题：短信 (+41790000000)

以下是收到的短信内容。该短信由
 (+41790000000) 于 2023 年 6 月 26 日星期一 08:31:29 CEST 提交
---------------------------------------------------------------------------

测试消息

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

谷歌新闻提醒

谷歌新闻是由谷歌开发和维护的一项新闻聚合服务。
该服务持续提供来自数千家出版商和杂志的文章链接。 该服务覆盖60多个国家和地区，支持35种以上的语言。

谷歌新闻网站会自动生成一份新闻列表
，内容来自（该网站所在国家/地区）的主要网络报纸
，并根据内容相似性将它们分组，按主题和文章发布日期进行排序。
新闻内容始终以简短摘要的形式发布。

emailcomposer 应用的“Google 新闻提醒”流程（
） 会提取 RSS 源，并按指定间隔，针对特定主题，向关联的收件人发送电子邮件通知（
）：

只需复制该流程，编辑第一个和最后一个节点，您就能实现
针对不同主题向多个收件人发送多条警报。

如果过去24小时内没有新消息，则不会发送任何消息。
“第一个主题”左侧的按钮可让您手动强制执行。

SMTP 状态检查

SMTP 状态检查用于验证您的邮件服务器的可用性、安全性和功能性。
该检查可确保服务器能够接受 TCP 连接、正确进行身份验证并处理电子邮件。

该检查已配置为每隔十分钟定期运行一次。
用户可以自行更改预设的间隔时间。

电子邮件编辑器应用的“SMTP 状态检查”流程
通过发送真实邮件来验证 SMTP 服务是否运行正常；
仅在出现故障时，系统才会发送警报邮件：

只需复制该流程，编辑第一个和最后一个节点，您就能通过
向不同 SMTP 服务器上的指定收件人发送多条警报。

用户名和密码在系统级别作为“环境变量”设置，用户无法读取它们。
第一个“companyname”节点左侧的按钮允许您手动强制执行
并在屏幕右侧的调试区域中查看结果：

网站状态检查

网站状态检查可验证您网站的可用性、SSL 安全性和功能性。
该服务会监控您的 Web 服务器的运行状况、SSL 证书的有效性以及网页的响应情况。

该检查已配置为每隔十分钟定期运行一次。
用户可以自行更改预设的间隔时间。

emailcomposer 应用的“网站状态检查”流程
会向该网站的地址发送一个 HTTP 请求并分析响应；
只有在出现故障时，系统才会发送警报邮件：

只需复制该流程，编辑第一个和最后一个节点，您就能通过
为不同的网站向指定收件人发送多条提醒。

第一个左侧的按钮 https://example.com node 允许您手动强制执行
并在屏幕右侧的调试区域中查看结果：

SMTP 服务器的反向代理

主要优势：

• 安全性 它能够拦截恶意请求、加密流量，
  并保护后端服务器免受直接攻击。
• 性能 它将传入的流量分配到多台服务器上，从而防止单台服务器过载
  并确保更高的可用性。
• 可扩展性 它允许您在不中断服务的情况下添加或移除后端服务器，
  从而能够应对不断增长的流量。

认证电子邮件网关

认证电子邮件是一种能够对邮件的发送和投递进行认证，并提供可用于对第三方主张权利的收据的电子邮件。

共有三种操作模式，这些模式也可以组合使用，以便通过认证电子邮件发送邮件：

• 具有预定义域名后缀的收件人（例如：pec.it、legalmail.it、pec.poste.it）
• 目标电子邮件地址的后缀为“.xx”（例如 domainname.com.xx），
  此时系统会自动移除“.xx”后缀
• 某些特定的发件人（例如：invoices@…）

这些电子邮件会被转发至另一台服务器，该服务器会通过客户的认证电子邮件 SMTP 服务（例如 Aruba、Legalmail、Register 等）进行身份验证。

发件人将自动更改为客户的认证电子邮件地址。

退信（例如：用户不存在/邮箱已满）将发送至作为发件人指定的认证电子邮件地址。

错误或已失效的电子邮件地址必须手动更正或删除，以防止继续发送邮件，因为这些地址可能会触发收件人邮箱中的垃圾邮件防护机制。

单行文本电子邮件

“plainmail” 应用将您的电子邮件简化为一行文本，
它会让电子邮件附件消失，转而发送链接：

• 精简你的电子邮件
• 将电子邮件附件转换为链接

精简你的电子邮件

只需在收件人的邮箱域名后添加“.plain”，例如
， 他们收到的邮件中将仅显示主题：

收件人：email@example.com.plain
主题：您的简短信息（允许使用表情符号）

电子邮件中的其他内容和附件将被忽略，
取而代之的是，将显示以下消息：

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

» 返回顶部

将电子邮件附件转换为链接

只需在邮件主题中填写“[A]”，并在邮件中添加附件。
“plainmail”应用会自动将其转换为链接。

链接中的域名可以是您希望使用的任何独立域名或子域名。
该文件将在六个月后被删除。

» 返回顶部

发送通知至 ntfy 应用

什么是 ntfy？

ntfy（发音为“notify”）作为一项“发布-订阅”通知服务， 用户可向某个“主题”发送消息。运行 ntfy 应用并 订阅了同一主题的智能手机或电脑将收到该消息，并以实时推送通知的形式显示。

这使得脚本、服务器或任何其他服务生成的即时警报能够及时送达， 用户无需进行复杂的配置即可接收通知。

在 RealSender 中的工作原理：

• 发布者：
  您可以通过向特定地址发送电子邮件，在某个主题下发布消息。 例如，您可以向topic@ntfy.youremaildomain.com 发送电子邮件来发布消息。
  消息内容与电子邮件的主题一致。
  只有 RealSender 用户才有权限向该地址发送电子邮件

• 订阅者：
  他们可通过智能手机或电脑接收通知，
  前提是已安装 ntfy 应用并订阅了相关主题

• 主题：
  可以将主题视为频道，它们拥有唯一的名称，并会在其中发布事件流。
  您无需显式创建主题；只需选择一个名称并直接使用即可。
  主题名称是公开的，因此建议选择难以被猜到的名称

邮件发送后，ntfy 服务器会接收该消息，并将其存储供该主题的订阅者查阅。
订阅者（通过 ntfy 应用）已连接到该主题，并能实时接收消息。

这是一个“解耦系统”，发布者无需了解订阅者，反之亦然。
这简化了其使用和管理，无论对发布者还是订阅者而言都是如此。

» 返回顶部

将电子邮件附件转换为链接

只需在邮件主题中填写“[A]”，并在邮件中添加附件。
“plainmail”应用会自动将其转换为链接。

链接中的域名可以是您希望使用的任何独立域名或子域名。
该文件将在六个月后被删除。

» 返回顶部

发送至手机号码的消息

将您的电子邮件与移动世界连接起来，
最大限度地拓展您的商务沟通机会，
无需改变您的工作习惯：

• 通过电子邮件发送短信
• 在电子邮件中接收短信
• 通过电子邮件回复短信
• 将电子邮件附件转换为链接

通过电子邮件发送短信

推送通知是快速触达客户的最有效方式。
其打开率极高（高达95%），响应率也位居前列（高达45%）。
– 来源：Gartner关于短信的研究报告，2019年

收件人：mobilenumber@text.yourdomain.com
主题：短信内容，允许使用表情符号

（邮件中的其他内容及附件将被忽略）

我们将为您提供一台已针对您的移动运营商预先配置好的工业路由器。

短信的发送和投递必须通过所使用的运营商进行控制。
我们的系统每隔十分钟会检查路由器是否正常响应（请检查电源和网络连接）。

为防止滥用，邮件必须通过 RealSender 发送，并使用预授权发件人（
）， 同时启用 SPF 和 DKIM 的“严格”对齐模式。了解更多关于电子邮件认证的详细信息。

» 返回顶部

在电子邮件中接收短信

短信回复将直接发送到您指定的邮箱
， 邮件内容如下：

主题：短信 (+41790000000)

以下是收到的短信内容。该短信由
 (+41790000000) 于 2025 年 7 月 29 日星期一 10:57:00（中欧夏令时）提交
---------------------------------------------------------------------------

测试消息

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

» 返回顶部

通过电子邮件回复短信

RealSender 的“plainmail”应用可让您直接通过电子邮件发送短信。

这样您就可以通过自己常用的邮件客户端进行回复。
收件人地址栏已自动填入原始发件人的号码：

收件人：mobilenumber@text.yourdomain.com
主题：回复内容

（邮件中的其他内容及附件将被忽略）

因此，电子邮件应用与移动设备之间的通信可以继续进行。

» 返回顶部

将电子邮件附件转换为链接

只需在邮件主题中填写“[A]”，并在邮件中添加附件。
“plainmail”应用会自动将其转换为链接。

链接中的域名可以是您希望使用的任何独立域名或子域名。
该文件将在六个月后自动删除。

» 返回顶部