Workflow & Template

Menyusun alur notifikasi: step, delay, filter, fallback, sintaks template, dan preferensi subscriber.

Di halaman ini

Membuat & Mempublish Workflow
Tipe Step: Channel, Delay, Filter
Fallback & Retry
Sintaks Template
Override Template per Trigger
Preferensi & Opt-out

#Membuat & Mempublish Workflow

Console → Workflows → Workflow baru. Isi nama, trigger key (huruf kecil, angka, -, _; unik per environment), dan prioritas.
Tambahkan step di editor, atur isi pesan, dan lihat preview live memakai sample payload.
Simpan draft berulang kali dengan aman; draft tidak mempengaruhi trafik.
Publish membuat versi baru yang tidak bisa diubah dan mengaktifkan workflow. Publish ditolak dengan daftar masalah bila ada step yang tidak valid.

Status	Perilaku
`DRAFT`	Belum bisa dipicu API (`422 workflow_inactive`)
`ACTIVE`	Menerima trigger. Bisa dinonaktifkan/diaktifkan dari daftar workflow.
`ARCHIVED`	Disembunyikan; tidak bisa dipicu

Versioning: eksekusi memakai versi yang berlaku saat event diterima. Mengedit & publish ulang tidak mengubah eksekusi yang sedang berjalan (mis. masih menunggu delay).
Prioritas HIGH atau tanda Kritis (mis. OTP) memakai antrean prioritas.
Batas: maksimal 20 step per workflow.

Aturan validasi saat publish: minimal satu step CHANNEL; step FILTER tidak boleh terakhir; DELAY 1 detik sampai 30 hari; email wajib punya subject; sintaks template harus valid; fallback harus menunjuk step channel lain.

#Tipe Step: Channel, Delay, Filter

Step dijalankan berurutan dari atas ke bawah.

CHANNEL — kirim pesan

Pilih channel (WhatsApp, Email, Telegram, In-App), provider (default atau pilihan), subject (Email/In-App), isi pesan, dan fallback. Dilewati (SKIPPED) bila subscriber tidak punya tujuan untuk channel itu (no_destination) atau memilih opt-out (opted_out); workflow tetap lanjut ke step berikutnya.

DELAY — tunggu

Menjeda eksekusi (detik sampai hari, maks. 30 hari) lalu melanjutkannya otomatis. Selama menunggu, eksekusi berstatus WAITING dan bisa dibatalkan lewat DELETE /events/{id}.

FILTER — kondisi

Daftar rule yang digabung AND. Jika ada yang tidak terpenuhi, sisa workflow dihentikan (step ditandai SKIPPED: filter_false) dan eksekusi dianggap selesai normal.

Operator	Arti	Contoh nilai
`eq` / `neq`	sama / tidak sama	`gold`
`gt` `gte` `lt` `lte`	perbandingan angka	`1000000`
`in`	salah satu dari daftar (pisah koma)	`gold,platinum`
`contains`	teks mengandung	`@contoh.com`
`exists`	nilai tidak kosong	—

Path memakai awalan payload. atau subscriber., mis. payload.amount atau subscriber.plan.

#Fallback & Retry

Retry otomatis. Kegagalan sementara (timeout, 5xx, 429) dicoba ulang hingga 3 kali dengan jeda bertahap (5 detik, 15 detik, 60 detik). Kegagalan permanen (nomor tidak valid, kredensial salah, 4xx lain) tidak dicoba ulang.

Fallback. Pada step channel, pilih Fallback jika gagal ke step channel lain di workflow yang sama. Step fallback tidak berjalan di alur normal; ia hanya dijalankan bila step utama gagal permanen, lalu workflow lanjut ke step setelah step utama.

Contoh

1. WhatsApp   fallback → #3      ← dicoba pertama
2. In-App                       ← selalu berjalan
3. Email                        ← hanya jika WhatsApp gagal permanen

Hasil akhir eksekusi: COMPLETED (semua berhasil atau tergantikan fallback), PARTIAL (sebagian berhasil, sebagian gagal), atau FAILED (semua pengiriman gagal).

#Sintaks Template

Template memakai sintaks variabel sederhana yang aman: tidak ada eksekusi kode. Teks seperti @php atau system() diperlakukan sebagai teks biasa atau ditolak saat validasi.

text

Halo {{ subscriber.first_name|default:"Pelanggan" }}, pesanan {{ payload.invoiceId }}
sebesar {{ payload.amount|currency:"IDR" }} sudah kami terima pada {{ payload.paid_at|date:"d M Y H:i" }}.

Root	Isi
`payload`	Objek `payload` dari trigger (akses bersarang: `payload.items.0.name`)
`subscriber`	`first_name`, `last_name`, `full_name`, `email`, `phone`, `locale`, `timezone`, `id`, serta semua field di `data`
`event`	`id`, `created_at`
`workspace`	`name`

Filter

Filter	Fungsi	Contoh → hasil
`upper` `lower` `title`	Ubah huruf	`budi\|upper` → BUDI
`trim`	Hapus spasi tepi
`default:"x"`	Nilai cadangan jika kosong	`default:"-"`
`truncate:N`	Potong dan tambah …	`truncate:20`
`currency:"IDR"`	Format mata uang	450000 → Rp 450.000
`number:N`	Format angka, N desimal	`number:2`
`date:"format"`	Format tanggal di zona waktu subscriber	`date:"d M Y"`
`e`	Escape HTML
`json`	Serialisasi JSON

Variabel yang tidak ditemukan dirender kosong (peringatan muncul di preview editor).
Konten HTML email di-escape otomatis. Output dibatasi 100 KB; template maksimum 20.000 karakter.
Sintaks yang rusak (mis. @{{ tanpa penutup) ditolak saat Publish.

#Override Template per Trigger

Ganti subject atau isi untuk satu trigger tanpa mengubah workflow, lewat overrides.channels.<channel> (nama channel huruf kecil: whatsapp, email, telegram, in_app). Override dirender dengan engine template yang sama.

json

{
  "workflow": "order-confirmed",
  "to": "usr_102",
  "payload": { "invoiceId": "INV-9901" },
  "overrides": {
    "channels": {
      "email": { "subject": "Pesanan {{ payload.invoiceId }} siap", "body": "Teks khusus untuk pesanan ini." },
      "whatsapp": { "body": "Pesanan {{ payload.invoiceId }} dikonfirmasi ✅" }
    }
  }
}

#Preferensi & Opt-out

Sebelum mengirim, Notifora memeriksa preferensi subscriber untuk channel tersebut.

Opt-out global (channel dimatikan untuk semua workflow) selalu berlaku, termasuk untuk workflow kritis.
Workflow kritis (mis. OTP, tanda Kritis di editor) mengabaikan opt-out per-workflow.
Selain itu, opt-out per-workflow dihormati; tanpa preferensi, default-nya diizinkan.

Step yang dilewati karena opt-out berstatus SKIPPED: opted_out. Kelola lewat API preferensi atau halaman subscriber di Console.