如何将 SMSAPI 连接到 easySales：完整设置指南

连接 SMSAPI 能为你带来什么

SMSAPI 是一项预付费短信服务。连接 easySales 后，它会就订单向你的顾客发送短信：订单确认、带跟踪链接的运单号、发票、取消、退货。消息会在事件发生时自动发出，也可以通过自动化流程发出，或在订单页面手动发送。

两张 SMSAPI 卡片——选择适合你账户的那张

SMSAPI 运营两项独立的服务，easySales 为每项服务各提供一张卡片：

• 带罗马尼亚国旗的 SMSAPI 卡片（SmsApi Romania）适用于 portal.smsapi.ro 上的账户。你用 API 令牌连接它，并添加送达回调。
• 不带国旗的 SMSAPI 卡片（SmsApi）适用于 smsapi.pl 上的账户。你通过在 easySales 中登录 SMSAPI 来连接它——无需复制令牌。

一项服务的账户无法在另一张卡片上使用。请按照本指南中与你的卡片对应的部分操作，然后继续设置发件人名称和通知规则，这两部分对两张卡片都相同。

开始之前

SMSAPI 罗马尼亚（portal.smsapi.ro）

第 1 步 — 创建 API 令牌

1. 在 portal.smsapi.ro 中，进入 API Settings → API tokens (OAuth)，点击 Generate access token。
2. 给它起一个你能认出的名称，例如 SmsApi Romania easySales。
3. 令牌的到期日期选择 Never，并启用所有权限。
4. 复制令牌：你将在第 3 步把它粘贴到 easySales 中。

第 2 步 — 添加回调地址

SMSAPI 通过回调告诉 easySales 每条短信是否已送达。没有回调，短信记录永远不会把你的消息显示为已送达。

1. 在 portal.smsapi.ro 中，进入 Callback URLs，点击 Add callback address。
2. Type 选择 Callback address - SMS DLR。
3. URL 中准确填写 https://easy-sales.com/services/sms/external-webhooks/smsapi-ro/status-update ——使用 https，末尾不加斜杠。

第 3 步 — 在 easySales 中连接卡片

进入 整合方式 → 短信服务，在带罗马尼亚国旗的卡片上点击 连接——如果之前已经连接过，则点击 编辑。填写一个你能认出的 别名，把令牌粘贴到 令牌 中，然后点击 保存。

保存 只会存储令牌，不会检查它。要检查令牌，请打开已保存的连接，点击 测试链接：输入你自己的手机号码，带国家代码，只填数字——例如 40722123456——然后点击 继续。easySales 会发送一条真实的短信，费用从你的 SMSAPI 余额中扣除；收到短信，就说明连接正常。如果 SMSAPI 拒绝发送，则会显示 SMSAPI 给出的原因。

SMSAPI 波兰（smsapi.pl）

第 1 步 — 在 easySales 中登录 SMSAPI

1. 进入 整合方式 → 短信服务，在不带国旗的 SMSAPI 卡片上点击 连接。
2. 点击 认证。SMSAPI 登录页面会打开：用你的 smsapi.pl 账户登录，并允许 easySales 通过该账户发送短信。
3. SMSAPI 会把你带回 短信服务，此时卡片已连接。

第 2 步 — 为连接命名

再次打开连接，填写一个你能认出的 别名——在通知规则中你将按它选择连接——然后点击 保存。

点击 测试链接 给自己发送一条测试短信：输入带国家代码的手机号码，只填数字——例如 48601234567——然后点击 继续。测试短信是真实的，费用从你的 SMSAPI 余额中扣除。

你的发件人名称

顾客看到的短信来自你的 SMSAPI 账户的默认发件人名称。要以你的店铺名称发送，请在你的 SMSAPI 账户中注册该名称——portal.smsapi.ro 上为 Sender names，smsapi.pl 上为 Pola nadawcy——并在 SMSAPI 审核通过后将其设为默认。发件人名称为 4 到 11 个字符——字母、数字和少数符号，例如 .、&、@ 或空格。顾客无法回复发件人名称。

选择发送哪些消息

通知规则会在订单发生变化时发送短信：创建了标签，订单被创建、开具发票、取消或完成，配送状态变化，创建了退货。先在模板页面 顾客 → 通知事项 的 短信 选项卡中编写消息，然后在通知页面 顾客 → 通知事项 中，在你需要的事件下创建规则。

• 选择服务 ——规则发送所用的短信服务：你连接的 SMSAPI 卡片，以及该连接的 别名。
• 发送以下渠道的消息 ——勾选每个其订单应收到短信的 marketplace 和网店。未勾选渠道的订单什么也收不到。
• 选择合适的模板 ——短信的内容。

消息也可以通过自动化流程发出，使用操作 发送订单短信通知，或在订单页面用 通知用户 手动发送。短信会发送到顾客的电话号码，并按收货地址所在国家转换为国际格式。

查看已发送的内容

easySales 发送的消息都会列在 顾客 → 短信记录 中，显示订单、顾客和内容。使用 SMSAPI 罗马尼亚卡片并设置好回调后，短信到达顾客手机时状态变为 已交付，网络无法投递时变为 未交付。

短信未发出时

在 测试链接 或短信记录中最常见的消息：