Cara Menghubungkan Odoo ke BOTS4.me: Panduan Instalasi Konektor (Odoo 13–19)

🧭 Pertama, Pilih Jalur Anda: Di Mana Odoo Anda Berjalan?

Ada dua jalur pemasangan, dan satu-satunya yang menentukan di antara keduanya adalah jenis hosting Odoo Anda. Keduanya berakhir di tempat yang sama: satu koneksi melayani setiap aplikasi BOTS4.me yang bekerja dengan Odoo.

Belum yakin hosting apa yang Anda gunakan — atau masih memilih? Lihat Odoo Online vs Odoo.sh vs on-premise: mana yang bisa Anda otomatisasi?

Catatan paket: Odoo Online memerlukan paket Custom dari Odoo untuk akses API; Odoo.sh dan on-premise berfungsi di paket apa pun.

🔌 Jalur A: Odoo.sh & On-Premise — Konektor Satu Klik

• Langkah 1 — Buat akun BOTS4.me Anda. Daftar di bots4.me/bots, atau lewati langkah ini dan buat akun di dalam Odoo pada Langkah 3. Setiap aplikasi yang dapat dimulai gratis kemudian diawali dengan bulan Discovery gratis.
• Langkah 2 — Instal “BOTS4.me Connect”. Di apps.odoo.com, buka BOTS4.me Connect, pilih versi Odoo Anda (13.0 hingga 19.0) dan unduh file zip gratisnya; file ini berisi satu folder, b4m_connect. On-premise: letakkan folder tersebut di direktori pada addons path Anda, mulai ulang layanan Odoo, aktifkan mode pengembang, buka Apps → Update Apps List, cari “BOTS4.me Connect” dan klik Activate (Install pada versi lama). Odoo.sh: commit folder tersebut ke repositori Anda (coba branch staging terlebih dahulu) dan push; setelah build berwarna hijau, instal dari Apps di database build tersebut. Modul satu aplikasi di toko (misalnya “Mail2ERP by BOTS4.me”) dipasang dengan cara yang sama dan hanya menampilkan aplikasinya sendiri. Kode sumbernya berlisensi LGPL-3, sehingga Anda atau integrator Anda dapat membaca setiap barisnya sebelum memasang.
• Langkah 3 — Jalankan wizard koneksi. Sebagai administrator Odoo, buka BOTS4.me Connect → Pengaturan dan klik Koneksi. Pilih “Buat akun baru di www.bots4.me” (masukkan email Anda; jika partner BOTS4.me merekomendasikan kami, masukkan kodenya di Kode Mitra) atau “Saya sudah memiliki akun di www.bots4.me” (email dan kata sandi). Lalu masukkan kode 6 digit dari email Anda, atau dari aplikasi autentikator jika Anda menggunakannya. Wizard berkomunikasi langsung dengan bots4.me melalui HTTPS; tidak ada kredensial yang diketik di layar pihak ketiga mana pun.
• Langkah 4 — Kunci dibuat untuk Anda. Setelah berhasil masuk, BOTS4.me menerbitkan kunci API dan rahasia penandatanganan HMAC untuk database Odoo khusus ini, dan modul membuat pengguna teknis lokal, “BOTS4.me Connect”, sehingga bot membaca dan menulis rekaman Odoo melalui XML-RPC dengan identitasnya sendiri, tidak pernah dengan login admin pribadi Anda. Pengguna tersebut hanya mendapatkan hak Odoo dari aplikasi yang Anda aktifkan. Seperti pengguna internal lainnya, pengguna ini dihitung dalam langganan Odoo Enterprise per pengguna. Di Odoo 18 dan yang lebih baru, Odoo membatasi berapa lama kunci API tetap berlaku: ketika modul menampilkan “Kunci API segera kedaluwarsa”, klik Putuskan, lalu Koneksi, dan tidak ada pengaturan aplikasi yang hilang.
• Langkah 5 — Formulir penyiapan terisi otomatis. Konektor mengirim metadata Odoo Anda (URL, UUID database, blok penagihan perusahaan, alamat server email IMAP) untuk mengisi otomatis formulir penyiapan BOTS4.me. Kata sandi email tetap berada di dalam Odoo Anda sampai Anda menyerahkan sebuah kotak surat ke aplikasi, baik dengan + Email IMAP saya (1 klik) maupun dengan mengklik Mulai bulan Discovery gratis pada aplikasi yang membaca email. Kata sandi tersebut dienkripsi sebelum meninggalkan Odoo Anda.
• Langkah 6 — Aktifkan aplikasi pertama Anda. Di Aplikasi, setiap aplikasi menampilkan statusnya (Belum diaktifkan, Perlu penyiapan, Aktif, Dikonfigurasi). Klik Lengkapi penagihan terlebih dahulu satu kali, isi detail penagihan Anda di bots4.me, lalu klik Mulai bulan Discovery gratis pada aplikasi yang Anda inginkan. Satu klik itu mengaktifkan aplikasi, menghubungkan Odoo ini sebagai ERP-nya, dan, untuk aplikasi yang membaca email, menyerahkan kotak surat IMAP Odoo Anda. Apa pun yang masih kurang mendapatkan tombolnya sendiri pada aplikasi: + Odoo ini sebagai ERP (1 klik), + Email IMAP saya (1 klik), + Kotak surat (Gmail, Microsoft 365), atau + Penyimpanan cloud. Dashboard, Log, dan Pengaturan membuka bots4.me dalam keadaan sudah masuk.

