メールの送信

SendGridを使用してメールを送信します。

オプション

フィールド 定義 タイプ 必須

Use Template? (テンプレートを使用?)

メールのテンプレートを使用するかどうかを示します。

Yesに設定すると、テンプレートID(Template ID)および動的なテンプレートデータ(Dynamic Template Data)フィールドが入力として追加されます。

Noに設定すると、件名(Subject)代替(Substitutions)コンテンツ(Content)フィールドが入力として追加されます。

ドロップダウン

リスト管理のバイパスあり?(With Bypass List Management?)

Yesに設定すると、スパムレポートリストをバイパスし、メールが確実に受信者に届くようにできます。バウンスとサブスクライブ解除のリストはチェックされたまま残ります。ただし、スパムレポート以外のリストのアドレスではメッセージを受信しません。

このフィルターをbypass_list_managementフィルターと組み合わせることはできません。

Yesに設定すると、リストの管理のバイパス(Bypass List Management)入力フィールドが追加されます。

Noに設定すると、スパム管理をバイパス?(Bypass Spam Management?)バウンス管理をバイパス?(Bypass Bounce Management?)サブスクライブ解除管理をバイパス?(Bypass Unsubscribe Management?)が入力として追加されます。

リスト管理のバイパス(Bypass List Management)入力フィールドをその他のバイパス(Bypass)フィールドと組み合わせることはできません。

ドロップダウン

スパムチェックあり?(With Spam Check?)

Yesに設定すると、スパムレポートリストをバイパスし、メールが確実に受信者に届くようにできます。バウンスとサブスクライブ解除のリストはチェックされたまま残ります。ただし、スパムレポート以外のリストのアドレスではメッセージを受信しません。

Yesに設定すると、しきい値(Threshold)およびポスト先URL(Post to URL)フィールドが必須になります。

Noに設定すると、入力にスパムチェック(Spam Check)は表示されません。

ドロップダウン

入力

フィールド 定義 タイプ 必須

メールアドレス(Email)

テンプレートID(Template ID)

メールのテンプレートIDを指定します。

件名とコンテンツ(テキストまたはHTML)が含まれるテンプレートは、パーソナライズまたはメッセージレベルで指定される件名とコンテンツの値をオーバーライドします。

テキスト

送信元(From)

メッセージ配信に使用される送信元(「From)」メールアドレス。

このアドレスは、Twilio SendGridアカウント内の検証済み送信者である必要があります。

テキスト

宛先(To)

意図した受信者のメールアドレス。

テキスト

カーボンコピー(CC)

メールのコピーを受信する受信者の配列。この配列の各オブジェクトには、受信者のメールアドレスが含まれている必要があります。

メールは、最大で1,000人のCC受信者に送信できます。

テキストのリスト FALSE

ブラインドカーボンコピー(BCC)

メールのブラインドカーボンコピーを受信する受信者の配列。この配列の各オブジェクトには、受信者のメールアドレスが含まれている必要があります。

メールは、最大で1,000人のBCC受信者に送信できます。

テキストのリスト FALSE

ヘッダー(Headers)

JSONのキーと値のペアを使用して、メールの取り扱い指示を指定できます。次のヘッダーは上書きできません。

  • x-sg-id

  • x-sg-eid

  • received

  • dkim-signature

  • Content-Type

  • Content-Transfer-Encoding

  • To

  • 開始

  • 件名

  • Reply-To

  • CC

  • ブラインドカーボンコピー(BCC)

オブジェクト FALSE

Substitutions (代替)

代替により、動的なトランザクション型テンプレートを使用せずにデータを挿入できます。

このフィールドを動的なトランザクション型テンプレートと併用しないでください。このテンプレートは、template_idd-で始まることで識別されます。

このフィールドは、"substitution_tag":"value to substitute"のパターンに従うキー/値ペアの集合です。

オブジェクト FALSE

動的なテンプレートデータ(Dynamic Template Data)

