Abmeldung

Jede E-Mail einer Kampagne erhält zwei Abmeldemechanismen, ohne dass du etwas konfigurieren musst.

Der Link

{{{SPACEPOST_UNSUBSCRIBE_URL}}} wird zu einer URL wie https://app.spacepost.dev/u/<token> aufgelöst. Das Token ist pro Kontakt signiert und lässt sich daher weder erraten noch ändern.

Das Öffnen des Links zeigt eine Bestätigungsseite (“Stop receiving emails at j***@example.com?”). Ein GET meldet nie jemanden ab, sodass Link-Scanner und E-Mail-Sicherheitstools niemanden versehentlich abmelden. Die Adresse ist auf der Seite maskiert.
Ein Klick auf den Button sendet ein POST, das das Flag unsubscribed des Kontakts auf true setzt.

Enthält dein HTML keinen Abmelde-Platzhalter, wird für dich eine Fußzeile mit einem Link angehängt (und eine Zeile im Textteil). Setze den Platzhalter in dein eigenes Design, um Formulierung und Position zu steuern.

Die Header

SpacePost fügt die Header hinzu, die Gmail und Yahoo für Massen-E-Mails verlangen:

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

Damit zeigen Gmail und Apple Mail neben dem Absender einen nativen Button Unsubscribe an. Ein Klick veranlasst den E-Mail-Client, per POST an die URL zu senden, wodurch der Kontakt sofort abgemeldet wird, wie in RFC 8058 festgelegt. Das ist für deine Reputation viel besser, als wenn Empfänger den Spam-Button benutzen.

Was danach passiert

Der Kontakt wird von allen künftigen Kampagnen an diese Zielgruppe übersprungen.
Für Abmeldungen wird derzeit nichts an deine Webhooks gesendet; lies das Flag unsubscribed über GET /audiences/{id}/contacts/{idOrEmail} aus oder liste Kontakte auf, um deine eigene Datenbank abzugleichen.
Um jemanden wieder anzumelden, der darum bittet, sende ein PATCH an den Kontakt mit { "unsubscribed": false }. Tu das nur auf ausdrückliche Anfrage.

Transaktions-E-Mails

Abmeldelinks sind für Marketing-E-Mails gedacht. Passwort-Zurücksetzungen, Belege und Sicherheitshinweise brauchen keinen. Wenn du Marketing-Inhalte über POST /emails sendest, füge die Header selbst hinzu (siehe Eigene Header) und behandle Opt-outs auf deiner Seite, oder nutze Kampagnen.