Pemecahan Masalah Agent

Diurutkan dari penyebab paling sering ke paling jarang.

Agent berhenti sendiri setelah beberapa waktu

Penyebab paling umum, sejauh ini. Android mematikan aplikasi latar belakang untuk menghemat baterai, dan agent ikut terkena.

Langkah standar:

1. Setelan → Aplikasi → GoSosmed Agent → Baterai → Tidak dibatasi
2. Pastikan Accessibility Service masih aktif di Setelan → Aksesibilitas

Setelan standar Android saja sering tidak cukup, karena banyak produsen menambahkan lapisan pembatas sendiri:

Merek	Lokasi setelan tambahan
Xiaomi / Redmi / POCO	Setelan → Aplikasi → Izin → Autostart → aktifkan. Lalu di Aplikasi Terkini, tekan lama kartu agent → ikon kunci.
Oppo / Realme	Setelan → Baterai → Penghemat Baterai → pilih agent → Jangan optimalkan. Aktifkan juga Autostart.
Vivo	Setelan → Baterai → Konsumsi daya latar belakang tinggi → izinkan agent. Aktifkan Autostart.
Samsung	Setelan → Baterai → Batas penggunaan latar belakang → pastikan agent tidak ada di daftar aplikasi tidur / tidur dalam.
Huawei	Setelan → Baterai → Luncurkan aplikasi → setel agent ke Kelola manual, aktifkan ketiga sakelarnya.

Kalau HP Anda tidak ada di tabel, cari kata kunci Autostart, Aplikasi tidur, atau Pengelolaan latar belakang di Setelan.

Perangkat tampil terputus di dasbor

Agent memakai koneksi keluar dengan heartbeat dan auto-reconnect, jadi putus sesaat wajar dan pulih sendiri. Yang perlu diperiksa kalau tidak pulih:

1. HP benar-benar online — coba buka satu situs di peramban.
2. Agent tidak dimatikan sistem — lihat bagian pertama halaman ini.
3. Jaringan tidak memblokir WebSocket. Beberapa Wi-Fi kantor, kampus, dan hotel memblokirnya. Uji cepat: pindah ke data seluler. Kalau langsung tersambung, masalahnya di jaringan tadi, bukan di agent.
4. VPN atau DNS penyaring di HP bisa memutus koneksi. Coba matikan sementara.

Job tertahan menunggu, tidak pernah jalan

Job yang butuh aplikasi HP hanya bisa jalan saat perangkat menyala dan terhubung. Ini sifat BYOD, bukan galat.

Periksa berurutan:

1. Perangkat terhubung di dasbor?
2. Job tersebut diarahkan ke perangkat yang benar?
3. Aplikasi target terpasang dan sudah login di HP itu?
4. Ada job lain yang sedang berjalan di perangkat sama? Eksekusi berurutan per perangkat.

Kalau butuh publikasi yang tidak bergantung pada HP menyala, pakai platform berjalur API resmi — lihat Mode Publikasi & Platform.

Job gagal di tengah jalan

Biasanya karena tampilan aplikasi target berubah, atau ada sesuatu yang menutupi layar.

• Aplikasi target baru diperbarui. Pembaruan bisa mengubah tata letak sehingga elemen yang dicari tidak lagi ditemukan. Laporkan lewat issue di repo publik dengan menyebut nama aplikasi dan versinya.
• Ada dialog atau notifikasi menimpa layar. Iklan, permintaan izin, atau popup pembaruan bisa memblokir alur.
• Sesi login kedaluwarsa. Buka aplikasi target secara manual, login ulang, lalu jalankan job kembali.
• Layar terkunci. Sebagian alur butuh layar aktif.

Periksa tangkapan layar di Job Monitor — itu cara tercepat melihat kondisi layar tepat saat job gagal.

Accessibility Service mati sendiri

Beberapa ROM menonaktifkan layanan aksesibilitas setelah reboot atau pembaruan sistem. Aktifkan ulang di Setelan → Aksesibilitas, dan pastikan Autostart untuk agent sudah menyala.

Setelah mengaktifkan ulang, agent akan memakai device_id yang sudah tersimpan — tidak perlu pairing ulang.

Kode pairing ditolak

• Kode pairing berlaku sekali dan punya masa kedaluwarsa. Minta yang baru dari dasbor.
• Pastikan tidak ada spasi atau karakter tersalin ikut tertempel.
• Kalau perangkat itu pernah dipasangkan, cabut dulu entri lamanya di dasbor.

Masih belum beres

Buka issue di repo publik agent dan sertakan:

• Merek dan model HP, serta versi Android
• Versi agent
• Apa yang Anda harapkan terjadi, dan apa yang sebenarnya terjadi
• Pesan galat dari Job Monitor bila ada

Jangan sertakan kode pairing, token, tangkapan layar yang memuat isi akun pribadi, atau kredensial apa pun — issue itu terbuka untuk umum.