☁️ Jalur B: Odoo Online — Penyiapan Tanpa Kode dengan Kunci API

Odoo Online (edisi SaaS di odoo.com) tidak mengizinkan modul Python khusus — itu adalah aturan platform, bukan keterbatasan BOTS4.me. Jadi jalur Online menggunakan modul helper XML tanpa kode plus kunci API Odoo standar yang Anda buat sendiri (akses API eksternal merupakan bagian dari paket Custom Odoo):

• Langkah 1 — Buat akun BOTS4.me Anda di bots4.me/bots.
• Langkah 2 — Buat kunci API Odoo. Di database Odoo Online Anda, buka Settings → Users & Companies → Users → pengguna Anda → Account Security (aktifkan mode pengembang jika tab tersebut tersembunyi) dan klik New API Key. Beri nama “BOTS4.me”, pilih berapa lama kunci tetap berlaku (Odoo 18 dan yang lebih baru menanyakannya) dan salin kuncinya; Odoo hanya menampilkannya sekali. Sebelum kedaluwarsa, buat kunci baru dan tempelkan ke koneksi Odoo yang sama di bots4.me (Edit → Perbarui Akun ERP).
• Langkah 3 — Mulai aplikasi dan tempelkan kunci di bots4.me. Masuk di bots4.me/bots, klik Mulai bulan Discovery gratis pada kartu aplikasi dan setujui Ketentuan satu kali — tanpa kartu kredit. Lalu buka Pengaturan (ikon roda gigi) → aplikasi tersebut → Access Manager, klik Tambah Tujuan atau Tambah Sumber (aplikasi menampilkan yang diperlukannya), pilih ERP → Odoo dan isi URL Odoo (untuk https://yourcompany.odoo.com, Database Name terisi otomatis), email login Anda sebagai Nama Pengguna, dan kunci API di Kata Sandi atau API Key. Klik Tambah Akun ERP.
• Langkah 4 — Tambahkan helper tanpa kode (opsional). Modul “BOTS4.me for Odoo Online” di apps.odoo.com hanya berisi rekaman data, tanpa Python, sehingga Odoo Online menerimanya. Modul ini menambahkan aplikasi BOTS4.me ke Odoo Anda dengan Koneksi / Dashboard, Panduan Penyiapan, dan Cara Membuat Kunci API. Bot tetap terhubung melalui API eksternal standar Odoo dengan cara mana pun.
• Langkah 5 — Verifikasi dalam DEMO. Di tab Kontrol aplikasi, aktifkan Daya Bot dan biarkan Mode pada DEMO. Setelah proses pertama, Anda menerima email laporan DEMO yang mencantumkan apa yang dibaca bot dan apa yang akan ditulisnya, dan tab Log menampilkan setiap keputusan; tidak ada yang berubah di Odoo. Setelah laporan DEMO terlihat benar, atur Mode ke LIVE di tab Kontrol — opsi ini terbuka setelah email laporan DEMO pertama.

🧭 Coba di Bulan Discovery Gratis Anda

Bulan pertama setiap aplikasi yang dapat dimulai gratis adalah bulan Discovery gratis: kuota penggunaan paket Personal dengan banyak fitur Family dan Business terbuka untuk dicoba, tanpa kartu kredit. Berikut rute terpendek dari “terhubung” hingga hasil pertama di Odoo.

• 1 — Mulai aplikasi. Di Odoo (Odoo.sh, on-premise): BOTS4.me Connect → Pengaturan, klik Lengkapi penagihan terlebih dahulu satu kali, lalu Mulai bulan Discovery gratis pada aplikasi. Di Odoo Online: masuk di bots4.me/bots, klik Mulai bulan Discovery gratis pada kartu aplikasi dan setujui Ketentuan satu kali — tanpa kartu kredit. Dengan cara mana pun, dasbor kemudian menampilkan “Bulan Discovery gratis — tersisa N hari”.
• 2 — Hubungkan apa yang dibutuhkan aplikasi. Di Odoo, memulai aplikasi sudah menghubungkan Odoo ini dan, jika Odoo Anda memiliki server email IMAP, kotak suratnya. Gunakan + Odoo ini sebagai ERP (1 klik) atau + Kotak surat (Gmail, Microsoft 365) untuk apa pun yang masih kurang. Di Odoo Online, tambahkan koneksi Odoo di Access Manager seperti dijelaskan di Jalur B, dan kotak surat dengan Tambah Sumber.
• 3 — Jalankan dalam DEMO. Buka tab Kontrol aplikasi (atau Kontrol cepat di Odoo), aktifkan Daya Bot dan biarkan Mode pada DEMO. Sakelar dengan tag Discovery di tab Kontrol sudah termasuk dalam bulan gratis Anda dan dimulai dalam keadaan nonaktif — aktifkan yang ingin Anda coba.
• 4 — Periksa hasilnya. Baca email laporan DEMO setelah proses pertama dan tab Log: setiap dokumen yang dibaca bot, dan apa yang akan dibuat atau diubahnya di Odoo.
• 5 — Beralih ke LIVE. Setelah laporan DEMO terlihat benar, atur Mode ke LIVE di tab Kontrol — opsi ini terbuka setelah email laporan DEMO pertama. Bot kini menulis ke Odoo melalui koneksi yang Anda siapkan, dengan hak pengguna Odoo-nya.
• 6 — Setelah bulan tersebut. Saat bulan tersebut berakhir, aplikasi berlanjut dengan sendirinya pada paket gratis dengan kuota bulanan kecil: saat kuota habis, item baru menunggu hingga bulan berikutnya atau hingga Anda memilih paket, dan item yang sudah dimulai selalu diselesaikan. Pilih paket untuk mempertahankan semua fitur — lihat tabel paket di halaman produk aplikasi.

🔒 Model Keamanan, Dijelaskan Secara Jujur

Anda memberikan akses ke ERP Anda kepada layanan eksternal, jadi Anda perlu menuntut hal yang spesifik — bukan sekadar lencana “keamanan setara bank”. Berikut persis cara BOTS4.me Connect dibangun:

• Hanya HTTPS, dikodekan secara tetap. Endpoint API terpatri ke https://bots4.me di kode sumber modul — bukan field pengaturan yang bisa diedit, sehingga rekaman konfigurasi yang disusupi tidak bisa mengarahkan lalu lintas API Anda ke server jahat. Setiap URL yang dikembalikan API diverifikasi sebelum browser Anda membukanya; respons non-HTTPS atau di luar host ditolak.
• Penandatanganan permintaan HMAC-SHA256. Setiap panggilan yang dibuat modul ke BOTS4.me ditandatangani dengan secret khusus per database, sehingga permintaan tidak bisa dipalsukan atau diubah dalam perjalanan.
• Kredensial dibatasi hanya untuk admin. Field kunci API, signing secret, dan pengguna teknis memiliki akses tingkat field yang dibatasi hanya untuk grup admin Odoo (base.group_system). Pengguna internal biasa dapat melihat launchpad dan status aplikasi, tetapi secret tersebut tidak pernah muncul di pembacaan rekaman apa pun yang bisa mereka jalankan — dan semua tindakan connect/disconnect/configure hanya untuk admin.
• Open source, LGPL-3. Kode sumber lengkap disertakan di dalam file zip yang Anda unduh dari apps.odoo.com, sehingga integrator Anda dapat mengaudit persis apa yang keluar dari server Anda: metadata untuk mengisi formulir secara otomatis, kata sandi kotak surat hanya ketika Anda menyerahkan kotak surat tersebut ke aplikasi (dienkripsi sebelum keluar), dan tidak pernah dokumen bisnis Anda.
• Jejak audit di kedua sisi. Modul ini menyimpan log peristiwa lokal berupa koneksi, perubahan konfigurasi, dan kesalahan di dalam Odoo; dasbor BOTS4.me menyimpan log keputusan lengkap per penjalanan.
• Pembaruan hak akses otomatis. Cron terjadwal memeriksa ulang langganan Anda secara berkala, sehingga status aplikasi di launchpad tetap terkini — dan aplikasi yang dibatalkan segera berhenti dilayani.

Selengkapnya tentang keamanan platform dan akses bertingkat: bots4.me/security dan level akses. Platform ini di-hosting di UE, dirancang untuk GDPR, dan 2FA tersedia pada setiap akun.

✅ Setelah Terhubung: Satu Koneksi untuk Setiap Aplikasi Odoo

Anda memasang konektor tepat satu kali; tidak ada tambahan yang perlu dipasang per aplikasi. Satu koneksi melayani setiap aplikasi BOTS4.me yang bekerja dengan Odoo: Mail2ERP, AutoERP, Pay2ERP, Supplier2ERP, dan AutoCASH, ditambah AutoSTOCK, AutoPURCHASE, dan ClientFACTORY. AutoSPAM, Mail2CLOUD, dan Mail2KNOW hanya memerlukan kotak surat, yang dapat diserahkan konektor dari Odoo Anda dengan satu klik. Anda memulai setiap aplikasi secara terpisah, dari barisnya di Odoo atau kartunya di bots4.me/bots.

Setiap aplikasi dimulai dalam DEMO: aplikasi membaca, memutuskan, dan mengirimi Anda email laporan DEMO, tetapi tidak menulis apa pun. Setelah laporan DEMO terlihat benar, atur Mode ke LIVE di tab Kontrol — opsi ini terbuka setelah email laporan DEMO pertama. Di bots4.me, tab Kontrol setiap aplikasi berisi Daya Bot, Mode, Mode AI (Nonaktif, AI Esensial, AI Premium, atau Ultra, tergantung aplikasinya), Jadwal Berjalan dan Jam Operasional jika aplikasi memilikinya, serta sakelar fiturnya. Tab Log menampilkan setiap keputusan. Di Odoo, Kontrol cepat pada baris aplikasi mencakup Daya Bot, Jadwal Berjalan, Mode Demo, dan Mode AI. Untuk mengetahui apa yang sebaiknya diotomatiskan terlebih dahulu, lihat panduan utama: Cara mengotomatiskan Odoo secara menyeluruh.

📚 Panduan Terkait

• Mulai di sini: Cara mengotomatisasi Odoo end-to-end: dari pesanan email hingga faktur terbayar
• Hosting: Odoo Online vs Odoo.sh vs on-premise: mana yang bisa Anda otomatisasi?
• Bot pertama untuk dihubungkan: Impor pesanan email ke Odoo · Cocokkan pembayaran bank dengan faktur secara otomatis
• Untuk integrator: Hasilkan pendapatan berulang sebagai mitra Odoo

🔗 Sumber dan Bacaan Lanjutan

Dokumentasi resmi dan standar yang dirujuk dalam panduan ini. Tautan eksternal terbuka di tab baru.

• Odoo 18 developer reference — External API and API keys
• BOTS4.me Connect on the Odoo Apps Store
• Odoo 18 documentation — Access rights
• Odoo — Supported versions