Guías de integración
Plantillas y spintax
NoteConfirm incluye siete plantillas predefinidas de pedido que cubren su ciclo completo. Cada plantilla admite variables de Shopify y sintaxis spintax para variar el contenido y mantener la voz de tu marca.
Los checkouts abandonados tienen tres plantillas adicionales: primer mensaje, segundo mensaje y mensaje final. Usan variables de checkout y la configuración de la secuencia de recuperación. Consulta Recuperación de checkouts abandonados para la configuración, las variables y las imágenes opcionales.
Plantillas disponibles
| Plantilla | Evento disparador | Ventana de respuesta |
|---|---|---|
| Pedido prepago | Pedido creado con pago confirmado | Configurable (default 24h) |
| Contra entrega | Pedido creado sin pago | Configurable (default 24h) |
| Enviado | Fulfillment creado | No aplica |
| Entregado | Fulfillment entregado | No aplica |
| Cancelado | Pedido cancelado | No aplica |
| Reembolso | Reembolso procesado | No aplica |
| Agradecimiento | Cliente confirma pedido | No aplica |
Ventana de respuesta: Solo las plantillas de confirmación (prepago y contra entrega) tienen ventana configurable. Define cuánto espera NoteConfirm antes de marcar el pedido como pendiente. Las demás se envían al ocurrir el evento.
Variables disponibles
Usa estos marcadores en cualquier plantilla. Se reemplazan automáticamente con los datos del pedido de Shopify.
| Variable | Descripción | Ejemplo |
|---|---|---|
{{order_number}} | Número del pedido | #1048 |
{{customer_name}} | Nombre del cliente | Ana García |
{{total_price}} | Total del pedido con moneda | $184.000 COP |
{{item_count}} | Cantidad de artículos | 3 |
{{shipping_address}} | Dirección completa de envío | Calle 93 #14-28, Bogotá |
{{shop_name}} | Nombre de la tienda | Mi Tienda Online |
{{tracking_url}} | URL de seguimiento del envío | https://... |
Sintaxis spintax
Spintax permite variar partes del mensaje para que no siempre sea idéntico. Usa llaves y barras para definir variantes:
Cada vez que se envía un mensaje, NoteConfirm elige una variante al azar. Esto reduce patrones repetitivos que pueden activar filtros anti-spam.
- Define al menos 2 variantes por bloque spintax
Un solo bloque con una variante no tiene efecto y genera advertencia en el editor.
- No anides spintax dentro de spintax
La anidación no está soportada y puede producir texto malformado.
- Prueba con el preview antes de guardar
El editor muestra una vista previa con variables sustituidas y una variante aleatoria seleccionada.
Lints de negocio
El editor de plantillas valida reglas que protegen la efectividad de tus confirmaciones:
- Sin links en primer mensaje de confirmación: Los enlaces en el primer contacto aumentan el riesgo de bloqueo. Usa links solo en plantillas de ciclo de vida (enviado, entregado).
- Personalización obligatoria: Toda plantilla de confirmación debe incluir al menos una variable (como
{{customer_name}}o{{order_number}}). - Límite de 500 caracteres: Mensajes muy largos se cortan en dispositivos móviles y reducen la tasa de respuesta.
- Uso excesivo de mayúsculas: Más del 30% del texto en mayúsculas genera advertencia por tono agresivo.
Ver también
- Protección del número: límites adaptativos, calentamiento gradual y horario silencioso para proteger tu número de WhatsApp.
- Recuperación de checkouts: una secuencia de WhatsApp con un resumen del carrito y un enlace para retomar el pago.