Memasang & Memasangkan Agent

Halaman ini menjelaskan cara memasang agent di HP Android dan menghubungkannya ke akun GoSosmed Anda.

Sebelum mulai

Kebutuhan	Keterangan
HP Android	Perangkat fisik. Emulator bisa dipakai untuk uji coba, bukan produksi.
Koneksi internet	Agent hanya butuh koneksi keluar. Tidak perlu IP publik atau port terbuka.
Akun GoSosmed	Paket Free cukup. Tidak perlu kartu kredit.
Root	Tidak diperlukan. Jangan me-root HP untuk ini.

Kenapa APK, bukan Google Play

Agent ini memakai Accessibility Service untuk otomasi. Kebijakan Google Play melarang kategori tersebut di jalur distribusi publik, dan aplikasi yang melanggarnya bisa di-ban.

Jadi agent tidak akan tersedia di Play Store publik. Distribusinya lewat pemasangan APK langsung (side-load), atau jalur Play Internal/Closed Testing yang bersifat privat.

Ini pembatasan kebijakan, bukan kekurangan teknis. Kami menyebutkannya terang-terangan supaya Anda tidak menunggu sesuatu yang tidak akan datang.

Langkah 1 — Dapatkan APK

Dua pilihan, keduanya sah:

• Rilis siap pakai — unduh dari halaman Releases repo publik gososmed-mobile-agent.
• Bangun sendiri — kalau Anda ingin memastikan APK yang berjalan benar-benar berasal dari kode yang Anda baca, ikuti Membangun dari Sumber.

Hanya pasang dari sumber resmi

Agent meminta izin Accessibility, yang sangat kuat. APK dari sumber tidak resmi bisa disamarkan menjadi apa pun. Ambil hanya dari repo publik di atas, atau bangun sendiri.

Langkah 2 — Pasang APK

1. Buka berkas APK di HP Anda.
2. Android akan meminta izin memasang aplikasi dari sumber ini — setujui untuk aplikasi pemasang yang Anda pakai (mis. peramban atau pengelola berkas).
3. Selesaikan pemasangan, lalu buka aplikasinya.

Langkah 3 — Aktifkan Accessibility Service

Agent tidak bisa bekerja sebelum langkah ini. Android sengaja mengharuskan aktivasi manual oleh pemilik perangkat — tidak ada aplikasi yang boleh mengaktifkannya sendiri.

1. Buka Setelan → Aksesibilitas.
2. Cari GoSosmed Agent pada daftar layanan terpasang.
3. Aktifkan, lalu konfirmasi dialog peringatan Android.

Android akan menampilkan peringatan bahwa layanan ini dapat membaca isi layar dan melakukan tindakan. Peringatan itu benar — baca Izin & Privasi untuk memahami persisnya apa yang dipakai dan apa yang tidak.

Langkah 4 — Pasangkan dengan akun Anda

Agent memakai kode pairing untuk mengikat perangkat ke akun. Setelah berhasil, agent menyimpan device_id permanen sehingga tidak perlu dipasangkan ulang setiap kali.

1. Di dasbor GoSosmed, buka bagian Perangkat dan minta kode pairing baru.
2. Masukkan kode itu di aplikasi agent.
3. Agent membuka koneksi keluar ke server dan mendaftarkan dirinya.

Status perangkat akan berubah menjadi terhubung di dasbor. Agent menjaga koneksi dengan heartbeat dan auto-reconnect — kalau jaringan terputus, ia menyambung kembali sendiri tanpa Anda pasangkan ulang.

Langkah 5 — Kecualikan dari optimasi baterai

Jangan lewati langkah ini. Ini penyebab kegagalan nomor satu.

Android secara agresif menghentikan aplikasi latar belakang untuk menghemat baterai. Kalau agent dihentikan, job yang butuh perangkat akan menunggu tanpa hasil.

1. Buka Setelan → Aplikasi → GoSosmed Agent.
2. Cari Baterai → pilih Tidak dibatasi (atau setara).

Sebagian produsen — Xiaomi, Oppo, Vivo, Realme, Samsung — punya lapisan pembatas tambahan di luar setelan standar Android. Rinciannya ada di Pemecahan Masalah.

Memastikan berhasil

Agent terpasang benar bila ketiganya terpenuhi:

• Layanan aktif di Setelan → Aksesibilitas
• Perangkat tampil terhubung di dasbor
• Job uji pertama selesai tanpa galat di Job Monitor

Kalau ada yang tidak sesuai, lanjut ke Pemecahan Masalah.