Mailjet API¶
OdooはMailjetのメール一括配信用 API と互換性があります。MailjetアカウントとOdooデータベースの設定を行うことで、Mailjet経由でメール一括配信専用のサーバをセットアップします。状況によっては、カスタムドメインの DNS 設定にも設定を行う必要があります。
Mailjetのセットアップ¶
API認証作成¶
まず、Mailjetアカウント情報 ページにサインインします。次に、送信者とドメイン セクションに移動し、SMTPと送信API設定 をクリックします。
次に、SMTP の設定をメモ帳にコピーします。これらは 設定(SMTPのみ) セクションにあります。 SMTP の設定には、サーバアドレス、必要なセキュリティオプション (SSL/TLS の使用)、およびポート番号が含まれます。MailjetをOdooで設定するには、これらの設定が必要です。これについては、最後のセクション で説明しています。
重要
OdooオンラインとOdoo.shデータベース上で、Odooは ポート25をブロック します。
次に、API認証情報の取得 と表示されたボタンをクリックして、Mailjet API認証情報を取得します。
次に、目のアイコンをクリックして APIキー を表示します。このキーをメモ帳にコピーして下さい。これはOdooの設定における ユーザ名 として使用されます。次に、シークレットキーを生成 ボタンをクリックして、シークレットキー を生成します。このキーをメモ帳にコピーして下さい。これはOdooの設定における パスワード として使用されます。
検証済の送信アドレスを追加する¶
次のステップは、Mailjetアカウントの設定に送信者アドレスまたはドメインを追加し、Mailjetのサーバを使用してEメールを送信できるように承認することです。まず、Mailjetアカウント情報 ページに移動します。次に、送信者とドメイン セクションの下にある 送信者ドメインまたはアドレスを追加 リンクをクリックします。
送信者のEメールアドレスまたはドメイン全体をMailjetの設定に追加する必要があるかどうかを判断します。 DNS へのアクセスが可能な場合は、ドメイン全体を設定する方が簡単かもしれません。 ドメインの追加手順については、ドメインの追加 セクションを参照して下さい。
注釈
Mailjetのサーバを使用してEメールを送信しているOdooデータベースユーザのEメールアドレスを全て設定するか、ユーザのEメールアドレスのドメインを設定する必要があります。
デフォルトでは、Mailjetアカウントで最初に設定したEメールアドレスが信頼できる送信者として追加されています。別のEメールアドレスを追加するには、:guilabel:`送信者アドレスを追加`と書かれたボタンをクリックします。次に、カスタムドメインから送信するように設定したEメールアドレスを追加します。
最低限、以下のEメールアドレスはプロバイダーで設定し、Mailjetで確認する必要があります。
notifications@yourdomain.com
bounce@yourdomain.com
catchall@yourdomain.com
注釈
Odooデータベース用に`yourdomain` with the custom domain for the Odoo database. If there isn't one, then use the mail.catchall.domain system parameter.
その後、Eメール情報 フォームに必要事項を入力し、トランザクションメールまたは大量メールの適切なメールタイプを選択して下さい。フォームの入力が完了すると、入力したメールアドレス宛に有効化メールが送信され、信頼できる送信者の有効化が行われます。
送信者のドメインで、SPF/DKIM/DMARC の設定を行うことをお勧めします。
警告
It is recommended to set up a custom domain. Due to increased security on provider side, emails sent with an outgoing mail server other than the Odoo's provided one using subdomain (dbname.odoo.com) will fail due to DMARC policy, and/or be marked as spam.
ドメインを追加する¶
Mailjetアカウントにドメイン全体を追加すると、そのドメインに関連する全ての送信者アドレスがMailjetサーバを使用してEメールを送信するため自動的に検証されます。まず、Mailjet アカウント情報 ページに移動します。次に、送信者とドメイン セクションの下にある:guilabel:送信者ドメインまたはアドレスの追加 リンクをクリックします。次に、カスタムドメインを追加するには、ドメインの追加 をクリックします。
注釈
ドメインはMailjetアカウントに追加し、 DNS で検証済である必要があります。
その後、Mailjetの 新規ドメインを追加 ページで 続行 をクリックします。
ドメインを追加すると、検証ページが表示されます。Odooデータベースがオンプレミス環境(その場合は オプション1 を選択)でない場合は、オプション2: DNSレコードの作成 を選択します。TXTレコードの情報をメモ帳にコピーし、ドメインの DNS プロバイダーに移動して検証を完了します。
ドメインのDNSでの設定¶
MailjetアカウントからTXTレコード情報を取得したら、ドメインの DNS にTXTレコードを追加します。このプロセスは、DNS プロバイダーによって異なります。具体的な設定プロセスについては、プロバイダーにお問い合わせ下さい。TXTレコード情報は、:guilabel:`ホスト`と:guilabel:`値`で構成されています。これらの情報をTXTレコードの対応するフィールドに貼付けます。
Return to Mailjetアカウント情報に戻る¶
TXTレコードをドメインの:abbr:DNS(Domain Name System) に追加した後、Mailjetアカウントに戻ります。次に、 に移動し、ドメイン の隣にある歯車アイコンをクリックし、検証 を選択します。
この操作は、Mailjetのアカウント情報の 送信者ドメイン & アドレス ページで、管理 をクリックすることでも行えます。
次に、今すぐ確認 をクリックして、ドメインに追加されたTXTレコードを検証します。ドメインが正しく設定されていれば、成功画面が表示されます。
ドメインの設定が完了すると、このドメインを認証する(SPF/DKIM) というオプションが表示されます。このボタンをクリックすると、SPF および DKIM プロバイダーに送信されます。
Odooでの設定¶
設定を完了するには、Odooデータベースに移動し、管理設定 に進みます。開発者モード をオンにして、 に進みます。次に、作成 ボタンをクリックして、新しい送信サーバ設定を作成します。
次に、Mailjetアカウントからコピーした SMTPサーバ (in-v3.mailjet.com), ポート番号 (587 または 465), および セキュリティ (SSL/TLS) を入力します。それらは ここ でも見つけることができます。Mailjetが要求しない場合でも、SSL/TLS を使用することを推奨します。
ユーザ名 には、APIキー を入力します。パスワード には、Mailjetアカウントからメモ帳にコピーした シークレットキー を入力します。これらの設定は、 (Mailjet --> アカウント設定 --> SMTPおよびSEND API設定)で確認できます。
次に、Mailjetサーバをメール一括配信に使用している場合は、トランザクションメールサーバの 優先 値よりも高い値を設定します。最後に、設定を保存し、:guilabel:`接続テスト`を実行します。
