Notificar a clientes sobre una actualización de producto

Qué hace Notificar a clientes

Notificar a clientes envía un email a cada comprador anterior de un producto, con un botón que abre la descarga propia de ese comprador con los archivos más recientes. Se inicia desde la página del producto en el panel de Alva: abre el producto, haz clic en Notificar a clientes, elige quién lo recibe, añade una nota opcional, revisa la vista previa y envía.

El email es un aviso fijo de actualización de producto en el idioma de tu tienda, no un email de marketing. Sale por un flujo de envío separado del de tus emails de entrega, con el seguimiento de aperturas y clics desactivado para que el enlace de descarga nunca se reescriba. Cualquier persona que se haya dado de baja o haya marcado un email anterior como spam se omite automáticamente.

Quién recibe el email

Cada cliente que compró una de las variantes seleccionadas y sigue aceptando recibir emails recibe exactamente un mensaje. Si las variantes de un producto entregan archivos distintos, la ventana modal muestra una casilla por cada conjunto de archivos, etiquetada con las variantes a las que sirve; todas están seleccionadas por defecto. Quien compró varias variantes seleccionadas recibe un solo email.

Ese único email enlaza con la compra más reciente del comprador entre las variantes seleccionadas. La otra variante sigue accesible a través de su enlace de descarga original y de la página de estado del pedido. El número de destinatarios se actualiza al cambiar la selección, y debajo se muestra cuántos compradores se han dado de baja — a ellos no se les puede llegar desde aquí.

Las compras cuyo acceso a la descarga está desactivado, o que no han superado tu comprobación antifraude, quedan fuera. Los productos personalizados no tienen un archivo compartido que reenviar, así que no muestran el botón, y un producto cuyas asignaciones no contienen archivos, packs ni enlaces no se puede notificar.

Qué dice el email

El email es una plantilla bloqueada: el asunto, el saludo, la línea de introducción, el botón Descargar archivos y el pie son fijos y están traducidos al idioma de tu tienda. Lo único que puedes añadir es una nota de texto sin formato de hasta 2.000 caracteres, que aparece como “Una nota de {tu tienda}:” entre la línea de introducción y el botón. Los compradores ven, en este orden:

• Asunto: Actualización de tu compra de {título del producto}
• Hola {nombre},
• {Nombre de la tienda} ha actualizado tu compra de {título del producto}. Haz clic abajo para descargar la última versión.
• Una nota de {nombre de la tienda}: seguido de tu nota — solo si añadiste una
• El botón Descargar archivos, que abre la página de descarga propia del comprador
• Un pie con el nombre de tu tienda y un enlace para darse de baja

Añade una nota

Escribe la nota en el campo Añadir una nota (opcional). Solo texto sin formato: no se permiten enlaces ni direcciones de email — incluidas las direcciones web, www. y los nombres de dominio sueltos — y el campo los rechaza antes de que puedas enviar, de modo que el botón Descargar archivos sigue siendo el único enlace del email. No incluyas descuentos ni promociones en la nota: este email es una actualización de producto, no marketing.

Variables que puedes usar en la nota

Tres botones bajo el campo insertan las tres primeras variables; un menú Metacampo del producto lista los metacampos del producto para la cuarta:

• {customer.first_name} — el nombre del comprador, con un valor neutro cuando se desconoce. Queda mejor al principio de una línea.
• {shop.name} — el nombre de tu tienda.
• {product.title} — el título del producto, como en el asunto.
• {product.metafields.<namespace>.<key>} — el valor de uno de los metacampos de Shopify del producto, por ejemplo {product.metafields.custom.edition}. Una nota puede usar hasta cinco metacampos distintos. El menú lista los primeros 50 metacampos del producto con sus valores actuales.

