Lewati ke konten utama

Node notification

Node notification mengirimkan pemberitahuan berdasarkan template acara yang dipilih dari modul Events. Saluran, bahasa, dan penerima diambil dari pengaturan template, dan node meneruskan nilai variabel ke template.

Node ini terletak di panel kiri di samping node telegram dan whatsapp. Node ini memiliki satu input dan satu output.


Pengaturan node notification

1. Nama

Kolom untuk menentukan nama node.
Nama ditampilkan di area kerja dan membantu mengidentifikasi node dengan mudah.
Jika dibiarkan kosong, node akan disebut notification.

Contoh:

  • Nama node: kirim kode pesanan

2. Template acara

Bagian di mana template acara dipilih dan data untuknya ditentukan.

Template

Daftar dropdown template. Di dalamnya ditampilkan acara dari modul Events yang ditandai sebagai template untuk alur kerja (centang Gunakan sebagai template untuk alur kerja di pengaturan acara), hingga 100 item. Nama diambil dalam bahasa antarmuka saat ini.

Selama template belum dipilih, di kolom tertulis — pilih template —. Pilihan dapat direset dengan tanda silang di kolom.

info

Saat mengganti template, nilai variabel dan jalur ke penerima akan dihapus — mereka perlu diisi kembali.

Informasi tentang template

Setelah pemilihan, di bawah daftar muncul kartu template:

  • Nama template — nama template.
  • Saluran — saluran pengiriman yang termasuk dalam template: Email, Push, WebSocket.
  • Penerima — kepada siapa template mengirimkan pemberitahuan.
  • Bahasa — bahasa yang digunakan dalam template.

Nilai yang mungkin untuk Penerima:

NilaiSiapa yang akan menerima pemberitahuan
Semua penggunasemua pengguna
Pelangganpelanggan
Grup penggunagrup pengguna
Pengguna targetpengguna target
Terdaftaryang terdaftar
Semua orangsemua
ID pengguna dari alur kerjapengguna, ID yang diteruskan oleh alur
Alamat email dari alur kerjaalamat email yang diteruskan oleh alur

Jika ada yang tidak beres dengan template yang dipilih, formulir akan memberi tahu tentang hal ini:

  • Gagal memuat daftar template. — daftar template tidak berhasil dimuat.
  • Template tidak ditemukan. Mungkin telah dihapus. — template tidak ditemukan, mungkin telah dihapus.
  • Acara yang dipilih tidak lagi menjadi template. — acara yang dipilih tidak lagi ditandai sebagai template.

3. Penerima

Blok ini muncul hanya jika dalam template penerima adalah ID pengguna dari alur kerja atau Alamat email dari alur kerja. Di dalamnya terdapat satu kolom dengan jalur ke array penerima dalam pesan alur, dalam format Mustache:

  • Jalur ke ID pengguna dalam pesan — untuk ID pengguna dari alur kerja, petunjuk di kolom: {{msg.payload.userIds}};
  • Jalur ke alamat email dalam pesan — untuk Alamat email dari alur kerja, petunjuk di kolom: {{msg.payload.emails}}.

Contoh:

{{msg.payload.userIds}}

4. Variabel template

Blok ini muncul jika dalam template terdapat variabel kustom. Untuk setiap variabel — kolom terpisah, diberi label dengan nama variabel (atau penandanya, jika tidak ada nama).

Nilai — ekspresi Mustache atau string biasa.

Contoh:

{{msg.payload.code}}

Jika variabel dihapus dari template, tetapi di node masih tersimpan nilai untuknya, formulir akan menunjukkan peringatan Variabel ini tidak lagi digunakan dalam template: dengan daftar variabel tersebut dan nilai-nilainya.


Parameter dalam skema JSON

Dalam skema JSON alur, pengaturan node disimpan sebagai berikut:

  • name (string) - nama node
  • eventId (number | null) - ID template acara yang dipilih
  • variables (object) - nilai variabel template: kunci — penanda variabel, nilai — ekspresi Mustache atau string
  • recipientsPath (string) - jalur ke array penerima dalam pesan

Contoh penggunaan

Contoh 1: Pemberitahuan kepada pengguna yang diteruskan oleh alur

Tugas:
Mengirimkan kode pesanan kepada beberapa pengguna, ID yang dihitung oleh alur.

Alur:

[inject] ---> [function] ---> [notification]

Kode node function:

msg.payload = {
userIds: [12, 15],
code: "A-1024"
};
return msg;

Pengaturan node notification:

  • Template: template acara, yang penerimanya adalah ID pengguna dari alur kerja, dan dalam teks terdapat variabel dengan penanda code
  • Jalur ke ID pengguna dalam pesan: {{msg.payload.userIds}}
  • Kolom variabel code dalam Variabel template: {{msg.payload.code}}

Hasil:
Pemberitahuan akan dikirim kepada pengguna dengan ID 12 dan 15 melalui saluran yang termasuk dalam template, dan sebagai pengganti variabel code, teks akan diisi dengan A-1024.