Skip to main content
RFC 8058 es el botón “salir” de la bandeja de entrada, no es necesario abrir el correo electrónico y buscar el pie de página.

​
¿Por qué usarlo?

Gmail y Yahoo requieren cancelar la suscripción con un solo clic para recibir correo promocional. Sin los encabezados correctos, la exclusión voluntaria depende únicamente del enlace HTML (centro de preferencias). Con RFC 8058, el buzón muestra un botón nativo y Notifique acepta la solicitud de inmediato.

​
Cuándo usarlo

  • Plantilla MARKETING (y campañas/automatizaciones que la utilizan) → encabezados RFC 8058 por defecto
  • POST /v1/email/messages cuando el destinatario se asigna a un contacto → de forma predeterminada
  • Correo electrónico transaccional (recibo, OTP, restablecimiento de contraseña) → configurar listUnsubscribe: false
  • El destinatario no tiene contacto en el espacio de trabajo → los encabezados no se inyectan (sin token)

​
Cómo funciona

  1. Al enviar, Notifique emite un token (la misma familia que {{preferences_link}}) y establece encabezados MIME:
    • List-Unsubscribe: <https://…/w/list-unsubscribe/:contactId?token=…>
    • List-Unsubscribe-Post: List-Unsubscribe=One-Click
  2. Gmail/Yahoo PUBLICAR en esa URL con cuerpo List-Unsubscribe=One-Click (sin cookies, sin inicio de sesión), la opción de no participar ocurre solo en la POST.
  3. Un GET en la misma URL solo valida el token y muestra una página de confirmación (sin cambio de preferencia, evita escáneres/búsqueda previa).
  4. En POST, Notifique se da de baja inmediatamente:
    • con topic en la URL (plantilla con un tema) → tema UNSUBSCRIBED (tema no válido → error, sin respaldo global)
    • sin tema → receiveMarketing = false
  5. La página de éxito puede vincularse al centro de preferencias para volver a suscribirse.
El pie de página con {{preferences_link}} / “haga clic aquí para cancelar la suscripción” todavía existe. RFC 8058 es aditivo (encabezados); no reemplaza el centro de preferencias.

​
API directa (POST /v1/email/messages)

If listUnsubscribeTopicId does not exist in this workspace: 400 with code INVALID_LIST_UNSUBSCRIBE_TOPIC. See Error responses. For transactional mail:

​
Próximos pasos