トランザクションメールを送信する
2024年4月以降、Domain AuthenticationもしくはSingle Sender Verificationの設定が必須になり、送信元に指定するドメインまたはメールアドレスで設定を完了させていない場合はメールを送信できません。詳しくはこちらをご覧ください。
トランザクションメールを送信するには、Web API(メール送信用エンドポイント)またはSMTPを利用します。
Web APIとSMTPの違い
どちらもメール送信できる点においては同じですが、利便性や制限事項が異なります。主な違いについてまとめます。
Web API(メール送信用エンドポイント) | SMTP | |
---|---|---|
プロトコル | HTTPS | SMTP |
接続先ホスト | api.sendgrid.com | smtp.sendgrid.net |
ポート | TCP 443 | TCP 25/465/587/2525 |
通信セキュリティ | SSL(TLS) | 平文/SSL/TLS |
認証方式 | 基本認証 | SMTP認証 |
APIキー | 利用可 | 利用可 |
文字コード | UTF-8のみ | UTF-8、ISO-2022-JPなどが指定可能 |
本文のパート構造 | 以下のうちいずれか
| 自由に指定可能 |
Web APIで送信する
2024年4月以降、Domain AuthenticationもしくはSingle Sender Verificationの設定が必須になり、送信元に指定するドメインまたはメールアドレスで設定を完了させていない場合はメールを送信できません。詳しくはこちらをご覧ください。
Web APIを利用する場合、v3の利用を推奨しています。v2も継続してご利用いただけますが、本ページはv3を前提として記述しています。
cURL
cURLコマンドを利用してWeb API経由でメール送信できます。[API_KEY]にはAPIキーを設定します。詳しいパラメータや制限事項についてはAPIリファレンスを参照してください。
1 2 3 4 |
|
-dパラメータには以下のようなJSONデータを指定します。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 |
|
公式ライブラリ
SendGridの公式ライブラリはWeb APIを利用してメール送信しています。ライブラリの詳しい利用方法やサンプルコードについては各リポジトリを参照してください。
SMTPで送信する
2024年4月以降、Domain AuthenticationもしくはSingle Sender Verificationの設定が必須になり、送信元に指定するドメインまたはメールアドレスで設定を完了させていない場合はメールを送信できません。詳しくはこちらをご覧ください。
SMTPの接続情報
SMTPの接続情報や制限事項についてはこちらを参照してください。
Telnetコマンドによる接続確認
telnetコマンドを利用してSMTPサーバとの接続確認を行うことができます。認証情報はBase64エンコードする必要があります。
「>」で始まる行は、コマンドの入力が必要です。ただし、「#」以降の文字列は補足説明用のコメントであるため入力不要です。
2XX・3XXなどの数字で始まる行は、サーバからの応答を出力したものです。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 |
|
メールクライアントからのメール送信
Thunderbirdでの設定例を紹介します。SMTP認証でAPIキーを利用する場合、ユーザ名に「apikey」という固定文字列、パスワードにAPIキーを設定します。
その他のメールクライアントやメールサーバ、フレームワークなどとの連携方法については「システム連携」を参照してください。