# Tambah pelanggan ke dalam mailing list Mail Niaga

> Sambungkan Mail Niaga kepada BCL dan guna automasi untuk menambah setiap pelanggan yang membayar, lead atau affiliate ke dalam mailing list anda.
>
> Source: https://docs.bcl.my/ms/mail-niaga/

Mail Niaga ialah servis pemasaran e-mel Web Impian. Sambungkannya kepada BCL, kemudian guna automasi untuk menambah setiap pelanggan yang membayar, setiap lead baru atau setiap affiliate baru ke dalam mailing list Mail Niaga. Selepas itu anda hantar newsletter dan e-mel susulan dari Mail Niaga.

## Sambungkan Mail Niaga

Anda memerlukan akaun Mail Niaga ([mailniaga.com](https://mailniaga.com)). BCL berfungsi dengan kedua-dua versi:

| Versi | Dashboard | Apa yang anda copy |
| --- | --- | --- |
| **Mail Niaga v1** | [newsletter.aplikasiniaga.com](https://newsletter.aplikasiniaga.com/) | **API Key** dan **Brand ID** |
| **Mail Niaga v2** | [manage.mailniaga.com](https://manage.mailniaga.com/) | **API Token** |

1. Di sidebar, pergi ke **Platform Setup** → **Integrations** dan buka tab **Mail Niaga (Automation)**.

   *(Screenshot: Page Integrations dengan tab Mail Niaga (Automation) ditanda)*

2. Dalam bahagian untuk versi anda, on-kan **Enable Mail Niaga v2** atau **Enable Mail Niaga v1**.
3. Untuk v2, paste **API Token** anda dan klik **Verify Connection**. BCL memaparkan **Connection Successful** bersama bilangan mailing list yang dijumpai.

   *(Screenshot: Bahagian Mail Niaga v2 dengan Verify Connection ditanda di sebelah API Token)*

4. Untuk v1, paste **API Key** anda, isi **Brand ID** anda, kemudian klik **Verify Connection**.

   *(Screenshot: Bahagian Mail Niaga v1 dengan ruangan Brand ID ditanda)*

5. Klik **Save Mail Niaga Configuration**.

   *(Screenshot: Butang Save Mail Niaga Configuration ditanda)*

> **Note**
> Tab itu menyatakan pelanggan akan dilanggankan secara automatik selepas bayaran berjaya. Ini hanya berlaku selepas anda menambah automasi dengan langkah **Add to Mail Niaga**, seperti di bawah.

## Tambah orang ke dalam senarai dengan automasi

Cipta automasi dengan trigger yang sesuai, seperti **Payment Successful** untuk pelanggan, **New Lead Received** untuk lead atau **Affiliate Joined** untuk affiliate (lihat [Cipta automasi](/ms/create-automation/)). Kemudian:

1. Dalam workflow builder, tambah action dan pilih **Add to Mail Niaga** di bawah **Integrations**.

   *(Screenshot: Senarai Add Action dengan Add to Mail Niaga ditanda di bawah Integrations)*

2. Double-click langkah baru itu untuk membuka **Mail Niaga Action Settings** dan pilih **Mail Niaga Version** anda.
3. Kekalkan `{name}` dalam **Subscriber Name** dan `{email}` dalam **Email Address**, atau klik **Variables** untuk memilih ruangan lain.
4. Klik ikon refresh di sebelah **Mailing List** untuk memuatkan senarai anda, kemudian pilih satu.

   *(Screenshot: Mail Niaga Action Settings dengan ikon refresh di sebelah Mailing List ditanda)*

5. Pilihan, v2 sahaja: di bawah **Custom Field Mapping**, klik **Add Field Mapping** untuk mengisi ruangan senarai yang lain, seperti nombor telefon, daripada variable.
6. Pilihan: masukkan **Test Email** dan **Test Name** anda sendiri, kemudian klik **Test Add Subscriber** untuk memastikan langkah itu menambah anda ke dalam senarai.
7. Klik **Save Mail Niaga**, kemudian simpan automasi itu dan pastikan ia di-on-kan (butang di bahagian atas memaparkan **Deactivate**).

## Tips

Sedikit perancangan memastikan senarai anda berguna:

- **Mula daripada template.** Template **Welcome New Affiliate** sudah ada langkah **Add to Mail Niaga**; lihat [Alu-alukan affiliate baru](/ms/automation-affiliate-welcome/).
- **Guna satu senarai untuk setiap tujuan.** Menambah pembeli, lead dan affiliate ke dalam senarai berasingan memastikan newsletter anda relevan dan memudahkan pengurusan unsubscribe.
- **Semak Automation History apabila seseorang tiada dalam senarai.** Setiap run menunjukkan sama ada langkah **Add to Mail Niaga** berjaya atau ralat yang Mail Niaga pulangkan. Lihat [Semak sejarah automasi](/ms/automation-history/).

## Isu biasa

### Kenapa tiada pelanggan dalam senarai saya walaupun saya sudah menyambungkan Mail Niaga?

Menyambungkan Mail Niaga tidak menambah sesiapa dengan sendirinya. Cipta automasi, contohnya dengan trigger Payment Successful, dan tambah langkah Add to Mail Niaga yang menghala ke Mailing List anda.

### Patutkah saya guna Mail Niaga v1 atau v2?

Guna versi akaun anda. Akaun Mail Niaga v1 log masuk di newsletter.aplikasiniaga.com dan memerlukan API Key dan Brand ID; akaun Mail Niaga v2 log masuk di manage.mailniaga.com dan memerlukan API Token.

### Ruangan Mailing List kosong dalam automasi saya. Apa yang perlu saya buat?

Klik ikon refresh di sebelah Mailing List untuk memuatkan senarai anda. Jika tiada apa yang dimuatkan, pastikan versi yang anda pilih dalam Mail Niaga Version sudah disambungkan dan disimpan di bawah Platform Setup → Integrations → Mail Niaga (Automation).