API Mailjet

Odoo kompatibel dengan API Mailjet untuk mass mailing. Atur server mass mailing khusus melalui Mailjet dengan mengonfigurasi pengaturan di akun Mailjet dan database Odoo. Dalam beberapa keadaan, pengaturan juga perlu dikonfigurasi pada pengaturan DNS domain kustom.

Pengaturan di Mailjet

Buat kredensial API

Untuk memulai, masuk ke halaman Informasi Akun Mailjet. Selanjutnya, navigasi ke bagian Senders & Domains dan klik SMTP and SEND API Settings.

Tautan SMTP and Send API Settings di bagian Senders & Domains di Mailjet.

Kemudian, salin pengaturan konfigurasi SMTP ke notepad. Pengaturan tersebut dapat ditemukan di bawah bagian Configuration (SMTP only). Pengaturan konfigurasi SMTP mencakup alamat server, opsi keamanan yang diperlukan (Gunakan SSL/TLS), dan nomor port. Pengaturan ini diperlukan untuk mengonfigurasi Mailjet di Odoo, yang dibahas di bagian terakhir.

Penting

Odoo memblokir port 25 pada database Odoo Online dan Odoo.sh.

Konfigurasi SMTP dari Mailjet.

Selanjutnya, klik tombol berlabel Retrieve your API credentials untuk mengambil kredensial API Mailjet.

Kemudian, klik ikon mata untuk menampilkan API key. Salin kunci ini ke notepad, karena ini berfungsi sebagai Username dalam konfigurasi Odoo. Selanjutnya, klik tombol Generate Secret Key untuk menghasilkan Secret Key. Salin kunci ini ke notepad, karena ini berfungsi sebagai Password dalam konfigurasi Odoo.

Tambahkan alamat pengirim terverifikasi

Langkah selanjutnya adalah menambahkan alamat pengirim atau domain ke pengaturan akun Mailjet agar alamat email atau domain tersebut disetujui untuk mengirim email menggunakan server Mailjet. Pertama, navigasi ke halaman Mailjet Account Information. Selanjutnya, klik tautan Add a Sender Domain or Address di bawah bagian Senders & Domains.

Tambahkan domain atau alamat pengirim di antarmuka Mailjet.

Tentukan apakah alamat email pengirim atau keseluruhan domain perlu ditambahkan ke pengaturan Mailjet. Mungkin lebih mudah untuk mengonfigurasi domain secara keseluruhan jika akses DNS tersedia. Lanjutkan ke bagian Tambahkan domain untuk langkah-langkah menambahkan domain.

Catatan

Semua alamat email pengguna database Odoo yang mengirim email menggunakan server Mailjet perlu dikonfigurasi atau domain dari alamat email pengguna dapat dikonfigurasi.

Secara default, alamat email yang awalnya diatur dalam akun Mailjet ditambahkan sebagai pengirim tepercaya. Untuk menambahkan alamat email lain, klik tombol berlabel Add a sender address. Kemudian, tambahkan alamat email yang dikonfigurasi untuk mengirim dari domain kustom.

Minimal alamat email berikut harus diatur di penyedia dan diverifikasi di Mailjet:

  • notifications@yourdomain.com

  • bounce@yourdomain.com

  • catchall@yourdomain.com

Catatan

Ganti yourdomain dengan domain kustom untuk database Odoo. Jika tidak ada, maka gunakan parameter sistem mail.catchall.domain.

Setelah itu, isi formulir Email Information, pastikan untuk memilih jenis email yang sesuai: email transaksional atau email massal. Setelah menyelesaikan formulir, email aktivasi dikirim ke alamat email dan pengirim tepercaya dapat diaktifkan.

Peringatan

Untuk mencegah email ditandai sebagai spam, atur domain khusus. Menggunakan subdomain yang disediakan Odoo (dbname.odoo.com) dengan server Mailjet dapat menyebabkan masalah pengiriman email, karena protokol autentikasi email (SPF, DKIM, dan DMARC) tidak dapat dikonfigurasi pada subdomain tersebut.

Tambahkan domain

Dengan menambahkan seluruh domain ke akun Mailjet, semua alamat pengirim yang terkait dengan domain tersebut secara otomatis divalidasi untuk mengirim email menggunakan server Mailjet. Pertama, navigasi ke halaman Mailjet Account Information. Selanjutnya, klik tautan Add a Sender Domain or Address di bawah bagian Senders & Domains. Kemudian, klik Add domain untuk menambahkan domain kustom.

Catatan

Domain perlu ditambahkan ke akun Mailjet dan kemudian divalidasi melalui DNS.

Setelah itu, isi halaman Add a new Domain di Mailjet dan klik Continue.

Setelah menambahkan domain, halaman validasi akan muncul. Kecuali database Odoo berada di on-premise (dalam hal ini, pilih Option 1), pilih Option 2: Create a DNS Record. Salin informasi TXT record ke notepad dan kemudian navigasi ke penyedia DNS domain untuk menyelesaikan validasi.

Informasi TXT record yang dimasukkan pada DNS domain.

Pengaturan di DNS domain

Setelah mendapatkan informasi TXT record dari akun Mailjet, tambahkan TXT record ke DNS domain. Proses ini bervariasi tergantung pada penyedia DNS. Konsultasikan dengan penyedia untuk proses konfigurasi spesifik. Informasi TXT record terdiri dari Host dan Value. Tempelkan ini ke bidang yang sesuai di TXT record.

Kembali ke informasi akun Mailjet

Setelah menambahkan TXT record ke DNS domain, navigasi kembali ke akun Mailjet. Kemudian, navigasi ke Account Information ‣ Add a Sender Domain or Address, klik ikon roda gigi di sebelah Domain, dan pilih Validate.

Tindakan ini juga dapat dilakukan dengan membuka halaman Sender domains & addresses pada informasi akun Mailjet dan klik Manage.

Selanjutnya, klik Check Now untuk memvalidasi TXT record yang telah ditambahkan pada domain. Layar sukses akan muncul jika domain dikonfigurasi dengan benar.

Periksa DNS record di Mailjet.

Setelah berhasil mengatur domain, ada opsi untuk Authenticate this domain (SPF/DKIM). Tombol ini memunculkan SPF & DKIM provider.

Autentikasi domain dengan SPF/DKIM record di Mailjet.

Pengaturan di Odoo

Untuk menyelesaikan pengaturan, navigasi ke database Odoo dan buka Settings. Dengan Mode pengembang (mode debug) diaktifkan, buka Technical Menu ‣ Email ‣ Outgoing Mail Servers. Kemudian, buat konfigurasi outgoing server baru dengan mengklik tombol Create.

Selanjutnya, masukkan SMTP server (in-v3.mailjet.com), port number (587 atau 465), dan Security (SSL/TLS) yang disalin sebelumnya dari akun Mailjet. Mereka juga dapat ditemukan di sini. Disarankan untuk menggunakan SSL/TLS meskipun Mailjet mungkin tidak memerlukannya.

Untuk Username, masukkan API KEY. Untuk Password, masukkan SECRET KEY yang disalin dari akun Mailjet ke notepad sebelumnya. Pengaturan ini dapat ditemukan di Mailjet ‣ Account Settings ‣ SMTP and SEND API Settings.

Kemudian, jika server Mailjet digunakan untuk mass emailing, atur nilai Priority lebih tinggi dari server email transaksional. Terakhir, simpan pengaturan dan Test the Connection.

Pengaturan outgoing email server Odoo.