Dokumentasi Resmi NusaMate UMKM

Selamat datang di pusat panduan pelanggan dan dokumentasi integrasi resmi NusaMate. Panduan ini dirancang khusus untuk membantu para pemilik usaha UMKM, pengelola toko, staf kasir, dan tim Customer Service (CS) memanfaatkan otomasi WhatsApp bisnis secara maksimal, profesional, dan aman.

1. Pendaftaran Akun & Memulai Cepat

Untuk memulai menggunakan NusaMate, Anda dapat langsung mengakses dasbor pengelola toko melalui halaman: /portal.

Menambahkan Staf CS Toko: Setelah masuk sebagai pemilik toko, Anda dapat mengundang staf admin kasir atau Customer Service keluarga melalui menu Manajemen Tim di dasbor. Setiap staf akan memiliki akun email dan kata sandi login tersendiri untuk membalas pesan pelanggan secara bersamaan.

2. Menghubungkan Nomor WhatsApp (Scan QR & Kode 8-Digit)

NusaMate menggunakan teknologi Multi-Device Engine resmi yang ringan dan stabil. Anda dapat menghubungkan nomor WhatsApp toko Anda dengan 2 metode praktis:

3. Live Chat Omnichannel Mirip Web WhatsApp

Antarmuka live chat NusaMate dirancang familiar persis seperti WhatsApp Web resmi agar staf CS Anda dapat langsung bekerja tanpa perlu pelatihan yang rumit:

• Multi-Perangkat: Pilih nomor WhatsApp toko yang ingin dipantau dari menu dropdown di bilah navigasi chat.
• Filter Obrolan Cepat: Saring percakapan berdasarkan "Belum Dibaca", "Belum Dibalas", "Sedang Ditangani AI", atau "Ditangani Staf CS".
• Indikator Centang Transparan: Menampilkan status centang satu (terkirim ke jaringan WhatsApp), centang dua abu-abu (pesan tiba di ponsel pelanggan), dan centang dua biru (pesan telah dibaca oleh pelanggan).

4. Manajemen Pelanggan (CRM WhatsApp)

Kelola basis data pelanggan toko Anda secara rapi dan profesional di menu Pelanggan (CRM):

• Pengelompokan Tag Pelanggan: Berikan label pada kontak pelanggan seperti VIP, Reseller, Grosir, atau Pelanggan Baru untuk mempermudah promosi terarah.
• Profil & Metrik Percakapan: Klik nama pelanggan untuk melihat modal profil CRM lengkap dengan total riwayat pesan masuk dan keluar.
• Catatan Preferensi CRM: Simpan catatan khusus untuk setiap pelanggan (misal: "Suka ukuran L warna Navy, langganan catering kantor") yang tersimpan permanen dan dapat dilihat oleh seluruh staf CS.
• Pengecualian Bot (Exclude): Aktifkan sakelar pengecualian pada nomor keluarga, pemasok/supplier, atau teman pribadi agar mereka tidak pernah menerima balasan otomatis dari bot maupun asisten AI.

5. Galeri Berkas & Lampiran Media Toko

Simpan materi promosi toko Anda di menu Manajemen File agar staf CS dapat mengirimkannya secara instan tanpa perlu mengunggah ulang dari HP setiap saat:

• Galeri Media Terpusat: Simpan foto katalog produk, daftar harga, banner diskon, dan berkas PDF brosur usaha.
• Pilihan Sekali Kirim vs Simpan Galeri: Saat mengirim lampiran di Live Chat, Anda dapat memilih opsi Sekali Kirim (hanya terkirim ke pelanggan tanpa memakan kuota memori galeri) atau Simpan ke Galeri File untuk digunakan berulang kali.
• Tautan Publik Aman: Salin tautan gambar atau berkas untuk disematkan pada template Balasan Cepat atau siaran massal.

6. Aturan Kirim Salam Otomatis (14 Hari)

Fitur ini memastikan pelanggan baru atau pelanggan setia yang lama tidak berkabar selalu disambut dengan hangat dan ramah:

• Kriteria Pemicu: Kontak baru yang nomornya belum pernah tercatat, ATAU pelanggan lama yang percakapan terakhirnya sudah lebih dari 14 hari yang lalu.
• Lampiran Sambutan: Anda dapat melampirkan gambar ucapan selamat datang atau file PDF katalog produk unggulan secara otomatis.
• Keamanan Privasi: Kontak yang berada dalam daftar Dikecualikan tidak akan menerima pesan salam otomatis.

7. Pesan Luar Jam Kerja (Away Message)

Ketika toko Anda tutup pada malam hari atau hari libur, sistem akan secara otomatis memberikan respon informatif kepada pelanggan yang mengirim pesan:

8. Balasan Cepat (Shortcut / dan Tombol Baki)

Hemat waktu staf CS dalam menjawab pertanyaan berulang dengan template Balasan Cepat:

• Shortcut Garis Miring: Ketik karakter garis miring / langsung di kolom pengetikan chat untuk membuka daftar rekomendasi template otomatis.
• Tombol Baki Kilat: Klik tombol petir di samping tombol lampiran untuk memilih template pesan menggunakan mouse atau layar sentuh ponsel.

Contoh template bawaan yang sangat bermanfaat untuk toko UMKM:

• /katalog : Mengirim tautan web katalog produk dan foto promo terbaru.
• /rekening : Mengirim nomor rekening pembayaran resmi (BCA, Mandiri, BRI, BNI, dan QRIS toko).
• /ongkir : Mengirim informasi estimasi pengiriman kurir dan ketentuan bebas ongkir.
• /cs : Mengalihkan percakapan langsung ke staf Customer Service manusia.

