# Hantar notifikasi SMS dengan SMS Niaga

> Sambungkan SMS Niaga kepada BCL, hantar SMS kepada pelanggan dan diri anda apabila bayaran berjaya atau gagal, dan dapat amaran sebelum kredit habis.
>
> Source: https://docs.bcl.my/ms/sms-niaga/

SMS Niaga ialah servis SMS Web Impian. Selepas anda menyambungkan akaun SMS Niaga anda, BCL boleh menghantar SMS kepada pelanggan anda, kepada anda, atau kepada kedua-duanya, apabila bayaran berjaya atau gagal. Mesej menggunakan kredit dan sender ID SMS Niaga anda sendiri.

## Sambungkan SMS Niaga

Anda memerlukan akaun SMS Niaga yang ada kredit. Daftar di [smsniaga.com](https://smsniaga.com), kemudian copy API key anda dari [dashboard SMS Niaga](https://manage.smsniaga.com/). Dalam BCL:

1. Di sidebar, pergi ke **Platform Setup** → **Integrations**.

   *(Screenshot: Menu Platform Setup di sidebar BCL, dengan Integrations ditanda)*

2. Tab **SMS (SMSNiaga)** dibuka dahulu. On-kan **Enable SMS Notifications**.

   *(Screenshot: Tab SMS (SMSNiaga) dengan suis Enable SMS Notifications ditanda)*

3. Paste key anda ke dalam **SMS API Key** dan klik **Verify Connection**. BCL memaparkan **Connection Successful** bersama baki semasa anda. Semakan ini juga memerlukan **Admin Phone Number** di bawahnya diisi.

   *(Screenshot: Bahagian SMS Notification (SMS Niaga) dengan Verify Connection ditanda)*

4. Pilihan: klik ikon refresh di sebelah **Sender ID** dan pilih nama pengirim yang pelanggan anda nampak. Biarkan pada **Use default sender** untuk menggunakan pengirim default SMS Niaga anda.

   *(Screenshot: Ruangan Sender ID dengan ikon refresh ditanda, di atas Admin Phone Number)*

5. Masukkan **Admin Phone Number** yang patut menerima notifikasi admin anda, atau klik ikon anak panah (**Use Team Phone**) untuk copy nombor telefon team anda.
6. Pilihan: tetapkan **Low Credit Reminder** (lihat di bawah), kemudian klik **Save SMS Configuration**.

   *(Screenshot: Ruangan Low Credit Reminder di atas butang Save SMS Configuration yang ditanda)*

## On-kan SMS untuk sesuatu form

Anda pilih mesej mana yang dihantar pada setiap form. Selagi SMS Niaga belum disambungkan, tab itu memaparkan **SMS Niaga: Not Ready** dan suisnya berwarna kelabu.

1. Buka form itu, contohnya di bawah **Payments** → **Forms**, dan klik **Edit**.
2. Klik **Notifications**, kemudian tab SMS:

   | Form | Tab |
   | --- | --- |
   | Payment form dan event form | **SMS Notifications** |
   | Booking form | **SMS Niaga** |
   | Lead form | **Additional** → **SMS Notifications**, lihat [Dapatkan notifikasi untuk lead baru](/ms/lead-form-notifications/) |

   *(Screenshot: Page Edit Notification Settings dengan tab SMS Notifications ditanda)*

3. On-kan mesej yang anda mahu: **Enable Success SMS (Customer)**, **Enable Failed SMS (Customer)**, **Enable Success SMS (Admin)** dan **Enable Failed SMS (Admin)**. Mesej admin dihantar ke **Admin Phone Number** dari Integrations.
4. Tulis setiap template, atau klik **Use Default** untuk template yang sudah siap. Klik **Variables** untuk melihat placeholder seperti `{name}`, `{amount}`, `{form_title}` dan `{reference_id}`.
5. Klik **Save Notification Settings**.

Template SMS mengikut peraturan SMS Niaga:

- Sehingga 160 aksara. Mesej yang lebih panjang menggunakan 2 kredit.
- Aksara biasa sahaja: tiada emoji, huruf beraksen atau simbol khas.
- Tiada link. Mesej yang ada URL tidak dihantar, dan kreditnya tidak dipulangkan.

## Dapatkan amaran kredit rendah

BCL menyemak baki SMS Niaga anda sekali sehari. Apabila baki jatuh di bawah jumlah **Low Credit Reminder** anda, team owner menerima e-mel dan notifikasi loceng dengan baki itu dan butang **Top up at SMSNiaga**. Jika anda tidak top up, peringatan kedua dihantar 3 hari kemudian dan peringatan terakhir 7 hari selepas itu. Biarkan ruangan itu kosong untuk menggunakan nilai default yang dipaparkan di bawahnya, atau masukkan 0 untuk off-kan peringatan.

> **Caution**
> Pada RM 0, semua SMS berhenti dihantar, termasuk resit pelanggan. Top up sebelum peringatan terakhir.

## Hantar SMS dari automasi

Notifikasi form hanya dihantar apabila bayaran berjaya atau gagal. Untuk masa lain, seperti peringatan sebelum kelas, atau untuk menambah pelanggan ke dalam group SMS Niaga untuk broadcast kemudian, guna automasi:

1. Dalam workflow builder automasi itu, tambah action dan pilih **SMS Niaga** di bawah **Messaging**.

   *(Screenshot: Senarai Add Action dengan SMS Niaga ditanda di bawah Messaging)*

2. Double-click langkah baru itu. Dalam **SMS Niaga Action Settings**, pilih **Action Type**: **Send SMS** atau **Add Subscriber to Group**. Jika SMS Niaga belum disambungkan, satu notis memberi link ke tetapan Integration anda.

   *(Screenshot: SMS Niaga Action Settings dengan notis belum disambungkan, Action Name dan Action Type)*

3. Isi ruangan-ruangannya dan klik **Save SMS Niaga**. [Action automasi](/ms/automation-actions/) menyenaraikan setiap ruangan.

## Tips

Beberapa tabiat ini memastikan SMS anda boleh diharap:

- **Pastikan mesej pelanggan pendek dan tanpa link.** Letakkan link resit dalam e-mel atau mesej WhatsApp, kerana SMS Niaga tidak menghantar mesej yang ada URL.
- **Guna sender ID yang pelanggan anda kenal.** Nama pengirim yang biasa dilihat menjadikan mesej bayaran kurang berkemungkinan diabaikan atau disangka spam.
- **Semak Notification Logs apabila pelanggan kata tiada SMS yang sampai.** **Tools** → **Notification Logs** menyenaraikan setiap SMS yang BCL hantar, bersama penerima dan statusnya.

## Isu biasa

### Kenapa suis SMS pada form saya berwarna kelabu?

SMS Niaga belum disambungkan. On-kan Enable SMS Notifications di bawah Platform Setup → Integrations → SMS (SMSNiaga), paste SMS API Key anda, klik Save SMS Configuration, kemudian muat semula form itu.

### Pelanggan saya tidak menerima SMS. Apa yang perlu saya semak?

Semak kredit SMS Niaga anda dahulu: pada RM 0, tiada SMS dihantar. Kemudian pastikan template itu tiada link, hanya aksara biasa, dan pelanggan itu ada memasukkan nombor telefon. Tools → Notification Logs memaparkan setiap SMS yang BCL cuba hantar dan statusnya.

### Bagaimana saya hentikan e-mel kredit rendah?

Tetapkan Low Credit Reminder kepada 0 di bawah Platform Setup → Integrations → SMS (SMSNiaga) dan klik Save SMS Configuration. Top up juga menghentikan e-mel itu sehingga baki turun semula.