Dokumentasi Integrasi
Integrasi Fonnte dengan Ngumbah
Panduan step-by-step untuk mendaftarkan akun Fonnte, menghubungkan nomor pengirim WhatsApp, dan menguji koneksi sampai siap dipakai operasional.
Ngumbah tidak mengirim WhatsApp secara manual dari dashboard. Untuk notifikasi otomatis ke pelanggan—seperti konfirmasi order, perubahan status cucian, pengingat pengambilan, dan pesan operasional lainnya—sistem kami terhubung ke penyedia gateway WhatsApp bernama Fonnte.
Fonnte dipilih karena:
- Mendukung integrasi API yang stabil untuk aplikasi bisnis di Indonesia.
- Memungkinkan Anda memakai nomor WhatsApp bisnis sendiri sebagai pengirim (bukan nomor generik Ngumbah).
- Proses daftar dan koneksi nomor relatif cepat, cocok untuk UMKM laundry.
- Biaya pengiriman mengikuti paket Fonnte Anda; Ngumbah hanya menghubungkan sistem ke akun Fonnte tenant.
Tanpa Fonnte terhubung: fitur notifikasi WhatsApp otomatis di Ngumbah tidak berjalan. Order dan chat in-app tetap bisa dipakai, tetapi pelanggan tidak menerima update via WA dari sistem.
Setelah onboarding, lengkapi token Fonnte di menu Pengaturan → Integrasi WhatsApp. Notifikasi otomatis WhatsApp tersedia pada paket berlangganan tertentu (lihat paket tenant Anda).
1. Akun tenant Ngumbah sudah aktif dan bisa akses menu Pengaturan.
2. Nomor WhatsApp bisnis aktif untuk dijadikan sender.
3. Akun Fonnte (jika belum punya, gunakan tombol Daftar Fonnte di onboarding tenant).
Langkah 1: Daftar/login ke Fonnte, lalu hubungkan nomor WhatsApp yang ingin dipakai sebagai sender.
Langkah 2: Ambil API key/token dari dashboard Fonnte.
Langkah 3: Di Ngumbah, buka menu Pengaturan - Integrasi WhatsApp.
Langkah 4: Isi provider Fonnte, API key, dan nomor sender format 62xxx.
Langkah 5: Klik tombol test koneksi. Jika sukses, simpan konfigurasi.
1. Status koneksi di Ngumbah berubah menjadi aktif/healthy.
2. Notifikasi test WhatsApp berhasil diterima di nomor tujuan.
3. Notifikasi order baru terkirim otomatis setelah order dibuat.
- Token invalid: generate ulang token di Fonnte lalu update di Ngumbah.
- Nomor sender tidak valid: pastikan format 62xxx dan nomor sudah terhubung di Fonnte.
- Pesan tidak terkirim: cek status perangkat WhatsApp (online/connected).
Setelah Fonnte aktif, lanjutkan ke dokumentasi integrasi lainnya di halaman Pusat Dokumentasi:
- Integrasi Gemini AI ke Ngumbah
- Integrasi WhatsApp Channel lanjutan
- Best practice keamanan API key dan monitoring