⚡
ZippBiz Automator
Buku Panduan Visual Resmi • Self-Hosted Gateway
🔍
🏬 Panduan Toko 👤 Member Area
⚡ DOKUMENTASI SISTEM RESMI

Panduan Lengkap ZippBiz Automator

ZippBiz Automator adalah perangkat lunak WhatsApp Gateway & Command Center mandiri (Self-Hosted) yang berjalan 100% di infrastruktur serverless Cloudflare Pages pribadi Anda. Bebas biaya langganan server bulanan, privasi chat 100% aman, dan aktif 24 jam nonstop.

🛡️ Dual-Device Shield (2 Nomor WA) ☁️ Cloudflare Pages Direct Upload 📦 KV Storage ZBA_INBOX 🤖 Human Presence Emulation (Anti-Banned)
⚡

1. Arsitektur Mandiri & Dual-Device Shield

Pondasi single-tenant serverless yang menjamin privasi dan stabilitas gateway toko Anda

Berbeda dengan vendor gateway sewa bulanan yang menaruh ratusan nomor toko dalam 1 server bersama (berisiko rebutan kuota dan pemblokiran massal), ZippBiz Automator mengadopsi prinsip Single-Tenant Self-Hosted:

📱
Perangkat 1 (Kasir & Notifikasi)
Dikhususkan untuk nomor resmi transaksi toko: pengiriman kode OTP login, faktur pesanan PDF, konfirmasi transfer otomatis, dan resi pengiriman ekspedisi.
💬
Perangkat 2 (CS AI & Siaran Promosi)
Dikhususkan untuk nomor tim customer service (CS), balasan bot cerdas 24 jam, pengingat keranjang belanja ditinggalkan (abandoned cart), dan promosi broadcast massal.
Tampilan Perangkat WhatsApp Terhubung di Automator
Gambar 1: Tampilan Command Center Perangkat & Server setelah KV binding aktif dan sesi WhatsApp tertaut. 🔍 Klik untuk perbesar
🚀

2. Pemasangan Cepat 3 Menit ke Cloudflare Pages

