Panduan Integrasi

Langkah 0 — Pastikan Node Anda Online

Sebelum integrasi apa pun, pasang minimal satu HP Android sebagai node: instal aplikasi BroadcastSMS, scan QR pairing dari dashboard, dan pastikan SIM Anda aktif dengan pulsa atau paket SMS. API hanya akan mengirim pesan selama ada node online — cek telemetri baterai, pulsa, dan sinyal di menu Nodes/SIM.

Jalur 1 — OTP & Notifikasi dari Aplikasi Anda

Panggil POST /api/v1/sms/send dengan priority HIGH setiap kali aplikasi Anda butuh mengirim OTP atau notifikasi transaksional. Trafik HIGH selalu didahulukan sehingga tidak tertunda oleh campaign marketing yang sedang berjalan.

Untuk mencatat hasil kirim, polling GET /api/v1/sms/status/:id atau gunakan webhook untuk menerima update status secara push. Simpan message_id yang dikembalikan response sebagai referensi.

• Gunakan priority HIGH untuk OTP/login/konfirmasi pembayaran.
• Simpan message_id dari response untuk pelacakan status.
• Terapkan retry di sisi aplikasi hanya untuk kegagalan HTTP, bukan status DELIVERY — sistem sudah otomatis retry 3x.

Jalur 2 — Google Sheets & Excel via Apps Script

Karena API kami HTTP biasa, spreadsheet pun bisa jadi mesin pengirim. Di Google Sheets, buka Extensions → Apps Script, lalu tulis fungsi yang memanggil UrlFetchApp.fetch ke endpoint /api/v1/sms/send dengan header X-API-Key Anda.

Contoh pola: kolom A berisi nomor tujuan, kolom B berisi pesan, lalu menu custom “Kirim SMS” membaca baris terpilih dan mengirim satu per satu (atau dikumpulkan menjadi satu request bulk). Pendekatan yang sama berlaku untuk Excel dengan VBA/Office Scripts selama bisa melakukan HTTP request.

Jalur 3 — Campaign Massal dari Phonebook Dashboard

Untuk blast marketing berulang, gunakan menu Campaigns: impor CSV kontak (kolom tambahan seperti nama dan kota otomatis jadi variabel personalisasi {nama}, {kota}), pilih template spintax, atur prioritas LOW, lalu start. Progres per kontak, klik short link, dan export CSV tersedia real-time.

Import bersifat upsert — nomor yang sama diperbarui, bukan duplikat, sehingga phonebook tetap bersih untuk campaign berikutnya.

Jalur 4 — Webhook Status & SMS Masuk

Set webhook URL Anda di pengaturan tenant agar menerima push setiap ada SMS masuk ke SIM node maupun update status kiriman. Pastikan endpoint membalas 2XX dengan cepat; pengiriman webhook di-retry hingga 3x dengan backoff bila gagal.

Checklist Sebelum Go-Live

• Minimal satu node online dengan baterai sehat dan pulsa cukup.
• API Key disimpan aman di server/backend — bukan di kode frontend.
• Pesan OTP memakai priority HIGH, campaign memakai LOW.
• Nomor yang minta berhenti ditambahkan ke blacklist (otomatis ditolak 403).
• Uji coba ke nomor sendiri dulu untuk memastikan format pesan dan pengirim sesuai.