Mailjet API¶
Odoo 與 Mailjet 的 API(應用程式介面) 相容,可用於大量郵寄。透過在 Mailjet 帳戶和 Odoo 資料庫中設定設定,透過 Mailjet 設定專用的大量郵寄伺服器。在某些情況下,也需要在自訂網域的 DNS(網域名稱系統) 設定中進行設定。
在 Mailjet 中設定¶
建立 API 憑證¶
首先,請登入 Mailjet 帳戶資訊 頁面。接著,前往 寄件者與網域 區段,並按一下 SMTP 與 SEND API 設定。
然後,將 SMTP 配置設定複製到記事本。這些設定位於 配置 (僅限 SMTP) 區段下。SMTP 配置設定包括伺服器位址、所需的安全選項(使用 SSL/TLS)及連接埠號碼。這些設定在 Odoo 中配置 Mailjet 時需要用到,相關說明請參閱 最後一節。
重要
Odoo 封鎖連接埠 25 於 Odoo 雲端版與 Odoo.sh 資料庫。
接著,按一下標示為 取得您的 API 憑證 的按鈕以取得 Mailjet API 憑證。
然後,按一下眼睛圖示以顯示 API 金鑰。將此金鑰複製到記事本,因為這將作為 Odoo 配置中的 使用者名稱。接著,按一下 產生密鑰 按鈕以產生 密鑰。將此金鑰複製到記事本,因為這將作為 Odoo 配置中的 密碼。
加入已驗證的寄件者位址¶
下一步是在 Mailjet 帳戶設定中加入寄件者位址或網域,以便核准該電子郵件位址或網域使用 Mailjet 的伺服器傳送電子郵件。首先,前往 Mailjet 帳戶資訊 頁面。接著,在 寄件者與網域 區段下按一下 加入寄件者網域或位址 連結。
決定是要將寄件者的電子郵件位址還是整個網域加入到 Mailjet 設定。如果可以存取 DNS,配置整個網域可能會比較容易。請跳至 加入網域 區段以了解加入網域的步驟。
備註
需要配置使用 Mailjet 伺服器傳送電子郵件的所有 Odoo 資料庫使用者的電子郵件位址,或者可以配置使用者電子郵件位址的網域。
預設情況下,最初在 Mailjet 帳戶中設定的電子郵件位址會被加入為信任的寄件者。若要加入其他電子郵件位址,請按一下標示為 加入寄件者位址 的按鈕。然後,加入已配置為從自訂網域傳送的電子郵件位址。
至少應在提供商中設定以下電子郵件位址,並在 Mailjet 中進行驗證:
notifications@yourdomain.com
bounce@yourdomain.com
catchall@yourdomain.com
備註
將 yourdomain 替換為 Odoo 資料庫的自訂網域。如果沒有自訂網域,則使用 mail.catchall.domain 系統參數。
之後,填寫 電子郵件資訊 表單,確保選擇適當的電子郵件類型:交易電子郵件或大量電子郵件。完成表單後,系統會將啟用電子郵件傳送到該電子郵件地址,然後即可啟用受信任的寄件者。
警告
為防止電子郵件被標記為垃圾郵件,請:ref:設定自訂網域 <email-online-sh-domain>。使用 Odoo 提供的子網域 (dbname.odoo.com) 與 Mailjet 伺服器可能會導致電子郵件傳遞問題,因為無法在該子網域上配置電子郵件驗證協定(SPF、DKIM 和 DMARC)。
加入網域¶
透過將整個網域加入 Mailjet 帳戶,與該網域相關的所有寄件者地址都會自動驗證,可使用 Mailjet 伺服器傳送電子郵件。首先,前往 Mailjet 帳戶資訊 頁面。接著,按一下 加入寄件者網域或地址 連結 (位於 寄件者與網域 區段下方)。然後,按一下 加入網域 以加入自訂網域。
備註
需要將網域加入 Mailjet 帳戶,然後透過 DNS 進行驗證。
之後,填寫 Mailjet 上的 加入新網域 頁面,然後按一下 繼續。
加入網域後,會顯示驗證頁面。除非 Odoo 資料庫是離線安裝 (在這種情況下,選擇 選項 1),否則選擇 選項 2:建立 DNS 記錄。將 TXT 記錄資訊複製到記事本,然後前往該網域的 DNS 供應商以完成驗證。
在網域的 DNS 中設定¶
從 Mailjet 帳戶取得 TXT 記錄資訊後,將 TXT 記錄加入網域的 DNS。此程序會因 DNS 供應商而異。請諮詢供應商以了解特定的配置程序。TXT 記錄資訊包含 主機 和 值。將這些資訊貼到 TXT 記錄中的對應欄位。
返回 Mailjet 帳戶資訊¶
將 TXT 記錄加入網域的 DNS 後,返回 Mailjet 帳戶。然後,前往 ,按一下 網域 旁邊的齒輪圖示,然後選擇 驗證。
此動作也可以透過前往 Mailjet 帳戶資訊上的 寄件者網域與地址 頁面並按一下 管理 來完成。
接著,按一下 立即檢查 以驗證在網域上加入的 TXT 記錄。如果網域配置正確,會顯示成功畫面。
成功設定網域後,有一個選項可以 驗證此網域 (SPF/DKIM)。此按鈕會產生 SPF 和 DKIM 供應商。
在 Odoo 中設定¶
若要完成設定,請導航至 Odoo 資料庫並前往:guilabel:設定。開啟:ref:developer-mode`後,前往:menuselection:`技術選單 --> 電子郵件 --> 外發郵件伺服器。然後,按一下:guilabel:`建立`按鈕以建立新的外發伺服器配置。
接下來,輸入先前從 Mailjet 帳戶複製的 SMTP server`(in-v3.mailjet.com)、`port number`(587 或 465)和 `Security (SSL/TLS)。這些資訊也可以在`此處<https://app.mailjet.com/account/setup>`_找到。即使 Mailjet 可能不要求使用,仍建議使用:abbr:SSL(安全通訊端層)/TLS(傳輸層安全性)。
在:guilabel:使用者名稱`中,輸入:guilabel:`API KEY。在:guilabel:密碼`中,輸入先前從 Mailjet 帳戶複製到記事本的:guilabel:`SECRET KEY。這些設定可以在:menuselection:`Mailjet –> 帳戶設定 –> SMTP 和 SEND API 設定`中找到。
然後,如果 Mailjet 伺服器用於大量郵寄,請將:guilabel:優先順序`值設定為高於任何交易電子郵件伺服器的值。最後,儲存設定並:guilabel:`測試連線。