エラーとトラブルシューティング

• レスポンスコード
• クリックトラッキングの無効化
• 不正なSMTP APIヘッダ
• smtp.sendgrid.netで証明書の確認に失敗する

レスポンスコード

SMTPでメールを送信すると宛先サーバはレスポンスを返します。2xxは通常、成功を意味します。4xxは遅延を意味し、SendGridは最長72時間再送を試みます。5xxは恒久的エラーを意味し、再送は試みません。以下の表に、発生する可能性のあるレスポンスコードとエラーの例、そしてレスポンスの一般的な説明を示します。この表にすべてのエラーが網羅されているわけではありません。

クリックトラッキングの無効化

クリックトラッキングを無効化するには、以下のようなX-SMTPAPIヘッダを指定します:

1
2
3
4
5
6
7
8
9
10

{
  "filters": {
    "clicktrack": {
      "settings":
        {
          "enable": 0
        }
    }
  }
}

不正なSMTP APIヘッダ

不正なX-SMTPAPIヘッダを指定して送信を試みると、エラーの詳細を通知するメールが届きます。Activity画面もしくはEvent Webhookのデータでエラーが発生したことを確認することもできます。このメールはトラブルシューティングに必要な情報を通知するものです。多くはJSON形式が不正なケースであるため、JSON形式が正常かどうかをチェックすることをお勧めします。

smtp.sendgrid.netで証明書の確認に失敗する

1

certificate verification failed for [smtp.sendgrid.net](http://smtp.sendgrid.net/)[198.37.144.225]:587: untrusted issuer /C=US/O=The Go Daddy Group, Inc./OU=Go Daddy Class 2 Certification Authority

このようなエラーが発生した場合、コネクションは暗号化されています。お客様のサーバがSendGridの証明書を検証するために必要なCA証明書を持っていないことを意味します。

証明書を更新する方法

1. https://certs.godaddy.com/anonymous/repository.pkiからGoDaddyのCAバンドルをダウンロードしてください（gd_bundle-g2-g1.crtという名前のファイルを取得してください）。
2. サーバ上にそのファイルを保存してください。
3. /etc/postfix/main.cfに以下のような行を記載してPostfixにCA証明書の保存場所を設定してください。 smtp_tls_CAfile = /etc/postfix/ssl/gd_bundle-g2-g1.crt
4. Postfixを再起動して設定変更を反映してください。

SendGrid以外のメールサーバと通信を行う場合、この証明書を既存のCAバンドル（通常はca-bundle.crt）に追記してください。

追加のリソース

• SMTPでメール送信する
• SMTPの使用方法
• SMTPメールの構築