Panduan Wacal
Cara pakai Wacal dari nol sampai jago, step by step.
🚀 Mulai pertama kali
Setelah admin bikin akun untuk Anda, ini langkah onboarding-nya:
- Anda akan dapat username + password dari admin.
- Buka URL dashboard yang dikasih admin (mis.
https://nicobot.fly.dev/login). - Login pakai username + password tersebut.
- Sebaiknya langsung ganti password di tombol pojok kanan atas 🔑 Password.
- Lanjut connect Google + pair WhatsApp (di bawah).
🔐 Login dashboard
Dashboard tempat Anda atur semuanya: connect Google, scan QR WA, atur reminder, lihat jadwal, dll.
- Username: 3-32 karakter, huruf/angka/underscore/dash.
- Password: minimal 8 karakter.
- Lupa password? — klik link "Lupa password?" di bawah form login. Atau hubungi admin.
- Anti brute-force aktif: 8 percobaan login gagal per 15 menit per IP otomatis di-block. Akun ter-lock setelah 10 kali gagal beruntun.
🔗 Connect Google Calendar
- Setelah login, di tab Dashboard klik tombol "Sign in with Google".
- Browser redirect ke halaman consent Google. Pilih akun Google Anda.
- Klik "Continue" / "Allow".
- Kalau muncul peringatan "Google hasn't verified this app": klik "Advanced" → "Go to Wacal (unsafe)". Ini wajar di tahap testing — bukan virus, scope-nya hanya Calendar + Tasks (lihat Privacy Policy).
- Setelah sukses, Anda balik ke dashboard. Profil Google muncul di pojok kanan atas.
- Auto-sync otomatis jalan tiap 30 detik — event Anda muncul di tab Dashboard.
Kalau mau cabut akses kapan saja: tombol ✕ di samping profil Google, atau myaccount.google.com/permissions.
💬 Pair WhatsApp
Wacal jadi salah satu "linked device" di akun WhatsApp Anda (sama seperti WhatsApp Web).
- Buka tab WhatsApp di dashboard.
- Pilih salah satu cara:
- Scan QR Code — di HP Anda, buka WhatsApp → Settings → Linked Devices → Link a Device → scan QR di dashboard.
- Pairing Code — kalau tidak bisa scan, klik "Pakai Pairing Code", input nomor WA Anda → bot kasih kode 8 angka. Di HP: Linked Devices → Link with phone number → masukkan kode.
- Setelah connect, status "WA Connected" muncul. Bot siap pakai.
⚠️ Limit WhatsApp: maksimal 4 linked device per akun. Wacal salah satunya. Pastikan slot tersedia.
⌨️ Perintah dasar
Kirim ke nomor WA bot dari nomor WA Anda yang ter-pair:
/help — daftar semua perintah
/today — jadwal hari ini
/tomorrow — jadwal besok
/week — jadwal 7 hari ke depan
/month — jadwal bulan ini
/check 15 Mei — jadwal di tanggal tertentu
/search meeting — cari event
/sync — paksa sync sekarang
/status — status koneksi bot
📅 Bikin / edit / hapus event
Format template
/event Judul | tanggal | jam mulai | jam selesai | lokasi | (repeat: ...)
Pipe (|) sebagai pemisah. Lokasi dan repeat opsional.
Contoh:
/event Meeting Klien | besok | 14:00 | 15:30 | Kantor Pusat
/event Yoga | senin | 18:00 | 19:00 | Studio | (repeat: weekly)
/event Gym | 10 Mei | 06:00 | 07:00 | (repeat: weekly, BYDAY=MO,WE,FR, COUNT=12)
Multi-event (batch)
Kirim banyak event sekaligus:
/batch
Meeting Tim | besok | 09:00 | 10:00 | Zoom
Lunch dgn Andi | besok | 12:00 | 13:30 | Kopi Janji
Standup | jumat | 09:00 | 09:30
Edit event
Setelah /today atau /week, tiap event punya nomor [1] [2] .... Pakai itu untuk edit:
/edit 2 | judul baru | 15:00 | 16:00 — ubah field yang diisi, sisanya tetap
/edit 2 | | | | Lokasi Baru — kosongin yang gak diubah
Hapus event
/del 2 — hapus event referensi [2]
/del 2,3,5 — batch hapus
⏰ Reminder otomatis
Bot kirim WA reminder otomatis sebelum event mulai. Default: 30 menit + 1 jam sebelum.
Plus digest harian: setiap pagi (default 07:00 WIB) bot kirim ringkasan jadwal hari itu.
Atur di dashboard tab Reminder:
- Custom offset (mis. 5 menit, 15 menit, 1 jam, 1 hari).
- Jam digest harian.
- Pilih kalender mana yang dapat reminder (di tab Calendars).
✅ Google Tasks (todo)
/todo Beli kado ulang tahun
/todo Setor pajak, due 30 Mei
/todos — lihat todo aktif
/todos done — lihat yang sudah selesai
/done 1 — tandai todo [1] selesai
/done 1,2,3 — batch
/undone 1 — un-mark
/del-todo 1 — hapus task
🧠 Bahasa natural (AI)
Anda gak harus inget format /event Title | ... | .... Cukup ketik bebas,
AI Wacal parse otomatis:
"Tolong bikin meeting tim besok jam 10 sampai 11 di Zoom"
"Reminder yoga setiap selasa kamis jam 6 sore di studio dekat rumah"
"Bikin event ulang tahun mama 15 Mei seharian, judul: Ultah Mama"
AI cukup pintar untuk multi-event sekaligus juga:
"Senin saya ada meeting jam 9, lalu lunch dengan klien jam 12, dan training jam 3 sore"
Catatan: AI bisa salah parse kadang. Cek hasil dari pesan konfirmasi bot, kalau salah, edit/hapus
dengan /edit atau /del.
⚙️ Settings
Di dashboard ada beberapa tab settings:
- Reminder — atur offset reminder + jam digest harian.
- Calendars — pilih kalender Google mana yang di-sync. Default: semua yang Anda tampilkan di Google Calendar app.
- Credentials — Gemini API key Anda (kalau ingin pakai key sendiri), nomor owner, allowed LIDs (untuk WhatsApp privacy LID feature).
🛠 Troubleshooting
Bot tidak balas perintah
- Cek tab Dashboard → status WA "Connected"?
- Cek nomor pengirim — bot hanya merespons nomor owner / nomor di allowed LIDs.
- Coba
/syncdan/status— bot harusnya balas instan. - Kalau status WA "Disconnected": buka tab WhatsApp → re-pair / scan QR ulang.
Calendar disconnect (~7 hari sekali)
Selama Wacal masih dalam mode "testing" di Google, refresh token Google Anda akan expire setiap 7 hari. Solusinya: buka dashboard → klik "Sign in with Google" lagi. Setelah Wacal lolos verifikasi Google nanti, masalah ini hilang permanen.
Reminder tidak terkirim
- Cek WA bot masih connected.
- Cek di tab Reminder — apakah event muncul di list pending?
- Cek apakah Anda sudah "/help" sekali ke bot — bot perlu chat sekali untuk tau JID Anda.
- Cek di tab Calendars — kalender event-nya di-enable?
AI parse salah
Bot kirim pesan konfirmasi setelah event dibuat. Kalau salah, hapus dengan /del <ref> dan coba lagi dengan kata-kata lebih spesifik (sertakan tanggal lengkap, jam mulai-selesai).
❓ Bantuan / kontak
Stuck atau ada bug? Hubungi admin via halaman About — ada nomor WA + email.