Panduan pemasangan dari berkas Starter Installer hingga sistem Full Command Center aktif
1
Unduh Starter Installer ZIP
Buka tab pesanan Anda di /member atau halaman Portal Akses Automator. Unduh file ZippBiz-Automator-Starter.zip (~7.5 KB). (Catatan: Berkas ini jangan diekstrak di komputer Anda).
2
Unggah ke Cloudflare Pages (Direct Upload)
Masuk ke dash.cloudflare.com > Menu Workers & Pages > Klik Create application > Pilih tab Pages > Klik Upload assets.
Beri nama project Anda (misal: automator-toko), lalu tarik file ZIP tadi ke area upload dan klik Deploy site.
3
Aktivasi Full Version Otomatis
Buka domain Pages yang baru aktif (misal: https://automator-toko.pages.dev). Masukkan Kode Lisensi Anda dan Cloudflare API Token Anda (token dengan izin Cloudflare Pages: Edit). Klik "Verifikasi Lisensi & Pasang Full Version". Dalam 10 detik sistem langsung berubah menjadi Full Command Center!
📦

3. Konfigurasi KV Namespace (ZBA_INBOX) & Penyimpanan Server

Langkah mandatori agar sesi WhatsApp, token, dan pesan masuk tersimpan permanen di cloud

Cloudflare Pages Worker berjalan secara *stateless* (tidak menyimpan data di RAM secara permanen). Oleh karena itu, ZippBiz Automator menerapkan standar Fail-Closed Security yang mewajibkan adanya satu binding database bernama ZBA_INBOX.

💡
Mengapa Wajib? Tanpa binding ZBA_INBOX, token WhatsApp perangkat tidak dapat diungkap secara aman, bot auto-reply tidak dapat mencatat cooldown anti-spam, dan pesan masuk di tab Inbox WA tidak dapat tersimpan.
A
Buat KV Namespace di Cloudflare
Buka Cloudflare Dashboard > Menu kiri: Storage & Databases > KV > Klik tombol Create namespace > Beri nama persis: ZBA_INBOX > Klik Add.
B
Hubungkan Binding ke Pages Project
Masuk ke Workers & Pages > Klik project Automator Anda > Tab Settings > Menu Functions > Gulir ke bawah ke bagian KV namespace bindings > Klik Add binding:
Variable name : ZBA_INBOX (Wajib huruf kapital persis seperti ini) KV namespace : Pilih ZBA_INBOX yang tadi Anda buat
Klik tombol Save.
Panduan Setup KV Namespace ZBA_INBOX di Cloudflare Pages
Gambar 2: Pengaturan KV Namespace di Cloudflare Storage & Pages Settings Functions. 🔍 Klik untuk perbesar
⚠️

4. Solusi Error KV Binding & Pembaruan 1-Klik Saluran

Penanganan tuntas saat muncul toast error penyimpanan server dan cara re-deploy tanpa Git
🚨
Gejala Masalah: Muncul toast merah di sudut kanan bawah antarmuka Automator:
"Penyimpanan server (KV binding ZBA_INBOX) belum dikonfigurasi."
Bukti Notifikasi Error KV Binding ZBA_INBOX
Gambar 3: Notifikasi toast merah di pojok kanan bawah yang muncul saat binding ZBA_INBOX belum aktif di deployment. 🔍 Klik untuk perbesar

Mengapa Tombol "Retry deployment" Tidak Ada di Cloudflare?

Di Cloudflare Pages, project yang dibuat melalui metode Direct Upload (unggah file ZIP mandiri, bukan Git repository) memang tidak memiliki tombol "Retry deployment" di dashboard Cloudflare. Hal ini wajar karena tidak ada Git repository yang bisa ditarik ulang oleh Cloudflare.

Solusi Praktis: Picu Deployment Baru via Menu "⚡ Versi & Saluran"

Setelah Anda selesai menambahkan binding ZBA_INBOX di Cloudflare Settings, lakukan langkah ini di dashboard Automator Anda:

1
Buka Menu "⚡ Versi & Saluran"
Di bilah navigasi sebelah kiri Automator Anda, klik menu paling bawah: ⚡ Versi & Saluran.
2
Klik "Cek Pembaruan" atau Kartu "🟢 Versi Stable"
Klik tombol 🔄 Cek Pembaruan atau tombol ✓ Sedang Digunakan (Aktif). Modal dialog Pembaruan Cloudflare Pages 1-Klik akan otomatis muncul di tengah layar.
3
Klik "🚀 Mulai Pembaruan"
Pastikan nama project Cloudflare Pages Anda sesuai (misal: mitrasol-automator), lalu klik tombol kirim pembaruan. Server ZippBiz akan mengunggah paket deployment segar langsung ke Cloudflare Pages Anda.
Pembaruan 1-Klik Saluran Automator Pengganti Retry Deployment
Gambar 4: Modal pembaruan 1-klik yang memicu pembuatan deployment segar di Cloudflare Pages agar KV binding aktif instan. 🔍 Klik untuk perbesar
🎉
Hasil Selesai: Setelah pembaruan 100% dan halaman me-reload, Cloudflare Pages telah mengikat binding ZBA_INBOX. Error toast merah tidak akan pernah muncul lagi dan seluruh tombol sinkronisasi siap digunakan!
📱

5. Scan QR & Menghubungkan Perangkat WhatsApp

Cara menautkan nomor WhatsApp toko Anda via kamera QR Code atau nomor telepon
1
Buka Menu "Perangkat & Server"
Klik tombol ⚡ Hubungkan WA pada kartu perangkat utama Anda, atau klik tombol + Tambah Perangkat di sudut kanan atas jika ingin menambah nomor kedua.
2
Pilih Metode Sambungan: Scan QR Code atau Nomor HP
Opsi A (Scan Kamera): Kode QR WhatsApp resmi akan muncul di layar. Buka WhatsApp di HP > Menu Titik Tiga / Setelan > Perangkat Tertaut > Arahkan kamera HP ke QR Code.
Opsi B (Tanpa Kamera / Pairing Code): Masukkan nomor WhatsApp Anda (format: 628xxxx), sistem akan menghasilkan 8-digit kode pairing untuk dimasukkan di notifikasi WhatsApp HP Anda.
3
Status Berubah 🟢 Terhubung
Segera setelah tertaut, status sesi otomatis berubah menjadi 🟢 Terhubung. Nomor telepon dan nama perangkat tersimpan secara aman di KV Storage Anda.
🔌

6. Integrasi REST API (3 Pilar Kredensial)

Menghubungkan Automator ke WooCommerce, CatatDuit, Form Pesanan, atau Webhook Luar

Untuk mengirim pesan otomatis dari aplikasi luar, toko online, atau sistem backend Anda, Anda hanya memerlukan 3 Kredensial berikut:

1️⃣
Gateway Base URL
Alamat URL proxy serverless Automator Anda:
https://<nama-project-anda>.pages.dev/api/proxy
2️⃣
API Key (Header X-License-Key)
Sertakan kode lisensi resmi Automator Anda pada header setiap request HTTP:
X-License-Key: ZIP-AUTO-XXXX-XXXX-XXXX
3️⃣
Device Key (ID Sesi Perangkat)
ID perangkat target pengiriman pesan (misal: dev_921e2e42) yang dapat disalin dari kartu perangkat di menu Perangkat & Server.

Contoh Request Kirim Pesan Teks (cURL):

curl -X POST "https://mitrasol-automator.pages.dev/api/proxy" \ -H "Content-Type: application/json" \ -H "X-License-Key: ZIP-AUTO-XXXX-XXXX-XXXX" \ -d '{ "endpoint": "/chat/send/text", "method": "POST", "data": { "Phone": "6281234567890", "Body": "Halo! Pesanan toko Anda #INV-1092 telah berhasil dikonfirmasi." } }'
🏬
Koneksi 1-Menit ke Toko Online ZippBiz Store:
Buka Panel Admin ZippBiz Store Anda (admin.html) → masuk ke menu Pengaturan → Komunikasi & Pesan. Pilih gateway pengiriman sebagai ZippBiz Automator, kemudian tempelkan Gateway Base URL dan Device Key Anda. Klik Simpan Pengaturan. Seluruh notifikasi transaksi otomatis (faktur, OTP, bukti bayar, resi paket) langsung terkirim lewat WhatsApp Gateway pribadi Anda!
👥

7. Buku Kontak CRM, Tag & Pembersih Nomor LID

Segmentasi database pelanggan, grup folder, dan pembersih format nomor obrolan WhatsApp

Automator dilengkapi sistem database CRM mandiri (Cloudflare D1 DB_AUTOMATOR) dengan antarmuka 2 kolom yang responsif untuk mengelola ribuan data prospek dan pelanggan.

🏷️
Pelabelan Tag Pelanggan Cerdas
Tandai pelanggan berdasarkan status interaksi (misal: "VIP Buyer", "Reseller", "Pending Transfer", "Alumni Webinar") untuk mempermudah broadcast terarah.
📁
Pengelompokan Folder & Grup WhatsApp
Kelola kontak dalam folder kampanye atau grup interaksi. Sistem secara otomatis mendeteksi nama grup WhatsApp resmi dari server Whatsmeow.
🧹
Pembersih Privasi LID (Fitur Ikon Sapu)
WhatsApp kerap menyamarkan nomor obrolan dalam format LID (@lid). Tombol Sapu Bersih LID di pojok kanan atas secara otomatis memvalidasi dan memulihkan nomor ponsel riil yang valid agar pengiriman pesan massal tidak terpental.
📢

8. Pesan Massal & Blast Scheduler Server

Broadcast terjadwal di level cloud server Cloudflare tanpa membebani browser atau kuota lokal

Di tab Pesan Massal, Anda dapat menjadwalkan siaran promosi atau reminder massal ke ratusan kontak sekaligus dengan interval pengiriman otomatis (*safe anti-ban delay*).

⏱️
Antrean Pengiriman Otomatis (Safe Interval Delay):
Sistem secara mandiri memberikan jeda acak 5-15 detik antar pesan. Hal ini menjamin tingkat keterkiriman tinggi (*high deliverability*) dan meminimalisir risiko penandaan spam oleh sistem keamanan WhatsApp.
🛡️

9. Manajemen Tim Staf / CS & Hak Akses PIN

Proteksi Multi-Tier RBAC untuk melindungi kredensial server dan token sensitif

Jika bisnis Anda memiliki tim Customer Service atau admin pesan, Automator menyediakan menu Tim Staf & CS dengan pembatasan hak akses berbasis PIN 6-digit.

👑
Tingkat Master Admin
Memiliki akses penuh untuk scan QR, kelola token Cloudflare, hapus data, dan mengubah webhook atau konfigurasi server.
🎧
Tingkat Staf CS Operasional
Hanya memiliki hak akses untuk membalas pesan di Inbox WA, melihat kontak, dan menggunakan template pesan tanpa dapat melihat atau mengubah Token Rahasia API.
🤖

10. Bot Auto-Reply & Webhook Pesan Masuk

Menjawab otomatis pertanyaan calon pembeli 24 jam dengan proteksi anti-spam Meta

Di tab Bot Auto-Reply, Anda dapat mendaftarkan kata kunci pemicu (keyword trigger) seperti "katalog", "ongkir", "rekening", "harga". Begitu pesan pelanggan masuk, serverless worker akan otomatis merespons pesan tersebut dalam 1-2 detik.

🛡️
Fitur Anti-Banned Meta (Human Presence Emulation):
Automator secara otomatis mengirimkan sinyal status "sedang mengetik..." (composing presence) selama 1.2 detik sebelum pesan balasan terkirim. Hal ini membuat traffic pesan terbaca 100% natural oleh algoritma Meta WhatsApp.
❓

11. Pertanyaan Umum (FAQ) & Pusat Bantuan

Jawaban atas pertanyaan yang paling sering ditanyakan oleh pemilik toko
Q1
Apakah komputer atau browser saya harus tetap menyala?
Tidak perlu sama sekali! Setelah QR Code di-scan, seluruh logika gateway, antrean pesan, dan bot auto-reply berjalan mandiri di server Cloudflare Edge global 24 jam nonstop, bahkan saat laptop Anda dimatikan atau HP Anda offline sementara.
Q2
Apakah ada biaya langganan bulanan server Cloudflare?
Biaya server Rp 0! Akun gratis Cloudflare memberikan kuota 100.000 permintaan worker per hari dan 100.000 operasi KV per hari, yang lebih dari cukup untuk menangani puluhan ribu pesan transaksi toko Anda setiap bulan tanpa biaya sepeser pun.
Q3
Bagaimana jika saya ingin mengganti nomor WhatsApp yang tertaut?
Buka tab Perangkat & Server > Klik ⚙️ Kelola Perangkat > Klik Putus Sesi (Logout). Setelah terputus, klik tombol Hubungkan Ulang (Scan Baru) untuk menautkan nomor WhatsApp yang baru.

Masih Membutuhkan Bantuan Teknis?

Tim teknisi resmi ZippBiz siap mendampingi Anda hingga WhatsApp Gateway Automator Anda aktif sempurna dan terintegrasi ke toko Anda.

💬 Buka Live Chat Toko (/chat) 🟢 WhatsApp CS (0898-0880-809)