Enlaces del destinatario

Son las únicas rutas del producto a las que un destinatario llega directamente, sin clave. Tú nunca las llamas: te aseguras de que tu plantilla las lleve.

Los enlaces

URLMétodoQuién lo abreRespuesta
/api/o/{token}GETEl cliente de correo del destinatario, al abrirUn GIF transparente de 1×1
/api/t/{token}GETEl destinatario, al hacer clicUn 302 hacia el destino real
/api/unsubscribe/{token}POSTEl cliente de correo (baja en un clic RFC 8058)Neutra, valga lo que valga el token
/unsubscribe/{token}páginaEl destinatario, desde el pie del correoLa página de baja
/subscribe/confirm/{token}páginaUn contacto nuevo, desde el correo de opt-inLa página de confirmación

Confirmación de doble opt-in — /subscribe/confirm/{token}

Un contacto creado mediante el flujo de doble opt-in queda en pending y recibe un correo de confirmación. Abrir el enlace lo pasa a subscribed. Hasta entonces está en la audiencia pero no recibe nada.
No hay ningún endpoint público de «suscripción». Un contacto entra en una audiencia mediante POST /api/v1/lists/{listId}/contacts, con una clave de API; consulta la API de audiencia. La confirmación es la única mitad pública del flujo, y es una página, no una API. Nadie puede meter contactos en tus listas desde fuera.

Qué significa esto para la API

El estado de un contacto es el punto de encuentro entre estos enlaces públicos y la API, y la API cede a propósito:
  • PATCH /api/v1/contacts/{contactId} ignora un status enviado en el cuerpo. El estado de suscripción solo cambia mediante actos explícitos.
  • Un upsert nunca resucita en silencio a un contacto dado de baja.
  • Un destinatario que se dio de baja desde su cliente de correo queda dado de baja para siempre; solo POST /api/v1/contacts/{contactId}/resubscribe puede deshacerlo, y nunca para una dirección bounced.
El token de baja de un contacto nunca se expone en /api/v1. Solo existe dentro de los correos que se enviaron a ese contacto.