Variable automasi

Variable ialah pemegang tempat dalam kurungan kerinting, seperti {name}, yang BCL gantikan dengan nilai sebenar apabila automasi berjalan. Variable boleh digunakan dalam setiap ruangan teks sesuatu langkah: penerima, subjek, isi mesej, lajur spreadsheet, serta URL, header dan body HTTP request.

Cari & masukkan variable

Di sebelah setiap ruangan yang menerima variable, klik Variables. Senarai itu hanya memaparkan variable untuk trigger automasi anda, dikumpulkan dan boleh dicari. Klik satu variable untuk copy, kemudian paste di tempat yang anda mahu.

Beberapa peraturan ini terpakai di semua tempat:

• Taip variable dengan tepat, dengan kedua-dua kurungan dan tanpa ruang: {order_number}, bukan { order_number } atau {Order Number}.
• Variable yang tidak wujud untuk trigger itu, atau yang tiada nilai, menjadi kosong. BCL tidak memaparkan ralat, kecuali apabila penerima menjadi kosong: langkah itu kemudian gagal dengan mesej dalam sejarah.
• Mesej ujian menggunakan data contoh, seperti “Ahmad Ali” dan “RM 150.00”. Run sebenar menggunakan nilai sebenar di bawah.

Variable bayaran

Variable ini boleh digunakan dengan Payment Initiated, Payment Successful, Payment Failed, Payment Cancelled, Payment Completed dan Status Changed. Contoh-contoh ini datang daripada pembelian ujian pada akaun demo.

Variable	Kandungan	Contoh
{name}	Nama pelanggan	Farah Idris
{email}	E-mel pelanggan	farah.idris@example.com
{phone}	Telefon pelanggan, dengan kod negara	+60133456784
{form_title}	Tajuk form	Kopi Kampung Home Brewing E-Guide
{form_type}	Jenis form	Payment Form
{form_url}	Link ke form	https://<your-subdomain>.bcl.my/form/kopi-kampung-home-brewing-e-guide
{form_featured_image}	Link ke featured image form	https://…/featured.jpg
{order_number}	Nombor pesanan	LINK-05851
{reference_id}	Nombor pesanan (sama seperti di atas)	LINK-05851
{created_at}	Bila transaksi dicipta	2026-09-27 22:15:55
{payment_date}	Bila transaksi dibayar	2026-09-27 22:15:56
{payment_method}	Kaedah bayaran	FPX
{payment_status}	Status dalam perkataan	Successful
{status_description}	Teks status daripada bank	Approved
{receipt_url}	Link ke page resit	https://<your-subdomain>.bcl.my/receipts/LINK-05851
{amount}	Jumlah dibayar, berformat	RM 15.00
{subtotal}	Subtotal, berformat	RM 15.00
{discount}	Diskaun, berformat	RM 5.00
{shipping_cost}	Kos penghantaran, berformat	RM 10.00
{amount_value}	Jumlah dibayar, nombor sahaja	15.00
{subtotal_amount}	Subtotal, nombor sahaja	15.00
{discount_amount}	Diskaun, nombor sahaja	0.00
{fee_amount}	Caj gateway, nombor sahaja	0.00
{shipping_name}	Kaedah penghantaran	Standard Delivery
{address}	Alamat penghantaran penuh dalam satu baris	123, Jalan Ampang, 50450, Kuala Lumpur, Malaysia
{address_line1}, {address_line2}	Baris alamat	123, Jalan Ampang
{city}, {state}, {postal_code}, {country}	Bahagian alamat	Kuala Lumpur
{items_list}	Satu baris untuk setiap item, dengan kuantiti dan harga	1x Home Brewing Guide - RM 15.00
{items_summary}	Item dalam satu baris, untuk SMS	1x Home Brewing Guide
{items_json}	Item dalam format JSON, untuk HTTP request	[{"sku":"Home Brewing Guide","name":"Home Brewing Guide","quantity":1,"price":15}]
{total_items}	Bilangan baris item	1
{product_table}	Jadual item yang berformat, dengan butang Access untuk item digital, untuk e-mel	(jadual)
{business_name}	Nama perniagaan anda	KOPI KAMPUNG SDN. BHD.

