🤖Wacal

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:

  1. Anda akan dapat username + password dari admin.
  2. Buka URL dashboard yang dikasih admin (mis. https://nicobot.fly.dev/login).
  3. Login pakai username + password tersebut.
  4. Sebaiknya langsung ganti password di tombol pojok kanan atas 🔑 Password.
  5. Lanjut connect Google + pair WhatsApp (di bawah).

🔐 Login dashboard

Dashboard tempat Anda atur semuanya: connect Google, scan QR WA, atur reminder, lihat jadwal, dll.

🔗 Connect Google Calendar

  1. Setelah login, di tab Dashboard klik tombol "Sign in with Google".
  2. Browser redirect ke halaman consent Google. Pilih akun Google Anda.
  3. Klik "Continue" / "Allow".
  4. 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).
  5. Setelah sukses, Anda balik ke dashboard. Profil Google muncul di pojok kanan atas.
  6. 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).

  1. Buka tab WhatsApp di dashboard.
  2. 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.
  3. 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:

✅ 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:

🛠 Troubleshooting

Bot tidak balas perintah

  1. Cek tab Dashboard → status WA "Connected"?
  2. Cek nomor pengirim — bot hanya merespons nomor owner / nomor di allowed LIDs.
  3. Coba /sync dan /status — bot harusnya balas instan.
  4. 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

  1. Cek WA bot masih connected.
  2. Cek di tab Reminder — apakah event muncul di list pending?
  3. Cek apakah Anda sudah "/help" sekali ke bot — bot perlu chat sekali untuk tau JID Anda.
  4. 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.