All guides
14 Notifikasi & webhook all topics ▾
// guide 14

Notifikasi & webhook.

Hantar e-mel apabila sesuatu peristiwa berlaku, hantar webhook bertandatangan kepada perkhidmatan luaran dan semak log penghantaran.

Notifikasi & webhook

Apabila sesuatu berlaku pada laman anda — rekod ditambah, pesanan dibuat atau pelawat mendaftar — anda boleh menghantar e-mel secara automatik atau memaklumkan perkhidmatan luaran. Buka laman anda dan klik Notifications.

Peristiwa yang mencetuskan notifikasi

Peristiwa Pencetus
record.created Rekod baharu ditambah pada koleksi
record.updated Rekod dikemas kini dan sekurang-kurangnya satu nilai medan berubah
order.created Pelawat memulakan proses checkout
order.paid Pembayaran selesai
end_user.registered Pelawat mendaftar pada laman

Notifikasi e-mel

Untuk menyediakan peraturan e-mel:

  1. Pada halaman Notifications, tambah peraturan di bawah saluran penghantaran.
  2. Pilih event yang akan mencetuskannya.
  3. Masukkan satu atau beberapa recipients.
  4. Tulis subject dan body. Anda boleh menggunakan pemboleh ubah seperti {{record.title}} atau {{order.id}}; nilainya akan diisi semasa e-mel dihantar.
  5. Syarat pilihan: hantar e-mel hanya apabila satu medan menyamai nilai tertentu — masukkan laluan titik (contohnya record.data.status) dan nilai yang dijangka (contohnya published). Perbandingan tidak kira huruf besar/kecil. Wajib untuk peristiwa Record updated — tanpanya, setiap suntingan pada mana-mana medan akan mencetuskan e-mel.
  6. Simpan peraturan.

E-mel dihantar melalui sistem penghantaran yang dikonfigurasi untuk laman, sama ada SMTP atau penyedia API yang disokong. Maklumat kelayakan disulitkan dan tidak didedahkan.

Webhook

Webhook menghantar payload bertandatangan ke URL HTTPS luaran. Ini berguna untuk menghubungkan laman dengan Slack, Zapier, CRM atau backend tersuai.

  1. Di bawah Webhook endpoints, klik Add endpoint.
  2. Masukkan URL HTTPS yang akan menerima payload.
  3. Simpan. Sistem akan menjana secret untuk anda. Simpan secret itu bagi mengesahkan tandatangan.

Setiap penghantaran webhook ditandatangani menggunakan HMAC-SHA256. Perkhidmatan penerima boleh mengesahkan bahawa webhook itu benar-benar datang daripada laman anda. Anda boleh menambah sehingga 5 endpoint bagi setiap laman.

Log penghantaran

Halaman Notifications memaparkan delivery log bagi e-mel dan webhook terkini, termasuk status penghantarannya. Jika penghantaran gagal, sistem akan mencuba semula secara automatik. Gunakan log untuk mengesahkan notifikasi atau menyiasat masalah.

Hantar ujian

Klik Test send untuk menghantar notifikasi contoh tanpa menunggu peristiwa sebenar. Ini membolehkan anda memastikan recipients dan endpoint webhook berfungsi sebelum laman digunakan secara langsung.