API Mailjet¶
Odoo is compatible with Mailjet's API for mass mailing. Set up a dedicated mass mailing server through Mailjet by configuring settings in the Mailjet account and the Odoo database. In some circumstances, settings need to be configured on the custom domain's DNS settings as well.
Set up in Mailjet¶
Create API credentials¶
To get started, sign in to the Mailjet Account Information page. Next, navigate to the Senders & Domains section and click on SMTP and SEND API Settings.
Sau đó, sao chép cài đặt cấu hình SMTP vào một tệp ghi chú. Các cài đặt này có thể được tìm thấy trong phần Cấu hình (chỉ SMTP). Cài đặt cấu hình SMTP bao gồm địa chỉ máy chủ, tùy chọn bảo mật cần thiết (Sử dụng SSL/TLS), và số cổng. Những cài đặt này cần thiết để cấu hình Mailjet trong Odoo, sẽ được đề cập ở phần cuối.
Quan trọng
Odoo blocks port 25 on Odoo Online and Odoo.sh databases.
Next, click on the button labeled Retrieve your API credentials to retrieve the Mailjet API credentials.
Sau đó, nhấp vào biểu tượng con mắt để hiển thị Khóa API. Sao chép khóa này vào một trình soạn thảo, vì đây sẽ được sử dụng làm Tên người dùng trong cấu hình Odoo. Tiếp theo, nhấp vào nút Tạo khóa bí mật để tạo Khóa bí mật. Sao chép khóa này vào trình soạn thảo, vì nó sẽ được sử dụng làm Mật khẩu trong cấu hình Odoo.
Add verified sender address(es)¶
Bước tiếp theo là thêm địa chỉ người gửi hoặc tên miền vào phần cài đặt tài khoản Mailjet để địa chỉ email hoặc tên miền đó được phê duyệt gửi email thông qua máy chủ của Mailjet. Đầu tiên, truy cập trang Thông tin tài khoản Mailjet <https://app.mailjet.com/account>. Sau đó, nhấp vào liên kết Thêm miền hoặc địa chỉ người gửi trong phần Người gửi & miền.
Determine if a sender's email address or the entire domain needs to be added to the Mailjet settings. It may be easier to configure the domain as a whole if DNS access is available. Jump to the Add a domain section for steps on adding the domain.
Ghi chú
Either all email addresses of the Odoo database users who are sending emails using Mailjet's servers need to be configured or the domain(s) of the users' email addresses can be configured.
By default, the email address originally set up in the Mailjet account is added as a trusted sender. To add another email address, click on the button labeled Add a sender address. Then, add the email address that is configured to send from the custom domain.
At minimum the following email addresses should be set up in the provider and verified in Mailjet:
notifications@yourdomain.com
bounce@yourdomain.com
catchall@yourdomain.com
Ghi chú
Replace yourdomain with the custom domain for the Odoo database. If there isn't one, then use
the mail.catchall.domain system parameter.
After that, fill out the Email Information form, making sure to select the appropriate email type: transactional email or mass emails. After completing the form, an activation email is sent to the email address and the trusted sender can be activated.
It is recommended to set up the SPF/DKIM/DMARC settings on the domain of the sender.
Quan trọng
If the database is not using a custom domain, then in order to verify the sender's address, a temporary alias (of the three email addresses mentioned above) should be set up in Odoo CRM to create a lead. Then, the database is able to receive the verification email and verify the accounts.
Add a domain¶
Bằng cách thêm toàn bộ miền vào tài khoản Mailjet, tất cả địa chỉ người gửi liên quan đến miền đó sẽ tự động được xác thực để gửi email bằng máy chủ Mailjet. Đầu tiên, đi đến trang Thông tin tài khoản Mailjet. Tiếp theo, nhấp vào liên kết Thêm miền hoặc địa chỉ người gửi trong phần Người gửi & miền. Sau đó, nhấp vào Thêm miền để thêm miền tùy chỉnh.
Ghi chú
The domain needs to be added to the Mailjet account and then validated through the DNS.
After that, fill out the Add a new Domain page on Mailjet and click Continue.
After adding the domain, a validation page will populate. Unless the Odoo database is on-premise (in which case, choose Option 1), choose Option 2: Create a DNS Record. Copy the TXT record information to a notepad and then navigate to the domain's DNS provider to complete validation.
Setup in the domain's DNS¶
Sau khi nhận được thông tin bản ghi TXT từ tài khoản Mailjet, hãy thêm bản ghi TXT vào DNS của miền. Quy trình này khác nhau tùy vào nhà cung cấp DNS. Vui lòng tham khảo nhà cung cấp để biết quy trình cấu hình cụ thể. Thông tin bản ghi TXT bao gồm Lưu trữ và Giá trị. Dán các thông tin này vào các trường tương ứng trong bản ghi TXT.
Return to Mailjet account information¶
After adding the TXT record to the domain's DNS, navigate back to the Mailjet account. Then, navigate to , click the gear icon next to Domain, and select Validate.
This action can also be done by going to the Sender domains & addresses page on the Mailjet account information and clicking on Manage.
Next, click Check Now to validate the TXT record that was added on the domain. A success screen will appear if the domain is configured correctly.
After successfully setting up the domain, there is an option to Authenticate this domain (SPF/DKIM). This button populates SPF & DKIM provider.
Set up in Odoo¶
To complete the setup, navigate to the Odoo database and go to the Settings. With Chế độ lập trình viên (chế độ gỡ lỗi) turned on, go to the . Then, create a new outgoing server configuration by clicking on the Create button.
Next, input the SMTP server (in-v3.mailjet.com), port number (587 or 465), and Security
(SSL/TLS) that was copied earlier from the Mailjet account. They can also be found here. It is recommended to use SSL/TLS even though Mailjet may not require it.
For the Username, input the API KEY. For the Password, input the SECRET KEY that was copied from the Mailjet account to the notepad earlier. These settings can be found on .
Then, if the Mailjet server is used for mass emailing, set the Priority value higher than that of any transactional email server(s). Finally, save the settings and Test the Connection.