Los tipos de metacampo admitidos son texto de una y varias líneas, números enteros y decimales, fechas (escritas en el idioma de tu tienda) y listas de texto. Un metacampo de otro tipo — un enlace, un valor verdadero/falso, una referencia, texto enriquecido o un archivo — no se puede mostrar en un email, así que la nota se rechaza con un error en línea hasta que lo quites. Lo mismo ocurre con un metacampo sin valor en este producto, con una variable que Alva no conoce, con una llave sin cerrar y con un enlace dentro del valor de un metacampo.

Vista previa antes de enviar

La Vista previa del email bajo la nota muestra el asunto y el cuerpo exactamente como los verá un comprador, en el idioma de tu tienda, con la nota y sus variables rellenadas con los valores reales del producto. La vista previa y el email enviado los genera el mismo código, así que lo que ves es lo que sale. Si un metacampo cambia mientras la ventana modal está abierta, la vista previa se actualiza y te pide que la revises de nuevo.

Productos ZIP: el email espera al archivo

Si un producto entrega un archivo ZIP y acabas de reemplazar sus archivos, el envío espera hasta que Alva haya terminado de regenerar el archivo ZIP, para que ningún comprador descargue la versión antigua. Hasta entonces, el historial de notificaciones muestra “Esperando a que termine de generarse el archivo ZIP antes de enviar.”; el envío sigue en cola y todavía se puede cancelar.

Si la regeneración falla, el envío falla con el motivo “No se pudo generar el archivo ZIP de este producto, así que no se envió nada.” Corrige los archivos — reemplazarlos inicia una nueva regeneración — y vuelve a notificar. Si el archivo ZIP sigue regenerándose después de una hora, el envío también falla, indicándolo, y puedes volver a notificar cuando la regeneración haya terminado. En ambos casos no se envió nada, así que el límite de 7 días no se consume.

Los productos que entregan archivos individuales o enlaces no tienen archivo ZIP y nunca quedan retenidos.

El historial de notificaciones

Debajo de la tarjeta de Ajustes del producto, Historial de notificaciones lista los últimos diez envíos del producto: la fecha, el número de destinatarios, cuántos emails se enviaron, fallaron, se suprimieron o recibieron una queja, quién lo envió y su estado — En cola, Enviando, Completado, Parcial, Fallido o Cancelado. Una insignia indica de dónde procede: Admin, API o Actualización de asignación (API).

Cada fila muestra también cuántas variantes abarcó y las primeras líneas de su nota. Una fila Fallido explica el motivo con palabras: los emails a clientes estaban desactivados, así que no se envió nada; la nota guardada no se pudo renderizar; la nota contenía un enlace; el archivo ZIP seguía regenerándose después de una hora; no se pudo generar el archivo ZIP; o el envío se interrumpió por un reinicio del servidor. Parcial significa que algunos emails fallaron o se suprimieron — los recuentos indican cuántos.

A través de la API

Todo lo que hace el botón también está disponible a través de la API externa de Alva, para las tiendas cuyo propio sistema actualiza sus archivos. POST /api/v1/products/{id}/notifications pone en cola una campaña para un producto; envía "dry_run": true para ejecutar las mismas comprobaciones y obtener el número de destinatarios, el asunto y la nota renderizada sin enviar nada. GET /api/v1/notifications/{id} lee el resultado.

POST /api/v1/notifications/{id}/cancel detiene una campaña que sigue en cola; como la cancelación desde el panel, mantiene el límite de 7 días del producto. Si tu sistema ya crea o reemplaza asignaciones a través de la API, añade notify_customers a POST /api/v1/mappings o PUT /api/v1/mappings/{id} y los compradores de esa asignación reciben la notificación cuando los nuevos archivos están en su sitio — la espera del archivo ZIP también se aplica ahí. El límite se comparte con el botón: dentro de la semana, la API responde 429 notification_cooldown con la hora a la que el producto queda libre de nuevo, así que programa la siguiente llamada para ese momento en lugar de reintentar. Los cuerpos de las solicitudes, los códigos de error y las reglas de idempotencia están en la referencia de la API.