# 用SMS Niaga发送短信通知

> 把SMS Niaga账号连接到BCL，付款成功或失败时发短信给顾客和你自己，余额不足前也会提醒你。
>
> Source: https://docs.bcl.my/zh/sms-niaga/

SMS Niaga是Web Impian的短信服务。连接你的SMS Niaga账号后，付款成功或失败时，BCL可以发短信给你的顾客、你自己，或两者都发。短信使用你自己的SMS Niaga余额和sender ID。

## 连接SMS Niaga

你需要一个有余额的SMS Niaga账号。在[smsniaga.com](https://smsniaga.com)注册，然后从[SMS Niaga仪表板](https://manage.smsniaga.com/)复制你的API key。在BCL：

1. 在侧边栏前往**Platform Setup** → **Integrations**。

   *(Screenshot: BCL侧边栏的Platform Setup菜单，Integrations已标示)*

2. 第一个打开的是<strong>SMS (SMSNiaga)</strong>标签页。开启**Enable SMS Notifications**。

   *(Screenshot: SMS (SMSNiaga)标签页，Enable SMS Notifications开关已标示)*

3. 把key粘贴到**SMS API Key**，点击**Verify Connection**。BCL会显示**Connection Successful**和你目前的余额。这个检查也需要先填好下方的**Admin Phone Number**。

   *(Screenshot: SMS Notification (SMS Niaga)部分，Verify Connection已标示)*

4. 你也可以点击**Sender ID**旁的刷新图标，选择顾客看到的发件人名称。保持**Use default sender**就会使用SMS Niaga的默认发件人。

   *(Screenshot: Sender ID栏位和它的刷新图标已标示，下方是Admin Phone Number)*

5. 输入接收管理员提醒的**Admin Phone Number**，或点击箭头图标（**Use Team Phone**）复制你团队的电话号码。
6. 你也可以设置**Low Credit Reminder**（见下文），然后点击**Save SMS Configuration**。

   *(Screenshot: Low Credit Reminder栏位，下方的Save SMS Configuration按钮已标示)*

## 为表单开启短信

要发送哪些信息，在每个表单分别选择。在连接SMS Niaga之前，标签页会显示<strong>SMS Niaga: Not Ready</strong>，开关也是灰色的。

1. 打开表单，例如在**Payments** → **Forms**下，点击**Edit**。
2. 点击**Notifications**，再点击短信标签页：

   | 表单 | 标签页 |
   | --- | --- |
   | 付款表单和活动表单 | **SMS Notifications** |
   | 预约表单 | **SMS Niaga** |
   | lead表单 | **Additional** → **SMS Notifications**，请看[接收新lead通知](/zh/lead-form-notifications/) |

   *(Screenshot: Edit Notification Settings页面，SMS Notifications标签页已标示)*

3. 开启你要的信息：<strong>Enable Success SMS (Customer)</strong>、<strong>Enable Failed SMS (Customer)</strong>、<strong>Enable Success SMS (Admin)</strong>和<strong>Enable Failed SMS (Admin)</strong>。管理员信息会发到Integrations里的**Admin Phone Number**。
4. 写好每个模板，或点击**Use Default**使用现成的模板。点击**Variables**查看变量，例如`{name}`、`{amount}`、`{form_title}`和`{reference_id}`。
5. 点击**Save Notification Settings**。

短信模板要遵守SMS Niaga的规则：

- 最多160个字符。更长的短信会扣2条的余额。
- 只能用普通字符：不能有emoji、重音符号或特殊符号。
- 不能有链接。含有网址的短信不会发出，扣掉的余额也不会退回。

## 接收余额不足提醒

BCL每天检查一次你的SMS Niaga余额。余额低于你设定的**Low Credit Reminder**金额时，团队拥有者会收到一封电邮和一个铃铛通知，里面有余额和**Top up at SMSNiaga**按钮。如果你没有充值，3天后会再提醒一次，再过7天会发出最后一次提醒。留空这个栏位就使用它下方显示的默认值，输入0就关闭提醒。

> **Caution**
> 余额RM 0时，所有短信都会停止发送，包括顾客的收据。请在最后一次提醒之前充值。

## 通过自动化发送短信

表单通知只在付款成功或失败时发送。如果要在其他时间点发送，例如上课前的提醒，或把顾客加入SMS Niaga群组以便日后群发，请使用自动化：

1. 在自动化的工作流程编辑器里添加一个操作，在**Messaging**下选择**SMS Niaga**。

   *(Screenshot: Add Action列表，Messaging下的SMS Niaga已标示)*

2. 双击新的步骤。在**SMS Niaga Action Settings**选择**Action Type**：**Send SMS**或**Add Subscriber to Group**。如果SMS Niaga还没有连接，会出现一条提示，带你前往Integration设置。

   *(Screenshot: SMS Niaga Action Settings，显示未连接提示、Action Name和Action Type)*

3. 填写栏位，点击**Save SMS Niaga**。[自动化操作](/zh/automation-actions/)列出了每个栏位。

## 小贴士

几个好习惯，让你的短信更可靠：

- **顾客短信要简短，不放链接**。SMS Niaga会丢弃含有网址的短信，所以请把收据链接放在电邮或WhatsApp信息里。
- **使用顾客认得的sender ID**。熟悉的发件人名称让付款信息比较不会被忽略或当成垃圾短信。
- **顾客说没收到时，查看Notification Logs**。**Tools** → **Notification Logs**列出BCL发送的每条短信，包括收件人和状态。

## 常见问题

### 表单上的短信开关是灰色的，为什么？

SMS Niaga还没有连接。在Platform Setup → Integrations → <strong>SMS (SMSNiaga)</strong>开启Enable SMS Notifications，粘贴你的SMS API Key，点击Save SMS Configuration，再重新加载表单。

### 顾客没有收到短信，我要检查什么？

先检查你的SMS Niaga余额：余额RM 0时，什么都发不出去。然后确认模板里没有链接，只有普通字符，而且顾客有填写电话号码。Tools → Notification Logs会显示BCL尝试发送的每条短信和它的状态。

### 怎样停止余额不足的提醒电邮？

在Platform Setup → Integrations → <strong>SMS (SMSNiaga)</strong>把Low Credit Reminder设为0，然后点击Save SMS Configuration。充值后也会停止发送，直到余额再次下降。