配信停止

一斉配信のメールには、2 つの配信停止の仕組みが付きます。設定は不要です。

リンク

{{{SPACEPOST_UNSUBSCRIBE_URL}}} は、https://app.spacepost.dev/u/<token> のような URL に展開されます。トークンはコンタクトごとに署名されているため、推測したり改ざんしたりできません。

• リンクを開くと、確認ページが表示されます(「j***@example.com へのメール配信を停止しますか?」)。GET で誰かが配信停止になることはないため、リンクスキャナーやメールのセキュリティツールが誤って配信停止してしまうことはありません。ページ上のアドレスはマスクされます。
• ボタンを押すと POST が送信され、コンタクトの unsubscribed フラグが true に設定されます。

HTML に配信停止のプレースホルダーがない場合は、リンク付きのフッターが自動で追加されます(テキスト部分にはプレーンテキストの 1 行が追加されます)。文言や位置を自分で決めたい場合は、独自のデザインにプレースホルダーを入れてください。

ヘッダー

SpacePost は、Gmail と Yahoo が大量メールに要求するヘッダーを追加します。

List-Unsubscribe: <https://app.spacepost.dev/u/<token>>
List-Unsubscribe-Post: List-Unsubscribe=One-Click

これらがあると、Gmail と Apple Mail は送信者の隣にネイティブの 配信停止 ボタンを表示します。クリックすると、メールクライアントが URL に POST し、RFC 8058 の定めどおりに、コンタクトが直ちに配信停止になります。受信者が迷惑メールボタンを使うよりも、評判にとってはるかに有利です。

そのあとに起きること

• そのコンタクトは、そのオーディエンスへの以降の一斉配信すべてでスキップされます。
• 現時点では、配信停止について Webhook には何も送信されません。ご自身のデータベースと同期するには、GET /audiences/{id}/contacts/{idOrEmail} から unsubscribed フラグを読み取るか、コンタクトを一覧取得してください。
• 求められて再購読させる場合は、コンタクトに { "unsubscribed": false } を PATCH します。明確な依頼があった場合にのみ行ってください。

トランザクションメール

配信停止リンクはマーケティングメール向けです。パスワードのリセット、領収書、セキュリティ通知には必要ありません。POST /emails でマーケティング内容を送信する場合は、ヘッダーを自分で追加し(カスタムヘッダーをご覧ください)、オプトアウトをご自身の側で処理するか、一斉配信を使ってください。