Riwayat Pesanan Otomatis Juragan

Setiap checkout (WhatsApp maupun Bayar Online) tercatat otomatis ke Google Sheet Anda. Tanpa server, tanpa biaya bulanan.

Selesaikan panduan ini dulu sebelum Pembayaran Online

Jika Anda berencana memakai pembayaran online Midtrans, halaman ini wajib diselesaikan lebih dulu: pembayaran online memakai URL webhook yang dipasang di sini. Tanpa webhook, tema menyembunyikan metode Bayar Online di checkout dan generator Kode Pengaturan menolak mengaktifkannya. Panduan pembayaran online ada di halaman Pembayaran Online Midtrans.

1. Salin template Sheet

Buka link template berikut (tautan ini juga tersedia di halaman unduhan tema):

https://docs.google.com/spreadsheets/d/17nnSYtKV4v2kwn8Rl1aYfnY1Y68BQy4yTCfpmVTEq1k/copy

Google menampilkan dialog "Salin dokumen". Login dengan akun Google pilihan Anda (tidak harus sama dengan akun Blogger), lalu klik Buat salinan. Spreadsheet beserta script pencatat pesanan ikut tersalin otomatis.

TIP

Salinan terbuka otomatis di tab baru dan menjadi milik Anda sepenuhnya. Tidak perlu mengubah apa pun.

2. Deploy sebagai Web app

Di spreadsheet salinan, buka menu Ekstensi, lalu klik Apps Script.

Klik tombol Terapkan (Deploy) di kanan atas, lalu pilih Deployment baru.

Pastikan: Jalankan sebagai = Saya (...@gmail.com), Yang memiliki akses = Siapa saja. Klik Terapkan.

Mengapa "Siapa saja"?

Yang memanggil URL ini adalah pengunjung blog (tidak login Google). "Jalankan sebagai Saya" artinya data ditulis ke Sheet Anda.

3. Izinkan akses (sekali)

Setelah klik Terapkan, Google meminta izin akses. Klik Izinkan akses.

Layar "Google hasn't verified this app"

Ini bukan tanda bahaya. Google menampilkannya untuk semua script web app yang masih baru. Cukup klik Advanced, lalu Go to DATA PESANAN SCRIPT (unsafe).

Centang semua, lalu klik Continue. Cukup sekali; layar izin tidak muncul lagi.

4. Salin URL web app

Deployment selesai. Google menampilkan URL web app berbentuk https://script.google.com/macros/s/XXXX/exec. Klik tombol Salin di sebelah URL.

URL ini adalah alamat webhook yang dipakai tema untuk mengirim data pesanan. Simpan dulu.

5. Pasang webhook di tema

1. Buka Generator Kode Pengaturan di https://tools.sugeng.id/juragan-setting/.
2. Buka grup Fitur tingkat lanjut.
3. Isi kolom URL Webhook (Google Script) dengan URL dari langkah 4.
4. Klik Buat Kode, salin seluruh kode, lalu tempel ke widget Kode Pengaturan Template di menu Tata Letak (ganti isi lama), klik Simpan.

Sudah punya kode pengaturan lain?

Tidak perlu generate ulang dari awal. Tambahkan saja baris orderWebhookUrl : "https://script.google.com/macros/s/XXXX/exec" di dalam objek themeSetting yang sudah ada (ganti URL dengan milik Anda).

Kompatibilitas

Pemasangan lama lewat widget Custom JavaScript Footer (window.JURAGAN_ORDER) masih didukung, tetapi cara resmi adalah lewat Kode Pengaturan Template di atas.

6. Uji coba

1. Buka blog dari HP (mode incognito).
2. Pilih produk, checkout, isi form pembeli, kirim ke WhatsApp.
3. Buka Google Sheet salinan tadi: baris order baru muncul dengan nomor diawali JRG.
4. Kolom Item menampilkan rincian produk (varian ikut tercatat, contoh: 1x Tas Anyaman Rotan (Ukuran: M, Warna: Cokelat)).
5. Status order diubah manual: Baru → Diproses → Dikirim → Selesai.

Batasan otomatis (anti-spam)

Untuk melindungi Sheet dari data palsu, script membatasi maksimal 50 order per nomor WhatsApp per 10 menit dan 120 order total per menit. Batasan ini jauh di atas pemakaian toko normal. Order yang ditolak tidak memengaruhi checkout WhatsApp pembeli.

7. Notifikasi Telegram (opsional)

1. Buat bot lewat @BotFather di Telegram (/newbot), salin token bot.
2. Cari ID chat Anda lewat @userinfobot (/start).
3. Di editor Apps Script (Ekstensi → Apps Script) buka Project Settings → Script properties, tambahkan dua property: TELEGRAM_TOKEN (token bot) dan TELEGRAM_CHAT_ID (ID chat), lalu Save.

Setiap order baru masuk, Anda mendapat notifikasi Telegram berisi nomor order, total, item, nama, WhatsApp, dan alamat pembeli.

Lanjutkan ke: Pembayaran Online Midtrans (opsional, untuk terima pembayaran QRIS / Virtual Account / E-Wallet).