{receipt_url} berguna selepas bayaran yang gagal atau dibatalkan: page resit itu kemudian menawarkan butang kepada pelanggan untuk mencuba bayaran semula.

Ruangan form

Setiap custom field pada payment form, event form atau booking form menjadi variable yang dinamakan mengikut nama ruangan itu, contohnya {company_name} untuk ruangan bernama company_name. Fail yang dimuat naik dipaparkan sebagai link. Variable ini tidak dipaparkan dalam senarai Variables, jadi semak nama ruangan dalam form builder.

Variable item

Untuk setiap item dalam pesanan, gantikan N dengan kedudukannya (1 untuk item pertama, 2 untuk item kedua). Untuk kandungan dilindungi, M ialah nombor kandungan dalam item itu.

Variable	Kandungan	Contoh
{product_name_N}	Nama item	{product_name_1} = Home Brewing Guide
{product_image_N}	Link ke gambar item	https://…/beans.jpg
{download_link_N}	Download Link item itu	https://drive.google.com/…
{protected_content_url_N_M}	Link peribadi pembeli ke kandungan dilindungi	{protected_content_url_1_1} = https://<your-subdomain>.bcl.my/content/KLxu9odA...
{protected_content_title_N_M}	Tajuk kandungan itu	Kopi Kampung Home Brewing Guide
{access_finder_url_N_M}	Page tempat pembeli boleh mendapatkan link mereka semula melalui e-mel	https://<your-subdomain>.bcl.my/content/O6FYW1GU/access

Item tanpa link muat turun atau kandungan dilindungi menjadikan variable itu kosong.

Variable penghantaran

Order Shipped ada semua variable bayaran di atas, serta dua variable ini:

Variable	Kandungan	Contoh
{tracking_number}	Nombor tracking	TRK123456789MY
{courier}	Nama kurier	Poslaju

Variable lead form

New Lead Received ada empat variable umum, serta satu variable untuk setiap ruangan lead form anda.

Variable	Kandungan	Contoh
{form_title}	Tajuk lead form	Kopi Kampung Wholesale Enquiry
{submission_id}	Kod submission	SUB-12345
{submission_datetime}	Bila submission dihantar	27/09/2026 21:32
{business_name}	Nama perniagaan anda	KOPI KAMPUNG SDN. BHD.
{field_name:id}	Jawapan untuk satu ruangan	{email_address:2} = aisyah@example.com

Variable ruangan menggunakan nama ruangan dan id-nya, disambungkan dengan titik bertindih, seperti {full_name:1} atau {monthly_volume:5}. Senarai Variables memaparkannya dikumpulkan mengikut form, dan ruangan yang dikongsi oleh setiap form yang dipilih berada di bawah On every form. Jawapan checkbox disambungkan dengan koma. Ruangan fail dan tandatangan tidak disokong.

Variable event

Participant Created, Participant Checked In dan Certificate Generated berkongsi variable ini. {certificate_url} diisi untuk Certificate Generated.

Variable	Kandungan	Contoh
{attendee_name}	Nama peserta	Zainab Harun
{attendee_email}	E-mel peserta	zainab.harun@example.com
{attendee_phone}	Telefon peserta	+60133456786
{ticket_number}	Nombor tiket	DDGO36C1
{ticket_name}	Jenis tiket	Normal
{ticket_url}	Link ke tiket	https://<your-subdomain>.bcl.my/ticket/DDGO36C1/view
{seat_number}	Tempat duduk, untuk event bertempat duduk	B1-006
{event_name}	Nama event	Kopi Kampung Coffee Festival 2026
{event_type}	Jenis event	seating
{event_date}, {event_start_date}	Tarikh mula	17/10/2026
{event_end_date}	Tarikh tamat	17/10/2026
{event_time}	Masa mula	09:00
{event_location}, {event_address}	Lokasi tempat event	Dewan Kopi Kampung, Jalan Kopi 1, 50450 Kuala Lumpur
{price_paid}	Harga dibayar, berformat	RM 35.00
{original_price}	Harga tiket sebelum diskaun	RM 35.00
{order_number}	Nombor pesanan	LINK-05856
{created_at}	Bila peserta dicipta	27/09/2026 22:20
{certificate_url}	Link ke sijil	https://…
{business_name}	Nama perniagaan anda	KOPI KAMPUNG SDN. BHD.

