Copy page

Fitur Utama

Notifikasi

OmniStream memiliki tiga lapisan notifikasi yang saling melengkapi: pusat notifikasi dalam app (bell icon), notifikasi browser/push (Web Push API), dan suara notifikasi yang dapat dikonfigurasi per jenis event.

Pusat notifikasi dalam app

Halaman notifikasi lengkap dapat dibuka di /notifications. Notifikasi disimpan di localStorage browser (maks. 100 entri, tertua dihapus secara otomatis).

Jenis notifikasi

Tipe	Kategori UI	Kapan muncul
assignment	Assignments	Percakapan baru ditugaskan ke Anda
transfer	Assignments	Percakapan ditransfer ke Anda dari agent lain
mention	Mentions	Anda di-mention dalam catatan internal
sla_breach	SLA	SLA percakapan yang Anda tangani dilanggar
new_message	Messages	Pesan baru masuk di percakapan Anda
system	System	Pengumuman atau peringatan sistem

Filter kategori

Di bagian atas halaman terdapat tab filter:

• All — semua notifikasi
• Assignments — mencakup tipe assignment dan transfer
• Mentions — tipe mention
• SLA — tipe sla_breach
• Messages — tipe new_message
• System — tipe system

Setiap tab menampilkan badge jumlah notifikasi yang belum dibaca di kategori tersebut.

Pengelompokan berdasarkan tanggal

Notifikasi dikelompokkan otomatis ke dalam: Today, Yesterday, This Week, dan Older. Halaman menampilkan 20 notifikasi pertama; klik Load more untuk memuat 20 berikutnya.

Tindakan pada notifikasi

Tindakan	Cara
Buka halaman terkait	Klik baris notifikasi (mengikuti link yang tersimpan, mis. /inbox?id=…)
Tandai satu notifikasi dibaca	Hover notifikasi → klik ikon centang
Tandai semua dibaca	Tombol Mark all read di sudut kanan atas (hanya muncul jika ada yang belum dibaca di filter aktif)
Hapus satu notifikasi	Hover notifikasi → klik ikon X
Hapus semua notifikasi	Tombol Clear all di sudut kanan atas
Buka pengaturan	Tombol Settings → mengarah ke /profile#notification-preferences

Endpoint API (Notifications Inbox)

Aksi	Endpoint
Ambil daftar notifikasi	GET /api/notifications/inbox
Hitung notifikasi belum dibaca	GET /api/notifications/inbox/unread-count
Tandai satu notifikasi dibaca	PATCH /api/notifications/inbox/{id}/read
Tandai semua notifikasi dibaca	POST /api/notifications/inbox/mark-all-read
Hapus notifikasi	DELETE /api/notifications/inbox/{id}

Parameter query GET /api/notifications/inbox: is_read (boolean opsional), limit (maks. 100, default 50), offset.

Skema lengkap di API Reference.

---

Notifikasi browser (Web Push)

OmniStream mendukung Web Push API standar browser sehingga notifikasi muncul di luar jendela browser, bahkan ketika tab OmniStream sedang tidak aktif. Implementasi menggunakan enkripsi P-256 (VAPID).

Cara mengaktifkan notifikasi browser

1. Buka pengaturan profil Anda di /profile.
2. Temukan bagian Notification Preferences.
3. Klik tombol Enable Browser Notifications.
4. Browser akan menampilkan dialog izin — pilih Allow.
5. Setelah izin diberikan, browser mengirim data subscripsi (endpoint, kunci P-256, dan auth secret) ke server via POST /api/notifications/subscribe.

Menonaktifkan notifikasi browser

Klik Disable di bagian yang sama, atau cabut izin notifikasi dari pengaturan browser. Pencabutan lewat tombol Disable mengirim DELETE /api/notifications/subscribe dengan endpoint yang tersimpan.

Preferensi per jenis event (push & suara)

Setiap agent dapat mengatur apakah push notification dan suara diaktifkan untuk setiap dari enam jenis event berikut:

Event type	Keterangan
new_message	Pesan baru masuk
conversation_assigned	Percakapan ditugaskan ke Anda
conversation_transferred	Percakapan ditransfer ke Anda
sla_breach	Pelanggaran SLA
mention	Mention dalam catatan internal
system_alert	Peringatan sistem

Nilai default (jika belum pernah disimpan): push_enabled: true, sound_enabled: true untuk semua event type.

Endpoint API (Push Notifications)

Aksi	Endpoint
Ambil VAPID public key	GET /api/notifications/vapid-key
Daftarkan subscripsi browser	POST /api/notifications/subscribe
Hapus subscripsi browser	DELETE /api/notifications/subscribe
Kirim push uji coba	POST /api/notifications/test
Ambil preferensi notifikasi	GET /api/notifications/preferences
Simpan preferensi notifikasi	PUT /api/notifications/preferences

Contoh menyimpan preferensi push:

Code
[
  { "event_type": "new_message", "push_enabled": true, "sound_enabled": false },
  { "event_type": "sla_breach", "push_enabled": true, "sound_enabled": true }
]

Tipe event yang tidak dikenal akan ditolak dengan error 422 Unprocessable Entity.

---

Pengaturan suara notifikasi

Buka /settings/notification-sounds untuk mengonfigurasi suara yang berbeda untuk setiap jenis event.

Event yang didukung

Event	Label di UI
new_message	New Message
new_conversation	New Conversation
mention	Mention
transfer	Transfer
sla_warning	SLA Warning

Pilihan suara

Setiap event dapat dikonfigurasi dengan salah satu dari enam opsi suara:

Default · Chime · Bell · Ping · Pop · None

Pilih None untuk menonaktifkan suara pada event tersebut tanpa menonaktifkan push notifikasinya.

Cara mengubah pengaturan suara

1. Buka Settings → Notification Sounds (/settings/notification-sounds).
2. Gunakan toggle di setiap baris untuk mengaktifkan atau menonaktifkan suara event tersebut.
3. Pilih jenis suara dari dropdown di sebelah kanan (dropdown dinonaktifkan otomatis jika toggle mati).
4. Klik ikon speaker untuk preview suara sebelum menyimpan.
5. Klik Save Preferences.

Endpoint API (Notification Sounds)

Aksi	Endpoint
Ambil preferensi suara	GET /api/notifications/sounds
Simpan preferensi suara	PUT /api/notifications/sounds

PUT /api/notifications/sounds mendukung partial update — hanya field yang dikirim yang akan diubah; field yang tidak disertakan tetap menggunakan nilai sebelumnya.

Contoh memperbarui hanya suara untuk pesan baru:

Code
{ "new_message_sound": "chime", "new_message_enabled": true }

Skema lengkap di API Reference.

---

Rute terkait

• Inbox Agent — daftar percakapan real-time
• Catatan Internal — mention agent dalam catatan
• Kebijakan SLA — konfigurasi trigger SLA breach