Saltar al contenido

Bajas y supresiones

Cómo gestiona Vemudo la lista de bajas y bloqueos de tu organización: rebotes, quejas, bajas y altas manuales, y cómo consultarla o modificarla por API.

Por Equipo Vemudo · Actualizado el

La lista de bajas y bloqueos (supresiones) contiene las direcciones a las que Vemudo no enviará. Protege tu reputación y respeta la voluntad de tus destinatarios. Antes de aceptar cada email, la API comprueba la dirección: si está bloqueada, el email se guarda con estado suppressed, no se envía y no consume cuota.

Cómo entra una dirección

MotivoOrigenDuración
hard_bounceRebote permanente: la dirección no existe.Hasta que la quites.
complaintEl destinatario marcó un email como spam.Hasta que la quites desde el panel.
unsubscribeEl destinatario pidió la baja.Hasta que la quites desde el panel.
manualAlta manual desde el panel o la API.Hasta que la quites.
soft_bounceTres rebotes temporales en 7 días sin ninguna entrega entre medias.30 días.

Cada rebote temporal por sí solo no bloquea nada. Los rebotes por contenido rechazado o por tamaño tampoco bloquean la dirección. Si hay varias causas, prevalece la más grave: queja, rebote permanente, baja, manual y, por último, rebote temporal. Una baja activa solo la sustituye una queja.

Además, Vemudo mantiene bloqueos a nivel de plataforma. Se respetan siempre, pero no aparecen en tu lista ni se pueden modificar.

Consultar la lista

Con scope read o full:

bash
curl "https://api.vemudo.com/v1/[email protected]" \
  -H "Authorization: Bearer $VEMUDO_API_KEY"

Devuelve { "data": [...], "nextCursor": "..." }, de la más reciente a la más antigua, solo con las direcciones activas (las caducadas no aparecen). Filtros: email (dirección exacta), reason, cursor y limit. Cada elemento incluye reason, source (panel, API o automática), messageId si lo originó un email, note, createdAt y expiresAt.

La dirección va en la query y no en la ruta. Ten en cuenta que puede quedar en los registros de tu propio proxy.

Añadir una dirección

Con scope full:

bash
curl -X POST https://api.vemudo.com/v1/suppressions \
  -H "Authorization: Bearer $VEMUDO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "email": "[email protected]", "reason": "unsubscribe", "note": "Baja pedida por teléfono" }'
  • reason: unsubscribe (por defecto con claves live) o manual. Con una clave test solo se admite manual y unsubscribe devuelve 403 live_key_required.
  • Responde 201 si la añade y 200 si ya estaba bloqueada.
  • Máximo 1.000 altas por hora y organización.
  • La lista es única para la organización: lo que añadas con una clave test también afecta a los envíos live.

Quitar una dirección

bash
curl -X DELETE https://api.vemudo.com/v1/suppressions/$ID \
  -H "Authorization: Bearer $VEMUDO_API_KEY"
  • Solo con clave live y scope full (403 live_key_required con test).
  • Las bajas (unsubscribe) y las quejas (complaint) no se pueden quitar por API (403 suppression_removal_forbidden); un administrador debe hacerlo desde el panel. Protege a las personas que pidieron no recibir más correos.
  • Máximo 50 por hora y organización.
  • Si una dirección con rebotes temporales vuelve a rebotar, se bloqueará de nuevo.

Bajas en campañas

Cada email de campaña lleva un enlace de baja y una página de preferencias, y las cabeceras List-Unsubscribe de baja con un clic, de modo que los clientes de correo compatibles muestran su propio botón de baja. La baja de un contacto se refleja en su ficha (estado «dado de baja») y se respeta en cualquier campaña posterior. Se explica en Campañas e informe.

Estados de un contacto

En contactos, el estado público se deriva de la ficha y de la lista de bloqueos: subscribed, unsubscribed, bounced, complained o blocked. Solo los contactos suscritos y sin bloqueo activo entran en el público de una campaña.