Panduan Mokapen

WooCommerce

Hubungkan Anda WooCommerce (WordPress) simpan ke Mokapen untuk dibawa pelanggan (kontak), produk (dengan variasi dan stok), dan simpan pesanan ke dalam CRM, dan untuk mengekspor produk yang dibuat atau diperbarui di Mokapen ke WooCommerce jika arah sinkronisasi memungkinkan. Tujuan yang sama seperti Shopify: menyatukan e-commerce dan manajemen penjualan di ruang kerja yang sama.

Gambaran umum: Integrasi. Pesanan impor menjadi pesanan penjualan di Mokapen (modul Pesanan), bukan peluang saluran pipa.

Persyaratan

• Situs WordPress dengan aktif WooCommerce, dapat dijangkau HTTPS.
• Izin otorisasi Mokapen melalui Otentikasi WC aliran (Administrator WordPress / WooCommerce).
• Sebuah Premi yang sesuai Rencana Mokapen untuk integrasi e-commerce. Tanpa rencana, tombol sambungkan membuka layar peningkatan.
• Izin Mokapen pada kontak, produk, dan pesanan di organisasi Anda (lihat Peran dan izin).
• Akses ke Integrasi (anggota/admin bergantung pada label putih dan peran organisasi).

Hubungkan toko WooCommerce