Ruangan peserta yang anda tambah pada event form boleh digunakan sebagai {attendance_<field name>}, contohnya {attendance_favourite_coffee}. Custom field pembeli berfungsi sama seperti pada payment form.

Variable affiliate

Variable	Trigger	Kandungan	Contoh
{affiliate_id}	Semua trigger affiliate	ID affiliate	12
{affiliate_name}	Semua trigger affiliate	Nama affiliate	Amir Rashid
{affiliate_email}	Semua trigger affiliate	E-mel affiliate	amir@example.com
{affiliate_phone}	Semua trigger affiliate	Telefon affiliate	60123456789
{business_name}	Semua trigger affiliate	Nama perniagaan anda	KOPI KAMPUNG SDN. BHD.
{referral_id}	Referral Approved, Referral Rejected	ID referral	34
{order_number}	Referral Approved, Referral Rejected	Pesanan yang menghasilkan referral itu	LINK-12345
{amount}	Referral Approved, Referral Rejected	Jumlah pesanan	RM 150.00
{commission_formatted}	Referral Approved, Referral Rejected	Komisen	RM 15.00
{status}	Referral Approved, Referral Rejected	Status referral	approved
{referral_source}	Referral Approved, Referral Rejected	Sumber referral	Website
{payout_id}	Payout Requested	ID permintaan payout	7
{payout_formatted}	Payout Requested	Jumlah payout	RM 500.00
{payout_status}	Payout Requested	Status payout	pending
{requested_at}	Payout Requested	Bila payout diminta	27/09/2026 10:15
{referral_count}	Payout Requested	Jumlah referral affiliate itu	18

Tips

Beberapa tabiat ini menjimatkan masa apabila menggunakan variable:

• Guna jumlah nombor sahaja dalam HTTP request. Guna {amount_value} dalam HTTP request, dan jumlah berformat ({amount}) dalam mesej.
• Semak data run sebenar. Dalam sejarah automasi, buka satu execution dan lihat Execution Data: senarai itu memaparkan setiap variable dengan nilainya, dan ini cara paling cepat untuk mengesan variable yang kosong.
• Pastikan SMS pendek dengan {items_summary}. Guna {product_table} dalam e-mel sahaja.

Isu-isu biasa

Kenapa HTTP request saya menghantar nama dan e-mel kosong untuk ruangan lead form?

Ruangan lead form memerlukan nama dan id ruangan, seperti {email_address:2}. {email} atau {email_address} sahaja tidak wujud untuk lead, dan variable yang tidak wujud menjadi kosong tanpa ralat. Copy key yang tepat daripada senarai Variables.

Bagaimana saya letak link muat turun setiap produk dalam e-mel?

Guna {product_table} untuk jadual dengan butang Access bagi setiap item, atau variable item seperti {download_link_1} dan {protected_content_url_1_1} untuk meletakkan setiap link sendiri.

Boleh saya paparkan jawapan pelanggan kepada custom field pada payment form saya?

Boleh. Setiap custom field pada payment form, event form atau booking form menjadi variable yang dinamakan mengikut ruangan itu, contohnya {company_name}. Uji dengan pembelian sebenar dan semak data execution dalam sejarah.

Artikel berkaitan

• Trigger automasi
• Action automasi
• Langkah HTTP Request
• Hantar produk digital melalui e-mel