Lewati ke konten utama

Mobile PWA: mulai dan batas platform

Tujuan​

Anda dapat memasang Mobile PWA, masuk ke workspace, memahami empat menu utama, dan mengetahui kapan data live tidak tersedia.

Untuk siapa​

Agent memakai Inbox, Contacts, dan Pipeline. Admin/owner menjalankan fungsi agent; administrasi workspace tetap dilakukan di web.

Prasyarat​

  • URL Mobile PWA dan URL API dari administrator.
  • Token JWT yang masih berlaku, atau kredensial masuk yang disediakan deployment.
  • Jaringan dapat menjangkau API dan provider WAHA untuk data live.

Memasang dan masuk​

  1. Buka URL Mobile PWA di browser perangkat.
  2. Pasang PWA melalui opsi Add to Home Screen/Install bila browser menawarkannya.
  3. Isi API base URL dan token pada halaman setup, atau buka tautan masuk yang disiapkan administrator.
  4. Setelah autentikasi berhasil, pastikan bottom navigation menampilkan Inbox, Contacts, Pipeline, dan Profile.

Tanda berhasil: Inbox terbuka dan data percakapan dimuat dari akun aktif.

Sesi kedaluwarsa​

Semua permintaan API memakai Bearer JWT. Saat HTTP 401 muncul, akses ke layar aktif dihapus dan aplikasi membuka halaman setup atau masuk ulang (re-auth). Anda masuk kembali dengan token baru; secret, token, dan password tidak ditampilkan ulang.

Cache dan offline​

Service worker hanya menyimpan app shell (aset JavaScript, CSS, HTML, ikon, gambar, dan font). API, media, attachment, serta autentikasi bersifat network-only dan tidak disimpan di static cache. Tidak ada offline write queue. Saat offline, shell tetap dapat terbuka tetapi data live tidak tersedia; jangan menganggap tampilan sebagai snapshot terbaru.

Bottom navigation selalu menampilkan empat tujuan. Detail percakapan dan kontak merupakan tampilan turunan (child state); gunakan Back untuk kembali ke menu induk. Saat riwayat pesan terbuka, tujuan aktif tetap Inbox. Target sentuh minimum 44×44 px; PWA tidak menyalin tata letak desktop yang lebar.

Jika terjadi masalah​

  • API/network gagal: tunggu koneksi pulih, muat ulang halaman, lalu ulangi aksi; pesan kesalahan tampil pada layar terkait.
  • SSE reconnecting: pesan baru dapat tertunda; aliran SSE mencoba tersambung kembali secara otomatis.
  • Provider offline/degraded: periksa status kesehatan di Profile dan pulihkan sesi WAHA melalui jalur administrasi.

Batasan​

Push dan deep-link terbatas: penangan push (handler) tersedia, tetapi subscription/VAPID belum tersedia; deep-link percakapan hanya berfungsi bila data awal (bootstrap) percakapan sudah dimuat. Unggah media, perekaman suara, lokasi, dan berbagi kontak tidak tersedia di mobile.

Tugas terkait​