動的なテンプレートデータは、動的なトランザクション型テンプレートでHandlebars構文を使用することで利用できます。

このフィールドを動的なトランザクション型テンプレートと併用しないでください。このテンプレートは、template_idd-で始まることで識別されます。

このフィールドは、"variable_name":"value to insert"のパターンに従うキー/値ペアの集合です。

オブジェクト FALSE

カスタム引数(Custom Arguments)

このパーソナライズに固有の値で、メールやそのアクティビティデータと共に搬送されます。

このパラメーターに入力される任意の文字列は、使用するカスタム引数とみなされます。

このフィールドの最大長さは10,000バイトです。

オブジェクト FALSE

送信時刻(Send At)

メールを配信する時刻を指定するUNIXタイムスタンプを受け入れます。

72時間より先の送信はスケジューリングできません。ピーク時間を避けてメールをスケジューリングすることをお勧めします。ほとんどのメールは正時または半時の最初にスケジューリングされ、送信されます。ピーク時間を避けてメールをスケジューリングすると(たとえば、10時53分)、遅延率を抑えられる可能性があります。

数値 FALSE

カテゴリー(Categories)

このメールに関連付けるカテゴリー。

テキストのリスト FALSE

Batch ID (バッチID)

同時に送信されるメールのバッチを表すID。

リクエストにバッチID値を含めることで、そのメールをそのバッチに含めることができます。そのバッチの配信をキャンセルまたは一時停止することもできます。

テキスト FALSE

返信先(Reply To)

返信やバウンスが返されるメールアドレス。

テキスト FALSE

添付ファイル(Attachments)

含める添付ファイルを指定できる、オブジェクトの配列。

オブジェクトのリスト FALSE

コンテンツ(content)

添付するファイル。

ファイル

type

添付するコンテンツのMIMEタイプ。

たとえばtext/plaintext/htmlです。

テキスト FALSE

ファイル名(filename)

添付ファイルのファイル名。

テキスト

処置(Disposition)(disposition)

添付ファイルのコンテンツの処置。添付ファイルの表示方法を指定します。

たとえば、inlineを指定すると、添付ファイルは自動的にメッセージ内に表示されます。attachmentを指定すると、添付ファイルが表示されるまでに、ファイルを開く、またはダウンロードするなど、何らかのアクションが必要になります。

テキスト FALSE

content_id

メールのテンプレートID。件名とコンテンツ(テキストまたはHTML)が含まれるテンプレートは、パーソナライズまたはメッセージレベルで指定される件名とコンテンツの値をオーバーライドします。

テキスト FALSE

件名(Subject)

メールの件名。このフィールドは、個別化で設定された件名行により上書きされることがあります。

テキスト

コンテンツ(Content)

メールのコンテンツを指定するためのオブジェクトの配列。

  • type

  • value

オブジェクト

Spam Check (スパムチェック)

Threshold (しきい値)

フィルタリングのレベルを示す割り当て済みのSpamAssassin値。

範囲は1~10で、数値が小さいほどフィルタリングが厳しくなります。

ドロップダウン FALSE

ポスト先URL(Post to URL)

検査のためのスパムメッセージの送信先となるインバウンド解析URL。

テキスト

Footer (フッター)

有効?(Enable?)

Trueに設定すると、すべてのメールにデフォルトのフッターが入ります。

True/False FALSE

タイプ(Type)

フッターのタイプを示します。選択肢はTextHTMLです。

ドロップダウン FALSE

コンテンツ(Content)

フッターのコンテンツ。

テキスト FALSE

Unsubscribed (サブスクライブ解除)(Unsubscribes)

グループID(Group ID)

このメールと関連付ける、サブスクライブ解除グループ。

数値 FALSE

表示するグループ(Groups to Display)

サブスクライブ解除の設定ページに表示されるサブスクライブ解除グループを含む配列。

数値のリスト

FALSE

Mail Settings (メール設定)

IPプール名(IP Pool Name)

メールの送信元となるIPプールの名前。

