Skip to main content

​
Qué es

Un registro de baja de suscripción indica que un cliente optó por no recibir mensajes de tu empresa en un canal específico. El cliente y el canal forman juntos el registro único.

​
Antes de empezar

  • Define cómo recopila y registra el consentimiento tu producto.
  • Normaliza los números de teléfono al formato E.164.
  • Elige el tipo de identificador de cliente y el canal correctos.
  • Decide cómo se sincronizan las bajas con tus sistemas de origen.

​
Cómo funciona

  1. Crea una baja de suscripción cuando un cliente opte por no recibir mensajes.
  2. Comprueba o lista los registros antes del envío cuando tu flujo de trabajo no aplique ya la supresión de forma automática.
  3. Elimina el registro solo cuando el cliente vuelva a suscribirse (opt-in) válidamente.
  4. Procesa los eventos de Webhook de baja de suscripción para sincronizar los sistemas externos.
No interpretes la eliminación como una prueba automática de consentimiento. Tu aplicación debe conservar la evidencia y la base de políticas para la resuscripción.

​
Solicitud

​
Crear una baja de suscripción

POST /unsubscribers

​
Eliminar una baja de suscripción tras el opt-in

DELETE /unsubscribers/{customer}/{channel}
Codifica en URL (URL-encode) el valor de la ruta del cliente cuando lo requiera tu cliente HTTP.

​
Respuesta

La creación devuelve el registro guardado.
La obtención y la eliminación devuelven el recurso de baja coincidente. Un registro no encontrado devuelve un error en lugar de un estado de baja.

​
Cumplimiento

Trata la supresión como un límite de seguridad. Aplícala de forma coherente en envíos masivos, flujos transaccionales donde la política lo requiera, reintentos y operaciones manuales. Utiliza eventos de Webhook para sincronizar nuevas bajas y registros de bajas eliminados.

​
Límites y resolución de problemas

  • El mismo cliente puede tener registros independientes para diferentes canales.
  • Utiliza el type correcto para el identificador del cliente.
  • No elimines silenciosamente un registro sin un evento de opt-in válido.
  • Los endpoints de listado admiten paginación por cursor; sigue cursor.after.
  • Diseña el procesamiento concurrente de opt-in y opt-out de modo que prevalezca la decisión válida más reciente del cliente.

Crear una baja de suscripción

Inspecciona los tipos de identificadores y canales compatibles.

Webhooks de baja de suscripción

Sincroniza eventos de opt-out y resuscripción.