Menghubungkan Gmail ke Odoo menggunakan Google OAuth

Odoo kompatibel dengan OAuth Google untuk Gmail. Untuk mengirim email aman dari domain khusus, yang diperlukan hanyalah mengonfigurasi beberapa pengaturan di platform Workspace Google, serta di backend database Odoo. Konfigurasi ini bekerja dengan menggunakan alamat email pribadi atau alamat yang dibuat oleh domain khusus.

Tip

Untuk informasi lebih lanjut, kunjungi dokumentasi Google tentang pengaturan OAuth.

Lihat juga

• Autentikasi Google Sign-In

• Sinkronisasi Kalender Google

Pengaturan di Google

Membuat project baru

Untuk memulai, buka Google API Console. Login dengan akun Google Workspace Anda jika ada, jika tidak login dengan akun Gmail pribadi Anda (ini harus cocok dengan alamat email yang ingin Anda konfigurasikan di Odoo).

Setelah itu, klik Create Project, yang terletak di sisi kanan OAuth consent screen. Jika project sudah dibuat di akun ini, maka opsi New Project akan berada di kanan atas di bawah menu drop-down Select a project.

Pada layar New Project, ubah nama Project name menjadi Odoo dan telusuri Location. Atur Location sebagai organisasi Google Workspace. Jika Anda menggunakan akun Gmail pribadi, biarkan Location sebagai No Organization.

Klik Create untuk menyelesaikan langkah ini.

Layar persetujuan OAuth

Jika halaman tidak mengarahkan ke opsi User Type, klik OAuth consent screen di menu sebelah kiri.

Di bawah opsi User Type, pilih User Type yang sesuai, lalu klik Create lagi, yang akhirnya akan mengarahkan ke halaman Edit app registration.

Peringatan

Akun Gmail Pribadi hanya diizinkan untuk jenis User External, yang berarti Google mungkin memerlukan persetujuan, atau Scopes untuk ditambahkan. Namun, menggunakan akun Google WorkSpace memungkinkan jenis User Internal untuk digunakan.

Perhatikan juga bahwa selama koneksi API dalam mode pengujian External, tidak diperlukan persetujuan dari Google. Batas pengguna dalam mode pengujian ini ditetapkan sebanyak 100 pengguna.

Edit pendaftaran aplikasi

Selanjutnya kita akan mengonfigurasi pendaftaran aplikasi dari project.

Pada langkah OAuth consent screen, di bawah bagian App information, masukkan Odoo di kolom App name. Pilih alamat email organisasi di bawah kolom email User support.

Selanjutnya, di bawah App Domain ‣ Authorized domains, klik Add Domain dan masukkan odoo.com.

Setelah itu, di bawah bagian Developer contact information, masukkan alamat email organisasi. Google menggunakan alamat email ini untuk memberi tahu organisasi tentang perubahan apa pun pada project Anda.

Selanjutnya, klik tombol Save and Continue. Kemudian, lewati halaman Scopes dengan menggulir ke bawah dan mengklik Save and Continue.

Jika melanjutkan dalam mode pengujian (External), tambahkan alamat email yang sedang dikonfigurasi di bawah langkah Test users, dengan mengklik Add Users, lalu tombol Save and Continue. Ringkasan pendaftaran aplikasi akan muncul.

Terakhir, gulir ke bawah dan klik Back to Dashboard untuk menyelesaikan pengaturan project.

Buat Kredensial

Sekarang project sudah disiapkan, kredensial harus dibuat, yang mencakup Client ID dan Client Secret. Pertama, klik Credentials di menu sidebar sebelah kiri.

Kemudian, klik Create Credentials di menu atas dan pilih OAuth client ID dari menu dropdown.

• Di bawah Application Type, pilih Web Application dari menu dropdown.

• Di kolom Name, masukkan Odoo.

• Di bawah label Authorized redirect URIs, klik tombol ADD URI, lalu masukkan https://yourdbname.odoo.com/google_gmail/confirm di kolom URIs 1. Pastikan untuk mengganti bagian yourdbname pada URL dengan nama database Odoo yang sebenarnya.