1. Menu pengguna → Integrasi → WooCommerce.
2. Masukkan alamat web toko (URL situs, mis. https://domainanda.com). Anda menemukannya di bilah alamat saat Anda berada di backend WordPress/etalase WooCommerce.
3. Mulai otorisasi: Anda diarahkan ke WordPress/WooCommerce ke Otentikasi WC halaman (/wc-auth/v1/authorize) dengan baca_tulis cakupan.
4. Terima pembuatan kunci API untuk Mokapen (kunci/rahasia konsumen disimpan terenkripsi di Mokapen — tidak ada formulir manual «tempel kunci API»).
5. Kembali ke Mokapen: tokonya terhubung. Mokapen mendaftarkan WooCommerce webhook (/wp-json/wc/v3/webhook) untuk menerima pembaruan waktu nyata.

Jika Anda tidak menerima otorisasi, tidak ada data yang disinkronkan. URL harus valid dan HTTPS: jika tidak, validasi akan gagal.

Apa yang diminta Mokapen dari WooCommerce

Aliran WC Auth memberi Mokapen akses baca/tulis ke REST API WooCommerce yang diperlukan untuk pelanggan, produk (dan variasi), pesanan, dan webhook. Mokapen tidak menggantikan panel WooCommerce/WordPress untuk tema, pembayaran, atau plugin: panel ini menyelaraskan data ke (dan, untuk produk, dari) CRM.

Jika Anda mencabut kunci atau menghapus otorisasi di sisi WordPress, putuskan sambungan dan sambungkan kembali dari Mokapen.

Apa yang disinkronkan

Menuju Mokapen (impor/webhook)

• Pelanggan → Kontak — Pelanggan WooCommerce di buku alamat (dan perusahaan jika data memungkinkan). Pembaruan juga melalui webhook.
• Produk dan variasi → Produk — katalog dengan variasi; WooCommerce saham (stok_kuantitas) dipetakan ke kuantitas varian Mokapen.
• Pesanan → Pesanan — Pesanan WooCommerce menjadi pesanan penjualan di Mokapen (dengan item baris), bukan kesepakatan saluran. Webhook tentang pembaruan.
• Gerobak/laporan terbengkalai — sebutan pemasaran atau entri "Segera hadir" di UI tidak sama dengan impor pelaporan keranjang aktif seperti alur lainnya: jangan dihitung sebagai fitur lengkap jika masih ditampilkan sebagai segera hadir di halaman.

Menuju WooCommerce (ekspor)

• Produk — dengan arah sinkronisasi “menuju WooCommerce” atau “keduanya”, Mokapen dapat mengekspor/memperbarui produk di toko (sinkronisasi massal dan sinkronisasi pada penyimpanan produk, jika integrasi aktif).
• Kontak keluar dan pesanan — seperti halnya Shopify, ekspor "sinkronisasi" otomatis yang diterapkan saat ini juga berlaku pada praktiknya produk. Pelanggan datang sebagian besar dari WooCommerce hingga Mokapen (impor + webhook). Jangan berasumsi ekspor kontak dua arah penuh hanya karena teks komersial menyarankannya: verifikasi setelah tersambung.

Konfigurasi juga ditampilkan layanan, tetapi tidak ada sinkronisasi layanan khusus: gunakan Produk untuk katalog toko.

Pengaturan setelah terhubung

Di halaman WooCommerce, dengan toko terhubung:

Sinkronisasi arah

• Menuju Mokapen saja — WooCommerce → CRM.
• Keduanya — impor + ekspor (jika didukung; saat ini sebagian besar produk keluar).
• Hanya untuk WooCommerce — Mokapen → toko (produk).

Entitas

Kontak, pesanan, dan produk adalah cakupan sinkronisasi (seringkali dipilih sebelumnya dan tidak dapat diedit dari UI).

Bagikan sinkronisasi

Siapa pun yang terhubung dapat berbagi koneksi dengan seluruh organisasi atau pengguna terpilih.

Duplikat dan konflik

• Hindari duplikat — biasanya pengenalan kontak melalui email.
• Jika terjadi konflik — WooCommerce atau Mokapen menang.

Privasi (WooCommerce)

Berbeda dengan Shopify, di halaman WooCommerce Anda juga dapat menemukannya pribadi Dan kolaborator/pemangku kepentingan kontrol yang terkait dengan bagaimana data yang disinkronkan terlihat di organisasi. Tetapkan jika tim tidak melihat semua katalog/pelanggan yang diimpor dengan cara yang sama.

Sinkronisasi otomatis vs manual

Aktifkan sinkronisasi otomatis untuk pembaruan yang sedang berlangsung (bersama dengan webhook); gunakan sinkronisasi manual untuk memuat riwayat. Periksa datanya otorisasi di halaman sebelum menyinkronkan.

Aliran yang direkomendasikan

1. Verifikasi HTTPS dan WooCommerce terkini di situs.
2. Hubungkan toko dari Integrasi → WooCommerce dan selesaikan WC Auth.
3. Tetapkan arah sinkronisasi, duplikat, konflik, privasi (jika ada), dan berbagi.
4. Otorisasi dan luncurkan sinkronisasi pertama.
5. Cek Kontak, Produk (variasi/stok), Pesanan di Mokapen.
6. Jaga agar webhook tetap aktif untuk acara baru tanpa meluncurkan ulang semuanya setiap saat.

Memutuskan

Dari Integrasi → WooCommerce → putuskan sambungan. Di modal pilih apakah akan melakukannya menyimpan kontak, pesanan, dan produk sudah di import di Mokapen. Setelah sambungan terputus, webhook tidak lagi diperbarui; data yang sudah ada di CRM tetap ada jika Anda menyimpannya. Anda juga dapat mencabut kunci/otorisasi dari panel WordPress.

Masalah umum

• URL tidak valid/bukan HTTPS — gunakan alamat situs lengkap dengan https://.
• Otorisasi gagal — diperlukan admin WordPress; verifikasi bahwa permalink WooCommerce dan REST berfungsi (firewall/plugin keamanan dapat memblokir WC Auth atau webhook).
• Tombol diblokir / ditingkatkan — diperlukan paket Premium yang sesuai untuk e-niaga.
• Pesanan tidak ada di Peluang — itu benar: mereka masuk Pesanan (Penjualan → Pesanan).
• Stok / kuantitas — berasal dari variasi stok_kuantitas; bukan WMS lengkap.
• Webhook tidak tiba — situs harus dapat dijangkau dari internet; lingkungan lokal atau autentikasi dasar sering kali tidak menerima notifikasi WooCommerce.

Pertanyaan yang sering diajukan

T: Apakah saya perlu membuat kunci API secara manual di WooCommerce?

J: Tidak. Gunakan Otentikasi WC mengalir dari halaman Integrasi Mokapen: kunci dibuat dan disimpan ketika Anda kembali dari otorisasi.

T: Apakah pesanan WooCommerce menjadi peluang?

A: Tidak. Di Mokapen mereka jadinya pesanan penjualan. Teks apa pun yang mengacu pada “peluang” tidak akurat dibandingkan dengan perilaku saat ini.

Q: Bisakah saya mengupdate produk WooCommerce dari Mokapen?

A: Ya, dengan arah sinkronisasi yang mencakup ekspor dan integrasi aktif.

T: Perbedaan dari Shopify?

J: Model data yang sama (kontak, produk, pesanan) dan logika Premium e-commerce yang sama. Koneksinya berbeda: Shopify menggunakan OAuth di aplikasi Shopify; WooCommerce menggunakan WC Auth di URL situs WordPress Anda. Lihat juga Panduan Shopify.

T: Apakah HTTPS diperlukan?

J: Ya. Tanpa HTTPS, koneksi dan webhook tidak dapat diandalkan (dan validasi URL mungkin gagal).