Lewati ke konten utama

Notifikasi

Kotak masuk pribadi mengirim sebutan, DM, berbagi, kegagalan automasi, dan pengingat meski halaman ditutup.

Pesan status singkat, misalnya perubahan yang tersimpan atau operasi Git yang selesai, muncul di dekat bagian atas halaman. Gunakan tombol Tutup untuk menghapus popup dengan pointer atau keyboard. Mengarahkan kursor ke pesan akan membuatnya tetap terlihat agar dapat dibaca; menutupnya akan menyingkirkan pesan, sementara operasi terkait tetap berada dalam kondisinya saat ini.

Kotak masuk​

Baris basis data terenkripsi; maksimum 500 dan yang lama dihapus. Kunci sumber menghapus duplikat. API RESTful mencantumkan, menghitung, menandai, dan menghapus.

Pengiriman langsung melalui notify:<userId> dan GET /api/notifications/events (SSE). Identitas berasal dari sesi; SQL adalah sumber kebenaran.

Sumber​

channel-dm, channel-mention (ketika seseorang @mentions Anda di channel atau membalas pesan), channel-invite, share, automation-failed, calendar-reminder, work-run-finished, work-run-attention, work-takeover, work-approval, system. Hanya untuk pengguna terkait.

Notifikasi juga dapat memicu otomasi: sebuah otomasi dengan pemicu event berjalan setiap kali notifikasi jenis pilihan mencapai pemiliknya, dibatasi jeda satu menit per otomasi.

Webhook​

  • URL persis; tanpa redirect. Alamat privat/link-local ditolak kecuali host ada di TOOLS_PRIVATE_NETWORK_ALLOWLIST.
  • Tubuh persis ditandatangani sebagai X-Libre-Signature: sha256=<hmac>.
  • Hanya tipe, judul, ID, dan waktu yang keluar; bukan teks pesan, prompt, atau dokumen.
  • Percobaan ulang terbatas: 5xx diulang, 4xx selesai.
  • Tipe tertentu atau *.

Push browser​

  • VAPID RFC 8292: ES256, pasangan terenkripsi tersimpan atau VAPID_PUBLIC_KEY/VAPID_PRIVATE_KEY, kontak VAPID_SUBJECT.
  • RFC 8291: aes128gcm dengan kunci perangkat.
  • Per perangkat dan sesi; logout menghapus pendaftaran. Endpoint terenkripsi dan harus HTTPS publik.
  • Percobaan ulang terbatas; 404/410 menghapus langganan.
  • Payload berisi judul, teks, tipe, dan tautan.

Diperlukan aplikasi produksi dan origin aman. Service worker menyediakan pemasangan dan shell offline; API tidak di-cache.

Email​

Email adalah kanal pengiriman ketiga, dan satu-satunya yang perlu disiapkan administrator. Pengaturan → Manajemen Pengguna → Akses dan kebijakan → Notifikasi email menyimpan satu server SMTP keluar: host, port, keamanan koneksi (STARTTLS, TLS implisit, atau tanpa enkripsi untuk jaringan tepercaya), kredensial opsional, alamat pengirim, dan URL publik yang dipakai untuk tautan. Variabel lingkungan SMTP_* di Variabel Lingkungan menyemai kolom yang sama untuk penerapan kontainer; nilai yang disimpan di UI diutamakan. Kata sandi disimpan terenkripsi dan tidak pernah dikembalikan ke peramban. Kirim uji coba mengirim pesan ke alamat administrator sendiri (atau alamat mana pun yang diketik) sehingga perjalanan pulang-pergi terbukti sebelum pengguna mengandalkannya.

Administrator juga memilih template email Terang atau Gelap dan melihat pratinjaunya sebelum menyimpan. Terang adalah bawaan. Preset yang disimpan berlaku untuk setiap notifikasi dan email uji di instance ini, termasuk hasil Markdown; preset ini tidak bergantung pada tema antarmuka tiap pengguna. Pratinjau merender konten contoh tanpa menghubungi SMTP, mengirim email, atau mengantrekan job. Hanya administrator yang dapat membaca atau mengubah preset atau meminta pratinjau. Preset bawaan menjaga teks, tautan, blok kode, dan tombol tetap terbaca; template HTML kustom tidak diterima. Klien email tetap dapat menyesuaikan warna menurut pengaturan tampilannya sendiri.

Begitu sakelarnya menyala, setiap pengguna memilih apa yang masuk ke kotak masuknya di Pengaturan → Notifikasi → Notifikasi email:

  • Sebutan di kanal: pesan yang menyebut Anda di sebuah kanal, beserta pratinjau dan tautan ke kanalnya.
  • Hasil otomatisasi: hasil setiap jalannya otomasi Anda, berhasil atau gagal. Sebuah proses chat membawa jawaban asisten itu sendiri (hingga beberapa ribu karakter); sebuah proses Work membawa baris status tugas; kegagalan membawa pesan kesalahannya. Tautannya membuka chat atau tugas yang dihasilkan.

Kedua sakelar tetap mati sampai pengguna menyalakannya, dan keduanya hanya bekerja untuk akun yang memiliki alamat email, yang diatur pemilik akun saat mendaftar atau ditambahkan administrator di Pengguna. Pesan keluar lewat runtime job tahan lama yang sama seperti Web Push, dengan percobaan ulang terbatas untuk kegagalan relay sementara, dan klien SMTP-nya adalah implementasi bawaan kecil (EHLO, STARTTLS, AUTH PLAIN atau LOGIN) yang tidak pernah mengirim kredensial lewat koneksi tanpa enkripsi kecuali mode-nya secara eksplisit none. Setiap pesan memiliki bagian teks polos dan alternatif HTML bergaya situs: wordmark Libre WebUI, satu kartu berisi konten, tombol koral menuju target, dan footer yang menunjuk kembali ke Pengaturan → Notifikasi. Hasil otomatisasi dirender dari Markdown (heading, daftar, penekanan, kode, tautan hanya ke target http(s)); selebihnya di-escape, dan satu-satunya gambar eksternal adalah logo yang disajikan dari librewebui.org. Tanpa pelacakan.

Batas​

Belum ada pengaturan per tipe; keluar dari channel menghentikan notifikasinya.