FAQ
Daftar pertanyaan umum yang sering ditanyakan oleh pengguna baru dan tim integrasi. Jika pertanyaan Anda tidak terjawab di sini, buka halaman panduan yang relevan atau konsultasikan dengan admin workspace Anda.
Umum
Apa itu OmniStream?
Platform CRM omnichannel self-hosted yang menyatukan WhatsApp, Instagram, dan Email ke satu inbox dengan real-time messaging, manajemen agent, dan analitik. Selengkapnya di Apa itu OmniStream.
Apakah OmniStream berbayar?
OmniStream di-release dengan lisensi open-source. Tidak ada biaya lisensi. Namun Anda tetap perlu membayar:
- Biaya Meta WhatsApp Cloud API per conversation (sesuai tarif Meta).
- Biaya VPS/server untuk menjalankan stack.
- Biaya SMTP provider (jika menggunakan SendGrid/Mailgun).
Apakah datanya aman?
Ya — semua data (kontak, percakapan, pesan) tersimpan di database yang Anda kendalikan sendiri. Tidak ada data yang dikirim ke control-plane SaaS. Pastikan Anda:
- Mengaktifkan HTTPS (Let's Encrypt) untuk semua endpoint publik.
- Mengganti password default dan kredensial rahasia sistem.
- Memasang firewall yang membatasi akses ke layanan internal — hanya endpoint yang diperlukan yang diekspos ke internet publik.
- Melakukan backup berkala secara rutin.
Autentikasi & Akses
Saya lupa password. Bagaimana cara reset?
Minta admin workspace Anda untuk mereset password lewat
/user-management. Di v1 tidak ada self-service password reset via
email — fitur ini direncanakan untuk v1.1.
Berapa lama sesi login berlaku?
Default 24 jam sejak login. Setelah kedaluwarsa, Anda akan diminta login ulang. Durasi ini dapat diubah oleh administrator server.
Bisakah saya login di dua perangkat sekaligus?
Ya — JWT adalah stateless, jadi Anda dapat login di browser desktop dan mobile secara bersamaan. Kedua sesi akan menerima event WebSocket secara independen.
Mengapa saya tidak bisa melihat halaman Dashboard?
Halaman Dashboard hanya tersedia untuk peran Supervisor dan Admin. Agent reguler tidak memiliki akses. Lihat Peran pengguna untuk matriks akses lengkap.
Channel
Channel apa saja yang didukung?
Di v1: WhatsApp (via Meta Cloud API), Instagram DM (via Meta Messaging API), dan Email (via SMTP + inbound webhook).
Apakah Facebook Messenger didukung?
Integrasi Messenger belum didokumentasikan secara resmi di v1. Akan dirilis di v1.1.
Apakah Telegram/Line/WeChat didukung?
Tidak di v1. Belum ada rencana konkret untuk Telegram/Line/WeChat.
Kenapa pesan WhatsApp keluar saya gagal dengan error "message window closed"?
Meta membatasi pesan bebas hanya dalam 24 jam setelah pesan terakhir pelanggan. Setelah window tertutup, Anda harus menggunakan template WhatsApp yang disetujui. Lihat WA Templates.
Berapa batas ukuran media per channel?
| Channel | Gambar | Dokumen | Video | Audio |
|---|---|---|---|---|
| 5 MB | 100 MB | 16 MB | 16 MB | |
| 8 MB | — | 25 MB | — | |
| 10 MB per file (maks total 25 MB per pesan) | sama | sama | sama |
Detail di Mengirim media.
SLA & Kinerja
Bagaimana SLA dihitung?
SLA mengukur dua metrik:
- First Response Time (FRT) — waktu dari pesan inbound pertama hingga agent membalas.
- Resolution Time — waktu dari percakapan dibuka hingga status
resolved.
Kebijakan dapat dibuat per channel dan/atau per divisi. Pencocokan
kebijakan mengikuti prioritas channel+division > division-only > channel-only > default. Detail di
Kebijakan SLA.
Apa yang terjadi saat SLA dilanggar?
Saat sebuah percakapan melampaui threshold FRT atau resolusi, sistem:
- Mencatat breach.
- Mengirimkan notifikasi real-time ke supervisor.
- Menampilkan badge peringatan di inbox supervisor.
Supervisor dapat melihat daftar breach di Pemantauan SLA.
Ada rate limit?
Ya — 60 request per menit per IP. Jika Anda melampaui limit, API akan mengembalikan HTTP 429 Too Many Requests. Untuk integrasi yang membutuhkan throughput lebih tinggi, hubungi administrator untuk penyesuaian.
Integrasi developer
Bagaimana cara akses REST API?
Lihat API Reference. Setiap endpoint memiliki tombol Try
it untuk menguji langsung dari browser. Autentikasi via header
Authorization: Bearer <JWT>.
Apa yang dikirim ke outgoing webhook saya?
OmniStream mem-publish 6 jenis event:
message.receivedmessage.sentmessage.statusconversation.createdconversation.resolvedconversation.assigned
Setiap payload ditandatangani HMAC-SHA256 di header
X-Omnistream-Signature. Atur endpoint di
Outgoing Webhooks.
Bagaimana cara subscribe ke WebSocket?
Gunakan endpoint WebSocket di ws://<host>/ws?token=<JWT>. Server akan mengirimkan event real-time untuk percakapan yang relevan dengan peran Anda. Lihat API Reference.
Troubleshoot
Pesan masuk tidak muncul di inbox
- Pastikan integrasi channel sudah dikonfigurasi dan aktif di halaman Integrations.
- Periksa bahwa URL webhook di Meta App Dashboard sudah benar dan dapat dijangkau publik.
- Pastikan Meta App Secret dan Verify Token di konfigurasi OmniStream cocok dengan yang ada di Meta App Dashboard.
- Jika masalah berlanjut, hubungi administrator untuk memeriksa log layanan.
Pesan keluar stuck di status pending
Penyebab umum:
- Kredensial Meta salah atau kedaluwarsa — perbarui Access Token di halaman Integrations.
- Messaging window tertutup — gunakan template WhatsApp yang disetujui.
- Hubungi administrator untuk memverifikasi koneksi ke Meta Graph API.
Frontend tidak bisa konek ke backend
- Pastikan URL yang Anda akses sudah benar.
- Coba refresh halaman atau bersihkan cache browser.
- Jika error terus terjadi, hubungi administrator untuk memastikan layanan berjalan normal.
Lainnya
Di mana saya bisa melapor bug atau meminta fitur?
Buat issue di repository GitHub OmniStream, atau hubungi maintainer workspace Anda. Untuk bug keamanan, JANGAN buat issue publik — hubungi langsung via email privat.
Apakah OmniStream mendukung multi-tenant/multi-workspace?
Saat ini belum — di luar scope v1.
Bagaimana cara backup data saya?
Backup database dilakukan secara berkala (minimal harian). Kebijakan dan runbook backup dikelola oleh administrator workspace Anda.
Tidak menemukan jawaban? Telusuri menu di sidebar, atau buka API Reference untuk detail integrasi.