# Trigger automasi

> Setiap event yang boleh memulakan automasi BCL, bila setiap trigger berjalan, dan filter yang ditawarkan oleh setiap trigger.
>
> Source: https://docs.bcl.my/ms/automation-triggers/

Setiap automasi bermula dengan satu trigger, iaitu event yang menyebabkan automasi itu berjalan. BCL ada 15 trigger dalam empat kumpulan. Anda pilih satu trigger apabila anda klik **Add Node** pada canvas kosong, dan double-click trigger itu kemudian untuk mengecilkan skopnya.

*(Screenshot: Panel Select Trigger Event dengan kumpulan Leads, Payments, Events dan Affiliate)*

## Trigger bayaran

Trigger ini berjalan untuk payment form, event form, booking form dan bayaran QR Terminal. Page senarai memaparkan nama trigger dalam lajur **Trigger type**, dan kadangkala namanya berbeza sedikit daripada nama pada canvas.

| Trigger (canvas) | Trigger type (senarai) | Berjalan apabila |
| --- | --- | --- |
| **Payment Initiated** | Transaction Created | Pelanggan menghantar form dan BCL mencipta transaksi, sebelum pelanggan membayar. |
| **Payment Successful** | Transaction Success | Bayaran berjaya. Pesanan percuma, dan pesanan COD atau pindahan manual yang anda tandakan sebagai berjaya, juga dikira. |
| **Payment Failed** | Transaction Failed | Bank menolak bayaran itu atau bayaran pelanggan gagal. |
| **Payment Cancelled** | Transaction Cancelled | BCL membatalkan transaksi yang belum dibayar secara automatik, kira-kira 30 minit selepas transaksi itu dimulakan. Pesanan COD dan pindahan manual tidak pernah dibatalkan secara automatik. |
| **Payment Completed** | Transaction Completed | Anda tandakan pesanan yang berjaya sebagai **Completed**, contohnya dengan **Mark As Completed** pada senarai transaksi. |
| **Status Changed** | Status Changed | Status transaksi berubah, walau apa pun perubahannya. |
| **Order Shipped** | Order Shipped | Nombor tracking ditambah pada pesanan melalui integrasi kurier. |

Setiap trigger bayaran kecuali **Order Shipped** ada dua filter:

| Filter | Fungsinya |
| --- | --- |
| **Payment Source Type** | **All Sources**, **Payment Form**, **Event Form**, **Booking Form** atau **QR Terminal**. |
| **Specific Form** | Dipaparkan untuk payment form, event form dan booking form. Pilih satu atau lebih form, atau biarkan kosong untuk semua form jenis itu. |

**Status Changed** juga ada **Status Filter** dengan **From Status** dan **To Status**. Setiap satu boleh jadi **Any**, **Pending**, **Failed**, **Successful**, **Cancelled** atau **Completed**. **Order Shipped** tiada filter: trigger ini berjalan untuk setiap pesanan yang mendapat nombor tracking.

> **Note**
> Bayaran yang gagal menyebabkan **Payment Failed** dan **Status Changed** berjalan. Jika anda bina satu automasi pada setiap trigger itu, kedua-duanya berjalan.

## Trigger lead, event & affiliate

Trigger ini datang daripada lead form, pendaftaran event dan program affiliate.

| Trigger (canvas) | Trigger type (senarai) | Berjalan apabila | Filter |
| --- | --- | --- | --- |
| **New Lead Received** | Form Submitted | Pelawat menghantar lead form. | **Lead Form** (kosong bermakna semua lead form) |
| **Participant Created** | Participant Created | Peserta event dicipta selepas bayaran berjaya, satu untuk setiap tiket. | **Specific Event Form** |
| **Participant Checked In** | Participant Checked In | Peserta membuat check-in di event. | **Specific Event Form** |
| **Certificate Generated** | Certificate Generated | Sijil dijana untuk peserta. | **Specific Event Form** |
| **Referral Approved** | Referral Approved | Anda meluluskan referral affiliate. | Tiada |
| **Referral Rejected** | Referral Rejected | Anda menolak referral affiliate. | Tiada |
| **New Affiliate Registered** | Affiliate Joined | Seseorang menyertai program affiliate anda. | Tiada |
| **Payout Requested** | Payout Request | Affiliate meminta payout. | Tiada |

## Data yang dihantar oleh setiap trigger

Setiap trigger menghantar datanya kepada langkah seterusnya dalam workflow sebagai variable, seperti `{name}` dan `{amount}` untuk bayaran atau `{attendee_email}` untuk peserta. [Variable automasi](/ms/automation-variables/) menyenaraikan variable untuk setiap trigger.

Trigger juga menentukan penerima default yang BCL masukkan dalam langkah mesej yang baru:

| Trigger | E-mel default | Telefon default |
| --- | --- | --- |
| Trigger bayaran | `{email}` | `{phone}` |
| Trigger event | `{attendee_email}` | `{attendee_phone}` |
| Trigger affiliate | `{affiliate_email}` | `{affiliate_phone}` |
| **New Lead Received** | Tiada: guna ruangan form seperti `{email_address:2}` | Tiada |

## Tukar trigger

Untuk menukar trigger tanpa membina semula workflow, double-click trigger itu dan klik ikon refresh di sebelah **Trigger Event** (**Change Trigger**). Pilih trigger baru daripada senarai. Filter trigger itu di-reset, jadi buka trigger itu sekali lagi untuk menetapkan filter.

## Jalankan automasi pada rekod lama

Trigger hanya berjalan untuk event baru. Untuk rekod yang sudah ada, buka automasi itu, klik **Overview**, kemudian **Actions**:

- **Past Transactions** menjalankan automasi untuk transaksi yang dicipta antara dua tarikh. Pilihan ini ditawarkan untuk setiap trigger bayaran kecuali **Status Changed** dan **Order Shipped**, dan hanya memilih transaksi yang statusnya sepadan dengan trigger.
- **Past Participants** melakukan perkara yang sama untuk trigger event.

Setiap rekod hanya diproses sekali untuk setiap automasi. Lihat [Semak sejarah automasi](/ms/automation-history/) untuk hasilnya.

## Isu biasa

### Apa beza antara Automations dengan Notification Settings sesuatu form?

Notification Settings mengawal e-mel standard yang BCL hantar untuk satu form. Automasi bermula daripada trigger, seperti Payment Successful, dan menjalankan langkah anda sendiri untuk setiap form yang sepadan, jadi satu automasi boleh meliputi semua form anda.

### Saya hanya mahu automasi ini untuk satu form. Di mana saya pilih form itu?

Double-click trigger pada canvas. Trigger bayaran ada Payment Source Type dan Specific Form, trigger event ada Specific Event Form, dan New Lead Received ada Lead Form. Biarkan form kosong untuk meliputi semua form jenis itu.

### Kenapa automasi Payment Cancelled saya berjalan walaupun pelanggan tidak pernah tekan cancel?

Payment Cancelled berjalan apabila BCL membatalkan bayaran yang belum dibayar secara automatik, kira-kira 30 minit selepas bayaran itu dimulakan. Ia tidak menunggu pelanggan menekan apa-apa.