独自のご自身のMailgunアカウント経由でメールを送信する

Mailgunアカウントと、ドメインのDNSへのアクセスが必要になります。

Mailgun公式ドキュメント: ドメインの追加と検証 · APIキー · 新規登録

1. 送信ドメインをMailgunに追加する

Mailgunダッシュボードで Send → Domains → Add New Domain に移動し、mail.yourdomain.com などのサブドメインを入力します。

⚠️ Mailgun公式のガイダンスではサブドメインの使用が推奨されており、他のプロバイダー以上にここでは重要になります。Mailgunは指定したドメインに対して独自のSPFおよびDKIMレコードを設定するため、ルートドメインを指定すると、それらのレコードがビジネス用メールボックスが依存しているレコードと混在することになります。

データの保存先となるリージョン（US または EU）を選択します。これを必ず控えておいてください。ステップ4で必要になり、最も間違いやすいポイントです。

2. Mailgunから提供されたDNSレコードを公開する

Mailgunに一覧が表示されます。そのすべてをDNSプロバイダーに追加してください。

| 種類 | ホスト | 目的 | | --- | --- | --- | | TXT | mail.yourdomain.com | SPF — v=spf1 include:mailgun.org ~all | | TXT | mailo._domainkey.mail.yourdomain.com | DKIM公開鍵 | | CNAME | email.mail.yourdomain.com | トラッキングおよびバウンス処理 | | MX | mail.yourdomain.com | バウンスの受信（Mailgunの2つのMXホスト） |

⛔ 送信サブドメインにすでにSPFレコードが存在する場合は、それを編集してください（2つ目を追加しないこと）。 2つのSPF TXT レコードを持つドメインはSPFチェックに完全に失敗し、レコードがない状態よりも悪影響を及ぼします。

その後、Mailgunで Verify DNS Settings をクリックします。ステータスが緑色になるまでに最大1時間かかることがあります。

⭐ 送信のみを行う場合でも、MXレコードを追加してください。 MXレコードはMailgunがバウンスを収集するために使用されます。これがない場合、無効なアドレス宛てのバウンスがどこにも届かず、Mailgunがそれを除外できないため、今後受信することのないアドレスへの送信に対して料金を支払い続けることになります。

3. APIキーを取得する

Send → Sending → Domain settings → API keys、またはアカウントの API Keys ページに移動します。

プランで提供されている場合は、アカウントのプライベートAPIキーではなく、このドメインにスコープされた送信キー（sending key）を使用してください。送信キーは送信のみが可能ですが、プライベートキーはログの読み取りやアカウントの変更が可能です。Zinnが後者を保持する理由はありません。

4. Zinn®で接続する

ダッシュボードで Email sending を開き、以下を入力します。

Provider — Mailgun
Send from this domain — mail.yourdomain.com （アドレスではなくドメイン）
Mailgun sending domain — Mailgunに追加したドメインと同じドメイン
Region — ステップ1に一致する us または eu
Mailgun API key — ステップ3のキー

⛔⛔ リージョンを間違えないようにしてください。 EUでホストされているMailgunアカウントは、まったく異なるAPIホストから提供されています。EUアカウントのキーをUSホストに送信すると、"401 Unauthorized" が返されます。これはまさに間違ったキーを入力したときと同じ挙動を示します。キーが確実に正しいにもかかわらず401エラーが発生する場合は、ほとんどの場合これが原因です。

5. テスト送信を行ってコードを入力する

別のドメインの受信トレイ（Gmailアドレスが最適です）を使用して Send test message をクリックします。受信トレイからコードを確認し、入力します。メールが即座に切り替わります。

動作しない場合

401 Unauthorized — リージョンが間違っている（上記参照）、または別のアカウントのキーを貼り付けた可能性があります。キーを再入力するのではなく、再生成してください。先頭の key- は見落としやすくなっています。

テストメッセージが届かない — Mailgunの Logs ページを確認してください。Mailgunにログが全く残っていない場合は、認証情報またはドメイン名が間違っています。Mailgunが受け入れたにもかかわらずその後に失敗した場合は、その理由が明確に記載されますが、ほとんどの場合はDNSが原因です。

"Domain not found" — Mailgun sending domain フィールドには、サブドメインを含め、Mailgunに記載されている通りのドメインを正確に入力する必要があります。yourdomain.com と mail.yourdomain.com は、Mailgunにとってはまったく異なる2つのドメインです。

動作していたが停止した — 無料トライアルが終了していないか確認してください。Mailgunのトライアルアカウントは承認された受信者にしか送信できないため、自分自身のアドレス宛てのテストメッセージは機能し続ける一方で、顧客宛てのメールはすべて通知なく送信されなくなります。