Buka Terminal (Mac), PowerShell (Windows), atau terminal browser di panel VPS Anda, lalu masuk dengan IP dan password root dari email penyedia.

ssh root@IP_VPS

Saat pertama kali muncul konfirmasi, ketik yes. Ketika memasukkan password, kursor memang tidak bergerak; itu normal.

Ditolak dengan Permission denied (publickey)? Paksa jalur password:

ssh -o PreferredAuthentications=password root@IP_VPS

Ganti key dan email dengan yang ada di email aktivasi Anda. Salin, jangan mengetik ulang.

curl -fsSL https://vicca.id/install.sh -o install.sh
sudo bash install.sh --key VICCA-XXXX-XXXX --email email@anda.com

Yang terjadi berurutan: lisensi diverifikasi, Docker dipasang bila belum ada, image Vicca diunduh, container dinyalakan, lalu installer menunggu Vicca siap. Lima sampai sepuluh menit di VPS kecil.

Saat installer menanyakan domain, kosongkan bila Anda akan memakai Cloudflare Tunnel. Tunnel yang menyediakan HTTPS untuk Anda.

Cara manual: unduh vicca-image.tar.gz dari bagian Unduhan, unggah ke folder /root (lewat File Manager panel atau scp vicca-image.tar.gz root@IP_VPS:/root/), lalu jalankan sudo bash install.sh dari folder yang sama. Installer memakai berkas itu dan melewati unduhan.

curl -s -o /dev/null -w "%{http_code}\n" http://localhost:8090/healthz
cd /opt/vicca && docker compose ps

Harus menampilkan 200. Bila belum, lihat log sebelum mengubah apa pun, karena memperbaiki dua hal sekaligus membuat penyebabnya tidak terlihat:

cd /opt/vicca && docker compose logs --tail 50 vicca

Buka http://IP_VPS:8090 di browser. Setelah tunnel aktif (bagian Sambungkan), pakai alamat HTTPS Anda, misalnya https://bot.tokoanda.com.

1. Buat akun admin dengan email dan kata sandi Anda sendiri. Tidak ada yang bisa masuk selain Anda, termasuk kami.
2. Tempel license key dan email pembelian.
3. Isi nama brand dan gaya bahasa. Kolom gaya bahasa berisi contoh berbahasa Inggris; ganti dengan kalimat Anda sendiri. Bila dibiarkan, bot memakai contoh itu apa adanya.

• AI (OpenRouter): buat kunci di openrouter.ai, isi saldo, tempel di kartu AI. Satu kunci membuka banyak model, dan biaya tiap panggilan tercatat di menu Biaya AI.
• WhatsApp: pilih penyedia (Kapso resmi, KirimWA, atau pindai QR). Pindai QR tidak resmi dan membawa risiko nomor diblokir, jadi pakai untuk uji saja.
• Instagram: akun bisnis Instagram, token, dan app secret. Langkahnya ada di bagian Sambungkan.

Buka menu Uji bot, ketik pertanyaan yang biasa ditanyakan pelanggan, dan lihat balasan yang akan dikirim beserta sumber catatan dan biayanya. Belum ada pesan yang terkirim di tahap ini.

Setelah webhook tersambung, kirim satu pesan dari akun lain. Pemasangan baru selesai saat pesan itu masuk ke Inbox dan bot membalasnya.

Daftar akun Cloudflare gratis, tambahkan domain Anda, lalu arahkan nameserver domain ke Cloudflare di registrar. Tunggu sampai status domain di Cloudflare menjadi aktif. Anda cukup memakai satu subdomain, misalnya bot.tokoanda.com.

Ubuntu atau Debian (64-bit):

curl -L -o cloudflared.deb https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-amd64.deb
sudo dpkg -i cloudflared.deb

AlmaLinux atau Rocky:

curl -L -o cloudflared.rpm https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-x86_64.rpm
sudo rpm -i cloudflared.rpm

Lalu masuk ke Cloudflare dan buat tunnel bernama vicca:

cloudflared tunnel login
cloudflared tunnel create vicca

tunnel login menampilkan tautan; buka di browser dan pilih domain Anda. tunnel create mencetak ID tunnel dan lokasi berkas kredensial /root/.cloudflared/ID_TUNNEL.json. Catat ID itu.

Buat berkas /etc/cloudflared/config.yml:

sudo mkdir -p /etc/cloudflared
sudo nano /etc/cloudflared/config.yml

Isi dengan berikut, ganti ID_TUNNEL dan subdomainnya:

tunnel: ID_TUNNEL
credentials-file: /root/.cloudflared/ID_TUNNEL.json
ingress:
  - hostname: bot.tokoanda.com
    service: http://localhost:8090
  - service: http_status:404

Lalu buat rute DNS-nya:

cloudflared tunnel route dns vicca bot.tokoanda.com

sudo cloudflared service install
sudo systemctl status cloudflared

Uji dari laptop Anda, bukan dari VPS:

curl https://bot.tokoanda.com/healthz

Bila menjawab, Vicca sudah bisa dijangkau Meta. Isi juga VICCA_PUBLIC_URL di Pengaturan, bagian Integrasi, dengan https://bot.tokoanda.com agar Instagram bisa memuat gambar posting yang dibuat Vicca.

