送信
メールの送信
トランザクションメッセージ、一括送信、返信、添付ファイル、ホスト型テンプレートを安全に送信します。
メッセージの内容
ワークスペースの検証済みドメイン上のfrom送信者ID、1件以上のto受信者、そしてHTML、テキスト、または公開済みのホスト型テンプレート1つを指定します。内容を直接指定する送信ではsubjectを省略でき、その場合は件名が空になります。SendHQは必要に応じてHTMLからテキスト版を生成しますが、自分で作成したプレーンテキスト版のほうが確実です。
受信者とクレジット
1通のメッセージに含められる宛先は、To、Cc、Bccの合計で最大100件です。宛先ごとに受信者配信クレジットを1つ消費します。正規化後に重複する受信者アドレスはサプレッションのチェックが1回だけ行われますが、すべての宛先がメッセージの上限にカウントされます。
安全な再試行
単一送信と一括送信のどちらでも、200文字以内の一定のIdempotency-Keyを送信してください。同じキーと同一のJSONペイロードを再利用すると、保存済みのレスポンスが再送され、Idempotent-Replayed: trueが付加されます。同じキーで受信者、内容、ヘッダー、テンプレートデータのいずれかを変更すると409が返されます。また、最初のリクエストが処理中の間に同じキーで同時にリクエストした場合も409が返されます。
一括送信
POST /emails/batchは最大100個のメッセージオブジェクトを受け付け、各位置ごとに結果を返します。個別化したテンプレートデータには、1つの個別化テンプレートを複数の受信者に送るのではなく、メッセージオブジェクトを分けて使ってください。
返信とスレッド
返信する際はreply_to_email_idを設定します。SendHQがMessage-ID、In-Reply-To、References、既存のスレッドIDを導出します。会話全体はGET /threads/:idで取得できます。