Operasional & Keamanan

Membaca status eksekusi, mengatasi masalah umum, dan praktik keamanan.

Di halaman ini

#Status Eksekusi & Step

Eksekusi	Arti
`PROCESSING`	Sedang berjalan (termasuk menunggu delay)
`COMPLETED`	Selesai; tidak ada kegagalan yang tidak tertangani fallback
`PARTIAL`	Sebagian channel berhasil, sebagian gagal
`FAILED`	Semua pengiriman gagal
`CANCELED`	Dibatalkan lewat API

Step	Arti
`QUEUED` / `PROCESSING`	Menunggu / sedang dikirim
`WAITING`	Menunggu delay berakhir
`COMPLETED`	Berhasil
`FAILED`	Gagal permanen (cek `error_code` di log pesan)
`SKIPPED`	Dilewati; alasan di `skip_reason`: `opted_out`, `no_destination`, `filter_false`, `not_needed` (fallback tidak diperlukan), `canceled`

Gejala	Penyebab umum & solusi
`401 unauthenticated`	Key salah/dicabut, atau memakai key `ntf_test_` di environment Production (atau sebaliknya). Periksa header `Authorization: Bearer …`.
`422 workflow_inactive`	Workflow belum dipublish atau dinonaktifkan. Publish dari editor.
`404 not_found` saat trigger	`workflow` harus berisi trigger key, bukan nama workflow; periksa juga environment key.
`402 quota_exceeded`	Kuota event habis. Cek Console → Usage, lalu upgrade di Billing.
`429 rate_limited`	Terlalu banyak request. Hormati `Retry-After`, gunakan `/events/bulk`.
Step `SKIPPED: no_destination`	Subscriber tidak punya tujuan untuk channel itu (mis. tanpa `phone`). Kirim field di `to` atau lewat `PUT /subscribers`.
Step `SKIPPED: opted_out`	Subscriber menonaktifkan channel. Periksa preferensi.
Log `no_provider_configured`	Belum ada provider aktif untuk channel di environment ini. Hubungkan di Channels.
Log `circuit_open` / provider “degraded”	Provider gagal berulang; pengiriman dijeda 60 detik dan dijadwal ulang otomatis. Periksa kredensial/endpoint.
Log `connection_error`	Provider tidak terjangkau dari server Notifora. Pastikan URL gateway publik dan sesi aktif.
Status tidak pernah `DELIVERED`	Webhook status provider belum didaftarkan. Lihat Webhook Status Delivery.
Pembayaran sudah sukses tapi plan belum aktif	Buka halaman invoice di Console (status disinkronkan otomatis). Bila tetap pending, hubungi support dengan nomor invoice.

Saat menghubungi support, sertakan request_id dari respons error atau event_id/message_id dari log.

Rahasia: API key dan signing secret hanya di server. Rotasi dengan membuat key baru, mengganti di aplikasi, lalu mencabut key lama.
Kredensial provider disimpan terenkripsi dan tidak pernah ditampilkan ulang; kosongkan field saat edit untuk mempertahankan nilai lama.
Data pribadi: tujuan pesan di log disamarkan; DELETE /subscribers/{id} menghapus data penerima. Akses data asli di Console dibatasi Admin dan dicatat di audit log.
Peran tim: Owner, Admin, Developer, Viewer dengan hak berbeda; owner terakhir tidak bisa diturunkan atau dihapus.
Webhook: verifikasi signature, hanya https, dan buat penanganan idempoten.
Audit log mencatat pembuatan/pencabutan key, perubahan provider, peran, dan billing (Console → Settings → Audit).