Masuk ke developers.facebook.com, buat aplikasi baru atas nama bisnis Anda, lalu tambahkan produk WhatsApp, Instagram, atau keduanya. Akun Instagram harus akun bisnis.

Memakai Kapso untuk WhatsApp? Alamat webhook WhatsApp didaftarkan di dashboard Kapso, dengan alamat yang sama seperti langkah berikut.

Callback URL:

https://bot.tokoanda.com/api/wa/webhook
https://bot.tokoanda.com/api/ig/webhook

• Verify token: ambil dari Vicca, Pengaturan, bagian Integrasi (kolom verify token WhatsApp dan Instagram). Nilainya harus sama persis di Meta.
• App secret: di aplikasi Meta buka Pengaturan aplikasi, Dasar, lalu salin Kunci rahasia aplikasi. Tempel di kolom WA_APP_SECRET (WhatsApp) dan IG_APP_SECRET (Instagram) di Vicca.

Di bagian Webhooks, langganan field messages untuk WhatsApp, serta messages dan comments untuk Instagram. Bila comments terlewat, DM masuk tetapi komentar tidak.

Kirim satu pesan dari akun lain, lalu lihat Inbox. Dari VPS Anda bisa memantau log:

cd /opt/vicca
docker compose logs vicca | grep -i webhook

Satu organisasi bisa memegang banyak brand. Setiap brand punya suara, pengetahuan, dan kunci AI sendiri. Pastikan brand yang aktif sudah benar sebelum mengubah apa pun, karena semua pengaturan berlaku untuk brand itu.

Tambahkan anggota tim di Pengaturan dan beri peran yang sesuai, supaya tidak semua orang memakai satu akun.

Unggah sumber: tangkapan layar chat, PDF, atau tempel teks. AI mengusulkan temuan yang Anda setujui, edit, atau tolak. Cara tercepat: salin 20 pertanyaan terakhir dari calon pembeli dan tulis jawabannya. Bila jawaban tidak ada di pengetahuan, bot meneruskan ke tim alih-alih mengarang.

Di Konfigurasi, atur suara brand, model AI, dan perilaku bot. Di Uji bot, ketik pesan pelanggan dan lihat balasannya lengkap dengan sumber, waktu, dan biaya dalam Rupiah. Hanya draf, tidak ada pesan terkirim. Batasnya 30 uji per jam per pengguna.

Instagram: perlu akun bisnis Instagram. Untuk akun pelanggan baru, sambungan Instagram masih mengikuti tinjauan aplikasi Meta yang sedang berjalan, jadi masuk lewat jalur pilot sampai tinjauan selesai.

WhatsApp: lewat penyedia seperti Kapso atau KirimWA atas nama Anda. WhatsApp resmi memerlukan persetujuan Meta untuk nomor Anda, dan waktunya di luar kendali kami.

Jawab kartu di Latih bot untuk pertanyaan yang belum terjawab; jawabannya masuk ke pengetahuan. Buat aturan di Comment Autoreply untuk komentar yang jawabannya selalu sama. Pantau pemakaian di Biaya AI.

Nonaktif (disarankan di awal): setiap aksi keluar meminta persetujuan Anda dulu.

Aktif: asisten menjalankan aksi keluar tanpa bertanya. Tetap ada batas aman, misalnya batas jumlah posting dan DM per jam, agar tidak terjadi pengiriman berlebihan. Aktifkan setelah Anda mengenal hasilnya.

Pindah brand lewat pemilih brand di bagian atas aplikasi. Setelah berpindah, Asisten, Inbox, dan menu lain menyesuaikan brand tersebut. Salah memilih brand? Pilih yang benar, lalu ulangi perintah di percakapan baru.

MCP memberi asisten AI luar izin menjalankan Vicca atas nama Anda. Alamat servernya adalah alamat aplikasi Anda ditambah /mcp:

https://app.vicca.id/mcp          # Cloud
https://bot.tokoanda.com/mcp      # Engine di server Anda

1. Buka bagian MCP, salin alamat server yang tertera.
2. Klik buat kunci baru dan beri nama, misalnya "Claude saya". Biarkan izin aksi keluar otomatis nonaktif, sehingga asisten luar hanya bisa membaca dan membuat draf.
3. Salin kuncinya. Kunci hanya ditampilkan sekali.
4. Tambahkan koneksi MCP baru di aplikasi asisten luar dengan alamat dan kunci tersebut.

Setiap kunci terikat pada satu brand. Kunci yang tidak dipakai lagi cukup dicabut dari daftar; koneksinya langsung berhenti.

Aktivitas alat mencatat setiap tindakan, dari chat Vicca maupun asisten luar: waktu, sumber, jenis tindakan, dan statusnya. Biaya AI menampilkan pemakaian per brand dalam Rupiah.

Asisten tidak merespons atau menampilkan "LLM belum aktif". Aktifkan AI di dashboard dan pastikan model yang dipilih mendukung pemanggilan alat.

Tindakan ditolak karena batas tercapai. Itu pengaman otomatis. Coba lagi beberapa saat kemudian.

Amankah memberi kunci MCP ke asisten luar? Aman selama izin aksi keluar nonaktif, karena asisten luar hanya bisa membaca dan membuat draf. Aktifkan izin keluar hanya untuk kunci yang benar-benar Anda percaya.