9. Balasan Otomatis Berdasarkan Kata Kunci (Keyword Auto-Reply)

Atur bot untuk membalas pesan pelanggan secara otomatis apabila pesan yang masuk mengandung kata kunci tertentu:

• Mode Pencocokan: Mendukung pencocokan tepat (Exact Match, misal: pelanggan hanya mengetik kata "MENU") maupun pencocokan kalimat (Contains, misal: ada kata "harga" atau "lokasi" di dalam pesan).
• Balasan Kaya Media: Dapat mengirim teks terformat beserta lampiran foto menu makanan atau berkas brosur PDF.

10. Jadwal Pengiriman Pesan & Broadcast Massal

Kirimkan pesan ke banyak pelanggan secara tertarget tanpa khawatir terblokir oleh algoritma Meta:

• Pesan Terjadwal: Jadwalkan pengingat pembayaran tagihan atau ucapan selamat hari raya pada tanggal dan jam tertentu secara otomatis.
• Broadcast Massal Tertarget: Kirim pengumuman diskon khusus ke ratusan kontak sekaligus berdasarkan label tag (contoh: hanya kirim ke tag Reseller).
• Proteksi Jeda Acak (Anti-Spam): Sistem secara otomatis menyisipkan jeda acak antar pesan (3 hingga 8 detik) untuk memastikan nomor WhatsApp Anda aman dan tidak dicurigai sebagai spammer.

11. Simulasi Mengetik Alami (Anti-Banned Meta)

Bot WhatsApp biasa membalas dalam hitungan 0 milidetik, yang sangat mudah dideteksi oleh sistem anti-bot WhatsApp. NusaMate dilengkapi Algoritma Simulasi Mengetik Dinamis:

12. Agen AI Pintar & Knowledge Base Toko

Asisten AI cerdas NusaMate bertindak layaknya staf toko berpengalaman yang melayani pelanggan 24 jam nonstop:

Anda tidak memerlukan keahlian pemrograman apa pun. Cukup buka tab Agen AI → Knowledge Base di portal, lalu masukkan informasi usaha Anda:

• Profil toko, jam buka operasional, dan lokasi cabang toko.
• Daftar menu / katalog produk lengkap beserta harga dan varian.
• Pertanyaan umum seputar metode pembayaran, pengiriman, dan kebijakan retur produk.

Asisten AI akan menjawab pertanyaan pelanggan secara sopan, akurat, dan sesuai dengan informasi toko yang Anda cantumkan.

13. Eskalasi Pintar ke Staf CS Manusia

Kecerdasan buatan NusaMate mengetahui batasannya. Jika pelanggan mengajukan komplain, menanyakan hal khusus di luar basis data toko, atau meminta berbicara dengan manusia:

• Sistem secara otomatis mengecek staf CS toko Anda yang sedang berstatus Online.
• Percakapan dialihkan secara merata (*round-robin*) ke staf CS yang sedang aktif bertugas.
• Otomasi balasan AI pada kontak tersebut dihentikan sementara agar staf CS Anda dapat menangani pelanggan secara langsung.

14. Autentikasi REST API & API Key Publik

Bagi developer atau pemilik toko yang ingin mengintegrasikan NusaMate dengan website toko online (WordPress, WooCommerce, Shopify) atau sistem kasir POS:

Dapatkan API Key unik toko Anda pada menu API & Webhook di dashboard portal. Sertakan kunci tersebut pada header HTTP pada setiap permintaan API:

15. REST API: Kirim Pesan Teks & Lampiran

Kirimkan notifikasi invoice, resi pengiriman, atau konfirmasi pesanan secara otomatis melalui API publik:

curl -X POST https://api.nusamate.id/api/chats/1/messages \
  -H "Authorization: Bearer nusamate_live_sec_99a8b7c6d5e4f3a2b1c0" \
  -H "Content-Type: application/json" \
  -d '{
    "device_id": "device-1",
    "text": "Halo Kak Siti, pesanan Anda #INV-9921 telah kami kirim via JNE dengan resi: JNE001928192. Terima kasih!",
    "media": {
      "type": "none"
    }
  }'

16. Inbound Webhook (Menerima Pesan Realtime)

Daftarkan URL webhook sistem toko Anda pada menu API & Webhook. NusaMate akan mengirimkan payload HTTP POST secara realtime setiap kali ada pesan baru dari pelanggan:

17. REST API: Health Check & Informasi Paket Publik

Anda dapat memonitor status uptime sistem dan mengambil data katalog paket langganan secara terprogram melalui endpoint publik tanpa autentikasi:

1. System Health Check Publik:

curl -s https://api.nusamate.id/api/health

2. Katalog Paket Langganan & Kurs Realtime:

curl -s https://api.nusamate.id/api/billing/plans

18. Uji API Langsung (Live Playground)

Klik tombol di bawah ini untuk mencoba respon API publik langsung dari peramban web Anda:

19. Kebijakan Kuota Akumulatif & Manajemen Paket

NusaMate menerapkan prinsip keadilan kuota yang ramah bagi pelaku UMKM:

Beralih Paket Fleksibel: Anda dapat memantau penggunaan kuota pesan dan kuota AI secara transparan serta beralih paket (Free, Plus, atau Pro) sewaktu-waktu melalui menu Manajemen Paket di dashboard portal.