Disiscrizioni e GDPR

Pagine ospitate /u/:token, {{unsubscribeUrl}} e webhook contact.unsubscribed.

MailingCore gestisce le disiscrizioni con pagine ospitate, link automatici nelle campagne e webhook per sincronizzare il tuo CRM.

Link nelle campagne

Inserisci il tag {{unsubscribeUrl}} nel template HTML. Al momento dell'invio, MailingCore lo sostituisce con un URL firmato univoco per ogni destinatario.

Le campagne includono anche le intestazioni RFC 8058 (List-Unsubscribe, List-Unsubscribe-Post) per la disiscrizione con un clic dai client di posta compatibili.

Pagina ospitata

Metodo	Percorso	Descrizione
`GET`	`/u/:token`	Pagina di conferma disiscrizione
`POST`	`/u/:token`	Conferma la disiscrizione → soppressione + webhook

Parametro opzionale: ?lang=it (o es, en, fr, ca, de) per localizzare la pagina.

https://api.mailingcore.com/u/eyJhbGciOiJIUzI1NiIs...?lang=it

Non richiede autenticazione: il token e firmato e monouso.

Aggiungi il tag al template
Includi {{unsubscribeUrl}} nel footer del template della campagna.
L'utente clicca il link
GET /u/:token mostra la pagina di conferma nella lingua del contatto (?lang=).
Conferma la disiscrizione
POST /u/:token registra la soppressione e invia il webhook contact.unsubscribed.

Webhook

Registra un endpoint con evento contact.unsubscribed per aggiornare il tuo database:

{
  "event": "contact.unsubscribed",
  "data": {
    "email": "[email protected]",
    "contactId": "clx...",
    "source": "unsubscribe-page"
  }
}

Vedi Webhook in uscita e Verificare firma HMAC.

Implicazioni GDPR

La disiscrizione aggiunge l'email alla lista di soppressione; i futuri invii vengono bloccati.
Per il diritto all'oblio completo, usa DELETE /contacts/:externalId (scope contacts:write).
Conserva traccia di consentVersion al momento dell'iscrizione per audit.