Dukungan

Panduan Integrasi

Empat jalur integrasi sesuai kebutuhan Anda — dari OTP aplikasi, Google Sheets/Excel, campaign phonebook, sampai webhook real-time.

Langkah 0 — Pastikan Node Anda Online

Sebelum integrasi apa pun, pasang minimal satu HP Android sebagai node: instal aplikasi Broadcastin, 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.

Skenario Integrasi yang Paling Sering Dipakai Pengguna

Dari pengalaman mendampingi ribuan campaign, pola integrasi pengguna Broadcastin terbagi rapi: tim marketing memakai jalur phonebook dashboard untuk blast promo berulang, developer menyambungkan endpoint OTP ke aplikasi mereka, dan pemilik usaha yang lincah memakai Google Sheets sebagai pusat kendali — daftar kontak di spreadsheet, tombol kirim dari menu custom, status balik ke kolom di sampingnya.

Ketiganya bisa berjalan bersamaan dalam satu akun. Tidak jarang kami melihat UMKM yang mulai dari Sheets lalu tumbuh memakai campaign dashboard penuh, sementara developer startup memakai API yang sama untuk OTP aplikasi mereka — satu wallet, satu laporan pemakaian.

Bermigrasi dari SMS Gateway Lama?

Jika selama ini Anda memakai gateway self-hosted (Gammu, Kannel, atau modem pool) atau API provider cloud, migrasi ke Broadcastin umumnya hanya soal mengganti URL endpoint dan header autentikasi di kode Anda. Struktur request kami senghana dibuat minimal: satu endpoint kirim, satu endpoint status, webhook untuk push.

Nomor dan kontak lama tinggal diekspor CSV lalu diimpor ke phonebook — proses upsert menjaga data tetap bersih tanpa duplikat. SIM yang selama ini terpasang di modem bisa dipindahkan ke HP node apa pun, dan pulsa di dalamnya langsung terpakai.

Menjaga Kualitas Kiriman Setelah Integrasi Berjalan

Integrasi yang sehat bukan sekadar berhasil mengirim, tapi terus terkirim sehat dalam jangka panjang. Beberapa kebiasaan yang kami rekomendasikan: gunakan spintax pada campaign besar agar pesan tidak identik, aktifkan short link untuk mengukur respons, patuhi blacklist sebagai bentuk etika, dan pantau telemetri node agar pulsa serta baterai tidak pernah habis di tengah campaign.

Lakukan uji coba ke nomor sendiri setelah setiap perubahan template — cara paling murah memastikan format pesan, variabel personalisasi, dan tautan tampil benar sebelum blast sesungguhnya.

Siap Ubah HP Lama Anda Menjadi Mesin SMS Massal & Marketing?

Mendaftar tanpa kartu kredit, aktif dalam hitungan menit. Blast SMS bulk pertama Anda langsung berangkat dari HP Android yang Anda miliki — dengan opsi jalur RCS via Google Messages, tanpa potong pulsa.

Daftar SekarangLihat Cara Kerja
  • Pairing QR + Token Unik
  • Terenkripsi TLS/WSS
  • Isolasi Data per-Tenant
  • Auto-Refund SMS Gagal