Cara menggunakan PingSMS

1. Pengenalan

PingSMS adalah aplikasi Android untuk mengirim silent SMS ping (Class-0 / binary data SMS) ke nomor HP. Dari delivery report, Anda bisa mengetahui apakah SIM target online atau offline — tanpa notifikasi di HP penerima.

• Tidak perlu root
• Butuh SIM aktif yang bisa mengirim SMS data
• Mendukung API lokal, ngrok, Telegram bot, target list, lookup IMEI/IMSI

2. Instalasi & izin

1. Install APK PingSMS di perangkat Android.
2. Buka aplikasi. Saat diminta, izinkan permission berikut:

Pastikan perangkat punya kuota SMS / paket yang mengizinkan pengiriman SMS data.

3. Kirim silent ping

Ini alur utama di layar Main.

1. Isi Country Code (CC) — default Indonesia 62. Ketuk pemilih negara jika perlu.
2. Isi Phone Number. Format yang didukung:
   • +62 812-3456-7890
   • 6281234567890
   • 081234567890
3. Opsional: ketuk ikon kontak untuk pilih dari Contacts.
4. Pilih SIM: Auto / SIM 1 / SIM 2 (untuk dual-SIM).
5. Pilih Network: Auto / 2G / 3G / 4G / 5G (preferensi; tergantung OEM).
6. Ketuk Kirim Ping.

Hasil delivery report

• TERKIRIM — HP / SIM target online
• GAGAL — HP / SIM target offline atau tidak terjangkau

Port SMS data default: 9200. Detail PDU bisa dilihat lewat tombol Details.

4. Riwayat & laporan

• Di Main: 5 riwayat terakhir. Ketuk baris = isi ulang nomor. Tekan lama = detail.
• Menu History: daftar lengkap + pencarian nomor/status.
• Detail berisi: nomor, arah, sumber (Manual / API / Scheduled / Geofence), status, lokasi (jika aktif), PDU hex/decoded.
• Received Storage: arsip PDU SMS data masuk. Tekan lama baris untuk salin ke clipboard.

5. Daftar target

1. Buka Targets (quick tool atau menu).
2. Isi nama + nomor, ketuk Add.
3. Gunakan Batch Ping All Targets untuk ping semua sekaligus.

Cocok untuk pantau beberapa nomor secara berkala.

6. Lookup IMEI / IMSI

Buka layar Lookup.

• IMEI: hitung check digit Luhn, lalu lookup info perangkat (brand/model/TAC).
• IMSI: lookup operator / negara dari nomor IMSI.

Fitur yang sama juga tersedia lewat API dan perintah Telegram bot.

7. Dashboard & Threat Panel

• Dashboard: total ping, delivered/failed, rate, ringkasan per nomor, jumlah target & threat.
• Threat Panel: daftar pengirim silent SMS mencurigakan. Ketuk entry untuk memblokir nomor ke blocklist.

8. Pengaturan

Buka menu Settings. Ringkasan bagian penting:

Integrasi

Keamanan

• Rate limiting — default max 60 request/menit
• IP whitelist — batasi akses API
• Blocklist — nomor yang diblokir (pisahkan koma)

Background

1. Aktifkan Run in background agar API tetap hidup setelah app ditutup (dan restart saat boot).
2. Ketuk Disable battery optimization agar sistem tidak mematikan service.

Scripting (JavaScript)

Aktifkan custom script (Rhino). Hook utama:

function onPingComplete(result) {
  // result & log tersedia
  log.info("Ping selesai: " + result);
}

9. API Server

1. Settings → Enable API Server.
2. Port default: 8080 (rentang valid 1024–65535).
3. Salin API Key (atau regenerate jika perlu).
4. URL lokal: http://<IP-HP>:8080.
5. Buka API Documentation di app, atau akses /api/v1/docs.
6. Opsional: tampilkan API QR Code untuk scan cepat.

Autentikasi: header X-API-Key. Jika JWT aktif, bisa pakai Authorization: Bearer <token>.

Contoh kirim ping

curl -X POST http://192.168.1.10:8080/api/v1/ping \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"phone":"081234567890","wait":true,"timeout":60000}'

Field opsional: port (default 9200), sim_slot, network_mode, payload_hex.

10. Ngrok (akses publik)

Agar API bisa diakses dari internet (bukan hanya LAN):

1. Settings → bagian Public Tunnel (Ngrok).
2. Ketuk Download ngrok (disimpan di storage internal app).
3. Isi authtoken dari akun ngrok Anda.
4. Aktifkan tunnel → Save.
5. Atau tempel URL HTTPS manual (dari PC/Termux) di field override.

11. Telegram Bot

Setup bot

1. Buat bot di @BotFather, salin token.
2. Buka layar Bot di PingSMS.
3. Aktifkan bot, tempel token, simpan.
4. Atur prefix perintah (default /ping).
5. Opsional: aktifkan Allow direct phone send agar user cukup kirim nomor saja.
6. Atur Public Mode atau daftar Authorized Users (limit + masa berlaku hari).
7. Opsional: aktifkan Queue System agar request diproses antrean.

Perintah default

Contoh output — berhasil (ONLINE)

Perintah: /ping 081234567890

✅ DELIVERED

Target: `6281234567890`
Provider: Telkomsel
Network: 510-10
Country Code: 62

Time: 23:15 10/07/2026

PDU RAW:
`0791…0791…`

PDU DECODED:
`SMSC: +62811… | Status: Delivered`

Checked by: Andi (@andi_user)

Contoh output — gagal (OFFLINE)

Perintah: /ping 081298765432

❌ FAILED / OFFLINE

Target: `6281298765432`
Provider: XL
Network: 510-11
Country Code: 62

Time: 23:16 10/07/2026

Checked by: Andi (@andi_user)

Contoh output — error sistem

❌ SYSTEM ERROR

Target: `6281234567890`
Details: Failed to send silent ping
User: Andi (123456789)
Time: 23:17 10/07/2026

Variabel template pesan

Bisa dipakai di custom messages, misalnya:

{first_name} {msisdn} {provider} {limit_left} {pdu_raw} {date} {time} {brand} {model} {operator} {error_details}

Auto-reply rules mendukung: Exact match, Start with, End with, Contains, Regex, Welcome.

12. Daftar endpoint API

Base URL: http://<device-ip>:8080 atau URL ngrok. Spec: GET /api/v1/openapi.json.

13. Logs & backup

Logs

• Buka View Logs dari Settings atau menu.
• Filter: ALL / APP / API / SMS / NETWORK / SYSTEM.
• Mode tampilan: List / Text / Table.
• Ekspor sebagai teks, JSON, atau salin clipboard.

Backup

• Settings → Export backup JSON (ke clipboard).
• Import backup JSON untuk restore.
• Atau lewat API: GET /api/v1/backup/export dan POST /api/v1/backup/import.

14. Widget

Tambahkan widget PingSMS dari home screen launcher. Widget membuka aplikasi (shortcut cepat ke Main) — tidak mengirim ping otomatis.

15. FAQ