Panduan Integrasi Magento
Tajo terhubung ke Adobe Commerce (Magento 2) melalui Commerce REST API. Tidak ada ekstensi Tajo yang perlu dipasang di basis kode Magento Anda: koneksinya memakai token integrasi, sehingga pipeline deploy toko Anda tetap utuh.
Magento saat ini merupakan koneksi yang dibangun saat onboarding: berbeda dengan Shopify dan WooCommerce, integrasi ini belum swalayan, dan tim Tajo Anda yang merangkai sinkronisasinya sebagai bagian dari onboarding. Status implementasi konektor memantau posisinya saat ini. Persiapan di sisi toko berikut adalah semua yang dibutuhkan Magento dari Anda, dan langkah ini berjalan pada Magento standar, tanpa perubahan kode.
Prasyarat
- Adobe Commerce / Magento Open Source 2.4+
- Akses admin untuk membuat token integrasi
- HTTPS pada toko Anda (wajib untuk autentikasi token)
- Akun Tajo dengan langganan aktif
Langkah 1: Buat token integrasi Magento
- Di admin Magento, buka System → Extensions → Integrations → Add New Integration.
- Beri nama
Tajo, masukkan kata sandi admin Anda, lalu pada tab API berikan akses baca ke sumber daya Customers, Sales, dan Catalog. - Simpan, lalu Activate integrasinya dan salin Access Token.
Tajo melakukan autentikasi dengan Authorization: Bearer <access token> ke URL dasar REST toko Anda (https://yourstore.com/rest/V1/).
Langkah 2: Serahkan koneksi ke tim Tajo Anda
Bagikan kepada kontak onboarding Tajo Anda:
| Bidang | Nilai |
|---|---|
| URL toko | https://yourstore.com |
| Access token | Token integrasi dari Langkah 1 |
Koneksi divalidasi dengan permintaan baca-saja sebelum sinkronisasi apa pun dimulai. Rotasikan token di Magento kapan saja untuk mencabut akses.
Apa yang disinkronkan koneksi Magento
- Pelanggan: bidang identitas dan metadata akun untuk resolusi kontak; persetujuan pemasaran tidak pernah disimpulkan dari keberadaan sebuah akun
- Pesanan: riwayat pembelian, total, mata uang, status, dan item baris untuk segmentasi siklus hidup dan otomatisasi win-back
- Produk dan kategori: struktur katalog untuk segmentasi minat dan kampanye yang sadar produk
Impor historis berjalan lebih dulu, lalu sinkronisasi inkremental menjaga Tajo tetap mutakhir dengan menarik record yang berubah. Event storefront real-time (keranjang, checkout yang sedang berlangsung) memerlukan ekstensi di dalam toko, yang hari ini belum tersedia untuk Magento, sedangkan otomatisasi berbasis pesanan tetap didukung penuh lewat sinkronisasi.
Otomatisasi pemasaran
Otomatisasi (email, SMS, WhatsApp melalui Brevo dan penyedia lain) dikonfigurasi di Tajo menggunakan data yang tersinkronkan, misalnya tindak lanjut pascapembelian pada pesanan baru, win-back untuk pelanggan yang tidak aktif, dan kampanye minat produk dari riwayat kategori.
Pemecahan masalah
| Gejala | Penyebab dan solusi |
|---|---|
| 401 dari toko | Token integrasi dibuat ulang atau integrasinya dinonaktifkan, aktifkan kembali lalu perbarui token di Tajo |
| Pelanggan tersinkron tetapi pesanan tidak | Izin API pada integrasi belum mencakup sumber daya Sales |
| Impor awal lambat | Toko besar diimpor per halaman; kontak Tajo Anda dapat melaporkan progresnya kapan saja |
Langkah berikutnya
- Referensi konektor Magento: status implementasi dan catatan teknis
- Sinkronisasi pelanggan: memetakan pelanggan Magento ke sistem pencatatan utama Anda