# Mulakan automasi dari aplikasi lain

> Guna trigger Webhook Received untuk mendapat link peribadi. Apabila Zapier, Make atau laman web anda menghantar data ke link itu, automasi berjalan.
>
> Source: https://docs.bcl.my/ms/automation-webhook-received/

Kebanyakan automasi bermula daripada sesuatu dalam BCL, seperti bayaran. Trigger **Webhook Received** memulakan automasi dari luar BCL. BCL memberi automasi itu satu link peribadi. Apabila aplikasi lain, seperti Zapier, Make atau laman web anda sendiri, menghantar data ke link itu, automasi berjalan dengan data tersebut.

## Mula dari template

Dua template menggunakan trigger ini, di **Automations** → **Templates**:

- **Email Me From Another App** menghantar e-mel kepada anda dengan butiran setiap kali data masuk.
- **Add Contacts From Other Apps** menambah setiap orang ke dalam senarai kenalan Bukku anda (lihat [Rekod jualan anda dalam Bukku](/ms/bukku/)).

*(Screenshot: Kad template Email Me From Another App dengan Use template ditanda)*

## Sediakan trigger

Untuk menggunakan trigger ini dalam automasi anda sendiri:

1. Cipta automasi (lihat [Cipta automasi](/ms/create-automation/)) dan pilih **Webhook Received** di bawah **Webhooks** sebagai trigger.
2. Double-click trigger itu untuk membuka **Webhook Received Trigger Settings**, dan copy **Webhook link**.
3. Paste link itu dalam aplikasi lain sebagai alamat untuk menghantar data. Hantar POST request dengan body JSON atau ruangan form.
4. Hantar satu request ujian dari aplikasi lain itu. Ruangan yang dihantar dipaparkan dalam **Variables** di bawah **From the webhook**, supaya langkah seterusnya boleh menggunakannya. Semasa automasi off, BCL menyimpan request itu sebagai contoh tetapi tidak menjalankan langkah-langkahnya.
5. Tambah langkah anda, contohnya langkah **Send Email**, dan guna variable webhook di dalamnya.
6. Klik **Update Automation** dan on-kan automasi itu.

BCL menerima sehingga 60 request seminit untuk setiap automasi, dan sehingga 64 KB untuk setiap request.

## Terima request yang ada signature sahaja

Sesiapa yang ada link itu boleh memulakan automasi. Untuk menerima request daripada aplikasi anda sendiri sahaja:

1. Dalam **Webhook Received Trigger Settings**, on-kan **Require a signature**.
2. Copy **Signing secret**.
3. Dalam aplikasi lain itu, tambah header `X-BCL-Signature` pada setiap request. Nilainya ialah `sha256=` diikuti HMAC-SHA256 bagi raw request body, yang dibuat dengan signing secret.
4. Klik **Save**.

BCL kemudian menolak setiap request yang tiada signature yang sah.

> **Caution**
> Jika link atau secret itu bocor, buat link baru dalam tetapan trigger. Link semasa berhenti berfungsi serta-merta, jadi kemas kini link itu dalam setiap aplikasi yang menghantar data kepadanya.

## Isu biasa

### Apa yang aplikasi lain boleh hantar ke link webhook?

POST request dengan body JSON atau ruangan form, sehingga 64 KB. Setiap ruangan menjadi variable, dan ruangan JSON bersarang menjadi nama seperti customer_email.

### Boleh sesiapa sahaja memulakan automasi saya dengan link itu?

Boleh, sesiapa yang ada link itu. Untuk menerima request daripada aplikasi anda sendiri sahaja, on-kan Require a signature dan sign setiap request dengan Signing secret.

### Saya rasa link webhook saya sudah bocor. Apa yang perlu saya buat?

Buat link baru dalam tetapan trigger. Link lama berhenti berfungsi serta-merta, jadi paste link baru itu ke dalam setiap aplikasi yang menghantar data kepadanya.