Cancelar mensajes
Opcionalmente, puedes usar la etiqueta de mensaje Liquid
abort_message("optional reason for aborting")dentro de condicionales para evitar el envío de un mensaje a un usuario. Este artículo de referencia enumera algunos ejemplos de cómo se puede usar esta característica en campañas de marketing.

Si un paso de mensaje se cancela en un Canvas, el usuario no saldrá del Canvas y sí avanzará al siguiente paso.
Envíos de prueba con abort_message()
abort_message() detiene el envío para los usuarios que no cumplen tu condición. El mensaje no aparecerá en su perfil y no contará para las entregas ni para la limitación de frecuencia.
Si los envíos de prueba nunca llegan, previsualiza como un usuario que satisface la condición de abort, luego en Test Send habilita Override recipients’ attributes with current preview user’s attributes (o añade un miembro de un grupo de prueba de contenido que califique).
Anular mensaje si “Number Games Attended” = 0
Por ejemplo, supongamos que no quieres enviar un mensaje a clientes que no hayan asistido a un partido:
{% if custom_attribute.${Number_Game_Attended} == 1 %}
Loved the game? Get 10% off your second one with code SAVE10.
{% elsif custom_attribute.${Number_Game Attended} > 1 %}
Love the games? Get 10% off your next one with code SAVE10.
{% else %}
{% abort_message() %}
{% endif %}
Este mensaje solo se enviará a clientes que se sabe que han asistido a un partido.
Enviar mensajes solo a clientes que hablan inglés
Puedes enviar mensajes solo a clientes que hablan inglés creando una sentencia “if” que coincida cuando el idioma de un cliente sea inglés y una sentencia “else” que cancele el mensaje para cualquier persona que no hable inglés o que no tenga un idioma en su perfil.
{% if ${language} == 'en' %}
Send this message in English!
{% else %}
{% abort_message() %}
{% endif %}
De forma predeterminada, el envío cancelado aparece en Observabilidad de mensajería con el resultado Liquid abort.
Puedes incluir una cadena de motivo dentro de los paréntesis:
{% abort_message('language was nil') %}
Consulta de mensajes de cancelación
Puedes usar el generador de consultas o tu propio almacén de datos, si está conectado a Braze, para consultar mensajes de cancelación específicos que se activan cuando la lógica de Liquid provoca que un mensaje se cancele.
Cuándo se evalúa la lógica de cancelación
El momento en que se evalúa la lógica de cancelación depende del canal del mensaje.
Push, correo electrónico, SMS, webhooks y Content Cards
La lógica de cancelación se evalúa en el momento del envío, cuando Braze procesa el mensaje para su entrega.
In-App Messages
La lógica de cancelación se evalúa para mensajes dentro de la aplicación con plantilla solo en el momento en que se activa el mensaje dentro de la aplicación (por ejemplo, cuando el usuario realiza el evento desencadenante o inicia una sesión), no cuando el mensaje se envía inicialmente al dispositivo. Los mensajes dentro de la aplicación se entregan al SDK al inicio de la sesión y se almacenan en caché de forma local; el Liquid, incluidas las llamadas a abort_message(), se ejecuta cuando se cumple la condición de activación.
Solución de problemas de altas tasas de cancelación
Si una Campaign o un paso en Canvas muestra que muchos usuarios ingresaron pero se realizaron pocos envíos, o las entregas parecen más bajas de lo esperado, la lógica de cancelación es una causa común, especialmente cuando Liquid requiere atributos, datos del catálogo o valores de lista que faltan en el momento de la evaluación.
Consulta la Observabilidad de mensajería
- Abre Observabilidad de mensajería.
- Selecciona la Campaign o el Canvas, y luego selecciona Run Dashboard.
- En el registro granular, filtra por el resultado Liquid abort.
- Observa si las cancelaciones se concentran en un canal (como solo correo electrónico) o en varios canales dentro del mismo Canvas.
Verifica los atributos y Liquid en el momento del envío
Para push, correo electrónico, SMS, webhooks y Content Cards, la lógica de cancelación se ejecuta cuando Braze procesa el mensaje para la entrega, no cuando el usuario ingresó a un Canvas o cuando un evento desencadenante se activó anteriormente.
- Confirma que los atributos personalizados, las propiedades del evento o los campos del catálogo requeridos estén configurados en el usuario antes de que se ejecute el paso de mensaje.
- Agrega comprobaciones explícitas de nil o vacío antes de llamar a
abort_message(). Una ramaelseque cancela cuando falta un valor detiene el envío para cualquier usuario que no tenga esos datos. - Si la personalización depende de una lista, un Segment o una respuesta de contenido conectado, confirma que los datos estén disponibles cuando se ejecuta el paso de mensaje. Un usuario puede ingresar a un Canvas antes de que la membresía a la lista o los datos posteriores estén listos.
Comportamiento específico de Canvas
Si un paso de mensaje se cancela en un Canvas, el usuario no sale del Canvas. En su lugar, avanza al siguiente paso. Las cancelaciones solo afectan el conteo de envíos de ese paso de mensaje.
En un paso de contexto, abort_message afecta solo a la variable que lo llama: esa variable no se establece, las demás variables del paso sí se establecen, y el usuario avanza al siguiente paso. Las cancelaciones del paso de contexto no se registran en el registro de actividad de mensajes. Para más detalles, consulta Contexto.
Al diagnosticar cancelaciones en Canvas:
- Compara los usuarios que ingresaron en el paso de mensaje con los usuarios que recibieron envíos en el mismo paso.
- Si solo un canal se cancela, revisa el Liquid específico del canal o el estado de suscripción para ese paso.
- Si las cancelaciones aumentan después de una actualización de lista o catálogo, verifica si el paso de mensaje se ejecutó antes de que la actualización se completara.
Valida con vista previa y envíos de prueba
Previsualiza como un usuario en el creador de mensajes cuyo perfil coincida con un destinatario afectado. Para envíos de prueba, habilita Override recipients’ attributes with current preview user’s attributes cuando tu lógica de cancelación dependa de los datos del perfil.
Para más ejemplos de cancelación, consulta Consultar mensajes cancelados.
Consideraciones
La etiqueta de mensaje Liquid abort_message() evita que los mensajes se envíen a los usuarios, lo que significa que el mensaje no se mostrará en los perfiles de usuario y no contará para las entregas ni para la limitación de frecuencia.