Cara Mendapatkan Token Fonnte & Wablas

Agar seluruh otomatisasi WhatsApp di Pesantren OS — pengingat tagihan, konfirmasi lunas, pengiriman kredensial, hingga bot dua arah — berjalan tanpa intervensi manual, instansi Anda perlu menghubungkan sistem ke penyedia WhatsApp Gateway. Dua penyedia yang didukung adalah Fonnte dan Wablas, keduanya layanan asal Indonesia. Panduan ini menjabarkan prosedur pengambilan Token API di masing-masing platform — karena tata cara keduanya berbeda — serta cara menautkannya ke sistem.

📌 Prinsip kerja: Anda mengoneksikan satu nomor WhatsApp (disarankan nomor khusus lembaga, bukan pribadi) ke akun gateway melalui pemindaian QR Code. Penyedia lalu memberikan Token yang berfungsi sebagai kunci untuk mengirim pesan atas nama nomor tersebut. Token inilah yang ditempelkan ke Pesantren OS.

Opsi A — Fonnte

1. Registrasi & tambah perangkat

1. Daftar akun di fonnte.com.
2. Pada dasbor, buka menu Device, lalu klik Add Device.
3. Isi nama perangkat dan nomor WhatsApp aktif yang akan dijadikan pengirim, kemudian klik Add Device.

2. Koneksikan nomor via QR

1. Pada perangkat yang baru dibuat, klik tombol Connect dan pilih metode QR.
2. Buka WhatsApp pada ponsel bernomor tersebut → Perangkat Tertaut → Tautkan Perangkat, lalu pindai QR Code yang ditampilkan Fonnte.
3. Tunggu hingga status perangkat berubah menjadi Connect.

3. Ambil Token

Pada baris perangkat yang sudah Connect, klik tombol Token — token akan otomatis tersalin (copy) ke papan klip. Token ini bersifat per perangkat.

Opsi B — Wablas

1. Registrasi & buat perangkat

1. Daftar akun di wablas.com.
2. Buat Device baru: isi nama perangkat, nomor WhatsApp, lalu pilih paket layanan (Lite/Pro/Enterprise). Wablas menagih biaya per perangkat, sehingga Anda perlu menyelesaikan pembayaran terlebih dahulu (pemrosesan umumnya 1–2 jam).

2. Koneksikan nomor via QR

Setelah pembayaran terkonfirmasi, buka Device → Scan QR Code, lalu pindai QR Code menggunakan WhatsApp pada nomor tersebut. Tunggu beberapa menit hingga Anda menerima notifikasi WhatsApp bahwa perangkat telah terhubung.

3. Ambil Token & Server

1. Buka Device → Setting untuk menemukan Token (dan Secret Key, bila ada).
2. Penting — Server/Domain: akun Wablas dialokasikan ke salah satu server regional (misalnya solo, pati, jogja, dan lainnya). Alamat server Anda — contoh https://solo.wablas.com — tertera pada email pendaftaran Wablas. Alamat ini yang akan Anda isikan sebagai API URL di Pesantren OS.

Menghubungkan ke Pesantren OS

Setelah Token diperoleh, masukkan ke sistem melalui menu Pengaturan → Provider WhatsApp:

1. Pilih kartu provider yang sesuai: 🚀 Fonnte atau 📲 Wablas.
2. Tempelkan Token pada kolom API Key / Token.
3. Khusus Wablas: isi kolom API URL dengan alamat server regional Anda (misalnya https://solo.wablas.com). Bila dikosongkan, sistem memakai https://api.wablas.com.
4. Klik Simpan.
5. Verifikasi dengan Kirim Uji Coba — masukkan nomor pribadi Anda, lalu pastikan pesan masuk. Jika gagal, sistem menampilkan respons mentah dari provider (misalnya “Token tidak valid” atau “Tidak ada device aktif”) sebagai petunjuk perbaikan.

Setelah tersimpan dan uji coba berhasil, seluruh pesan otomatis (tagihan, konfirmasi lunas, kredensial wali) akan terkirim tanpa perlu admin mengirim manual.

Mengaktifkan Bot Dua Arah (Webhook)

Agar wali dapat mengirim kata kunci seperti MENU, TAGIHAN, atau SALDO dan dibalas otomatis, tautkan webhook:

1. Setelah menyimpan provider (selain Manual), Pesantren OS menampilkan sebuah Webhook URL unik pada panel yang sama.
2. Klik Salin, lalu tempelkan URL tersebut pada kolom Webhook di dasbor Fonnte atau Wablas.

Prosedur ini membuka jalur pesan masuk dari wali diteruskan ke Pesantren OS untuk dibalas otomatis. Pengelolaan kata kunci selengkapnya dibahas pada Setup WhatsApp: Provider, Template, dan Bot.

Catatan Penting

• Jaga kerahasiaan Token. Dengan token saja, siapa pun dapat mengirim pesan atas nama nomor WhatsApp Anda. Jangan bagikan atau simpan di tempat publik.
• Ponsel harus tetap online. Nomor pengirim adalah sesi WhatsApp tertaut — pastikan ponsel bernomor tersebut menyala dan terhubung internet agar pengiriman tidak terputus. Gunakan nomor khusus lembaga agar tidak mengganggu WhatsApp pribadi.
• Berlangganan berbayar. Baik Fonnte maupun Wablas adalah layanan berbayar sesuai paket masing-masing; tinjau tarif terbaru di situs penyedia. Untuk kebutuhan minim, mode Manual (wa.me) tetap tersedia gratis tanpa token (namun tanpa otomatisasi).

Langkah Selanjutnya

• Setup WhatsApp: Provider, Template, dan Bot — Konfigurasi lanjutan: templat pesan, webhook bot, dan pengingat otomatis.
• Modul WhatsApp — Gambaran Umum — Arsitektur komunikasi WhatsApp dan manfaat integrasinya.