テキスト FALSE

リスト管理をバイパス?(Bypass List Management?)

Trueに設定すると、すべてのサブスクライブ解除グループと抑制がバイパスされ、すべての受信者にメールが確実に送信されます。

このフィールドは、すべての受信者がメールを受信することが必要な緊急時にのみご利用ください。このフィルターを、その他のバイパスフィルターと組み合わせることはできません。

True/False FALSE

Bypass Spam Management (スパム管理をバイパス)

スパムレポートリストをバイパスし、メールが確実に受信者に届くようにできます。

True/False FALSE

Bypass Bounce Management (バウンス管理をバイパス)

バウンスリストをバイパスし、メールが確実に受信者に届くようにできます。

True/False FALSE

Bypass Unsubscribe Management (サブスクライブ解除管理をバイパス)

グローバルサブスクライブ解除リストをバイパスし、メールが確実に受信者に届くようにできます。

True/False FALSE

サンドボックスモード?(Sandbox Mode?)

Trueに設定すると、テスト用メールを送信し、リクエスト本文が有効で正しい書式であることを確認できます。

True/False FALSE

Click Tracking (クリック追跡)

有効?(Enable?)

Trueに設定すると、受信者がメールのリンクをクリックしたかどうかを追跡できます。

True/False FALSE

テキストを有効化?(Enable Text?)

Trueに設定すると、メールのtext/plain部分にこの設定を含めるかどうかを示します。

True/False FALSE

Open Tracking (開封追跡)

有効?(Enable?)

Trueに設定すると、コンテンツ本文に1ピクセルの画像を含めることで、メールが開かれたかどうかを追跡できます。このピクセルが読み込まれると、SendGridはメールが開かれたことをログに記録できます。

True/False FALSE

Substitution Tag (代替タグ)

メールの本文内の希望する場所に、指定した代替タグを挿入できます。このタグは、オープン追跡ピクセルに置き換えられます。

テキスト FALSE

Subscription Tracking (サブスクリプション追跡)

有効?(Enable?)

Trueに設定すると、メールのテキストおよびHTML本文の末尾にサブスクリプション管理リンクを挿入できます。

True/False FALSE

Substitution Tag (代替タグ)

サブスクライブ解除URLに置き換えられるタグ。たとえば[unsubscribe_url]です。

このパラメーターを使用すると、テキストとhtmlの両方のパラメーターがオーバーライドされます。リンクのURLは、追加の書式設定なしで代替タグの位置に配置されます。

テキスト FALSE

タイプ(Type)

代替タグのタイプを示します。選択肢はTextHTMLです。

ドロップダウン FALSE

コンテンツ(Content)

代替タグのコンテンツ。

テキスト FALSE

Google Analytics

有効?(Enable?)

Trueに設定すると、Google Analyticsで提供される追跡を有効にできます。

True/False FALSE

UTMソース(UTMSource)(UTM Source)

参照元ソースの名前。

たとえば、GoogleSomeDomain.comMarketing Emailなどです。

テキスト FALSE

UTMメディア(UTM Medium)

マーケティングメディアの名前。

たとえば、Emailです。

テキスト FALSE

UTM Term (UTM用語)

有料キーワードを識別するために使用されます。

テキスト FALSE

UTM Content (UTMコンテンツ)

キャンペーンを広告と区別するために使用されます。

テキスト FALSE

UTM Campaign (UTMキャンペーン)

キャンペーンの名前。

テキスト FALSE

出力

フィールド 定義 タイプ

ステータスコード(Status Code)

操作の結果。コネクターは、カードによって実行されたアクションの成否を示すHTTPステータスコードを返します。例:

  • 201 Createdステータスコードは、アクションが成功し、新しいリソースが作成されたことを示します。
  • 403 Forbiddenエラーは、必要な権限が不足していたためにHTTPリクエストが処理されなかったことを示します。

発生する可能性があるステータスコードの完全なリストについては、HTTPステータスコードを参照してください。

数値