Documentación / Escribe mensajes útiles para tus clientes

Min/Max · Desarrollo 0.12.0 · Actualizado el 13 de septiembre de 2026

Escribe mensajes útiles para tus clientes

Explica al cliente qué debe cambiar. Haz visible la restricción real de la regla, sobre todo cuando reutilices el mismo texto para muchos productos.

Configura los mensajes predeterminados

  1. Abre HookSpark → Min/Max → Messages («Mensajes»).
  2. Escribe el mensaje de cantidad en Quantity errors («Errores de cantidad») y el de importe en Amount errors («Errores de importe»).
  3. Despliega el selector de variables para insertar una variable compatible en la posición del cursor.
  4. Selecciona Vista previa con valores de ejemplo. Lee tanto los valores ficticios de entrada como el mensaje generado.
  5. Guarda los mensajes. La vista previa nunca guarda el texto por sí sola.

Un ejemplo de mensaje de cantidad seguro y reutilizable es Please review your quantity. {default}. Así, la explicación predeterminada se ajusta al incumplimiento concreto.

Mensaje personalizado que contiene la variable default y el ejemplo generado
Vista previa de un mensaje sin guardar: {default} inserta la explicación predeterminada. La vista previa utiliza valores ficticios. Haz clic para ampliar.

Personaliza el mensaje de una regla

Abre la regla y despliega Customer message («Mensaje para el cliente»). Introduce el mensaje específico y guarda la regla. La prioridad es: mensaje de la regla, si no está vacío → mensaje global de esa métrica → explicación predeterminada. Deja vacío el texto de la regla para heredar el global. Deja ambos vacíos para utilizar el texto predeterminado traducido.

Referencia de variables

VariableSignificado y disponibilidad
{product}Nombre del producto en contextos de producto individual; no está disponible para un total agregado sin producto.
{rule}, {group}Nombre de la regla. En esta versión, ambas variables devuelven el nombre de la regla.
{minimum}, {maximum}Umbral configurado; no está disponible si ese umbral está vacío.
{multiple}Múltiplo del lote, si está configurado. No está disponible en las reglas de importe.
{current}Cantidad o importe actual que se tiene en cuenta.
{missing}Lo que falta para alcanzar el mínimo, nunca por debajo de cero. No indica el siguiente tamaño de lote válido.
{currency}Código de moneda guardado para las reglas de importe; no está disponible en los mensajes de cantidad.
{default}Explicación predeterminada completa del incumplimiento.

Ejemplos y límites

Para una regla de importe mínimo: Minimum spend: {minimum} {currency}. Current: {current} {currency}. {default}. Con un mínimo de 100 y un importe actual de 80 EUR, el umbral y el importe actual se muestran a partir de esos valores.

Si una regla de cantidad tiene un mínimo de 6 y un múltiplo de 6, una cantidad actual de 7 tiene {missing} igual a 0, pero sigue siendo inválida. No indiques a todos los clientes «añade {missing}» como solución universal.

Las plantillas son texto sin formato, de un máximo de 2000 bytes. No admiten PHP ni HTML arbitrario. Se rechazan las variables desconocidas y las llaves mal cerradas. Si una variable documentada no está disponible en un contexto concreto, todo el mensaje se sustituye por la explicación predeterminada en lugar de mostrar un marcador vacío.

Comprueba y traduce

Prueba un carrito que incumpla realmente la regla y corrígelo después. El error anterior debería desaparecer. Las vistas previas globales utilizan valores ficticios, no el carrito real. Los mensajes personalizados guardados son contenido tuyo: tradúcelos por separado. Cambiar el idioma de WordPress no traduce automáticamente lo que has escrito.

Si otra sesión ha guardado antes los mensajes, revisa el texto guardado y el borrador que conservas antes de volver a enviarlo. No sigas enviando un editor desactualizado.

Vista previa de la captura