• Selanjutnya, klik Create untuk menghasilkan OAuth Client ID dan Client Secret. Terakhir, salin setiap nilai yang dihasilkan untuk digunakan nanti saat konfigurasi di Odoo, lalu navigasi ke database Odoo.

Pengaturan di Odoo

Masukkan kredensial Google

Pertama, buka Odoo dan navigasi ke modul Apps. Kemudian, hapus filter Apps dari bilah pencarian dan ketik Google. Instal modul yang disebut Google Gmail.

Selanjutnya, navigasi ke Settings ‣ General Settings, dan di bawah bagian Discuss, pastikan kotak centang untuk Custom Email Servers atau External Email Servers dicentang. Ini akan memunculkan opsi baru untuk Gmail Credentials atau Use a Gmail Sever. Kemudian, salin dan tempel nilai masing-masing ke kolom Client ID dan Client Secret lalu Save pengaturannya.

Konfigurasi server email keluar

Untuk mengonfigurasi akun Gmail eksternal, kembali ke bagian atas pengaturan Custom Email Servers lalu klik tautan Outgoing Email Servers.

Kemudian, klik New atau Create untuk membuat server email baru, dan isi Name, Description, dan email Username (jika diperlukan).

Selanjutnya, klik Gmail OAuth Authentication atau Gmail (di bawah bagian Authenticate with atau Connection). Terakhir, klik Connect your Gmail Account.

Jendela baru berlabel Google terbuka untuk menyelesaikan proses otorisasi. Pilih alamat email yang sesuai yang sedang dikonfigurasi di Odoo.

Jika alamat email adalah akun pribadi, maka langkah tambahan akan muncul, jadi klik Continue untuk mengizinkan verifikasi dan menghubungkan akun Gmail ke Odoo.

Kemudian, izinkan Odoo untuk mengakses akun Google dengan mengklik Continue atau Allow. Setelah itu, halaman akan menavigasi kembali ke server email keluar yang baru dikonfigurasi di Odoo. Konfigurasi secara otomatis memuat token di Odoo, dan tag yang menyatakan Gmail Token Valid muncul berwarna hijau.

Terakhir, Test the Connection. Pesan konfirmasi akan muncul. Database Odoo sekarang dapat mengirim email yang aman melalui Google menggunakan autentikasi OAuth.

FAQ Google OAuth

Status publikasi produksi vs pengujian

Memilih Production sebagai Publishing Status (bukan Testing) akan menampilkan pesan peringatan berikut:

Untuk memperbaiki peringatan ini, navigasi ke Google API Platform. Jika Publishing status adalah In Production, klik Back to Testing untuk memperbaiki masalah.

Tidak Ada User Pengujian yang Ditambahkan

Jika tidak ada user pengujian yang ditambahkan ke layar persetujuan OAuth, maka error 403 access denied akan muncul.

Untuk memperbaiki error ini, kembali ke layar persetujuan OAuth di bawah APIs & Services dan tambahkan user pengujian ke aplikasi. Tambahkan email yang Anda konfigurasi di Odoo.

Modul Gmail Tidak Diperbarui

Jika modul Google Gmail di Odoo belum diperbarui ke versi terbaru, maka pesan error Forbidden akan muncul.

Untuk memperbaiki error ini, buka modul Apps dan hapus istilah pencarian. Kemudian, cari Gmail atau Google dan upgrade modul Google Gmail. Terakhir, klik tiga titik di kanan atas modul dan pilih Upgrade.

Jenis Aplikasi

Saat membuat kredensial (OAuth Client ID dan Client Secret), jika Desktop App dipilih untuk Application Type, Authorization Error akan muncul.

Untuk memperbaiki error ini, hapus kredensial yang sudah dibuat dan buat kredensial baru, pilih Web Application untuk Application Type. Kemudian, di bawah Authorized redirect URIs, klik ADD URI dan ketik: https://yourdbname.odoo.com/google_gmail/confirm di kolom tersebut, pastikan untuk mengganti yourdbname di URL dengan nama database Odoo.