Enviar correos electrónicos personalizados de WooCommerce

Custom WooCommerce emails envía una notificación adicional para eventos seleccionados de pedidos, cuentas o reservas. Úsala cuando un mensaje estándar de WooCommerce necesite un mensaje complementario independiente con su propio contenido, destinatarios, reglas de categoría o archivos adjuntos. Las notificaciones estándar de WooCommerce siguen siendo independientes.

Necesitas WooCommerce y permiso para administrar los ajustes de POM Tweaks. La confirmación de reservas también requiere WooCommerce Bookings y una reserva vinculada a un pedido.

Configurar una notificación

  1. Abre Settings → POM Tweaks → E-Commerce → Emails.
  2. Activa Custom WooCommerce emails y guarda si la configuración aún no está visible.
  3. En Custom notifications, selecciona Add new y elige When to send. Usa una fila por evento: si varias filas usan el mismo evento, solo se aplica la primera, incluso cuando está desactivada.
  4. Introduce una Internal label y selecciona Enable this notification.
  5. Para pedidos nuevos, cancelados o fallidos, introduce Recipients for administrator events como direcciones de correo separadas por comas. Si se deja vacío, se usa la dirección del administrador del sitio. Todos los demás eventos usan el correo de facturación del pedido o la dirección de correo de la cuenta.
  6. Introduce Subject, Email heading y Email body. El cuerpo acepta HTML seguro y las etiquetas de combinación que se indican más abajo, dentro de la cabecera y el pie estándar del correo de WooCommerce. Un asunto vacío usa un valor predeterminado del evento; un encabezado vacío permanece vacío.
  7. Opcionalmente, elige Product categories. Al menos un artículo del pedido debe pertenecer a una categoría seleccionada. Si se deja vacío, se admiten todos los pedidos; las reglas de categoría no se aplican a la creación de cuentas ni al restablecimiento de contraseñas.
  8. Usa Choose attachments para seleccionar archivos de la biblioteca de medios, incluidos los PDF. También puedes editar los ID separados por comas en Attachments. Solo se adjuntan archivos locales legibles del directorio de cargas del sitio. Los archivos que faltan o que se han descargado de forma remota se omiten.
  9. Elige Email format: HTML, Plain text o HTML and plain text. El texto plano se obtiene a partir del cuerpo y conserva los destinos de los enlaces.
  10. Selecciona Save y verifica el evento correspondiente usando un cliente y un pedido de prueba.

Las entradas de WooCommerce → Settings → Emails conservan su identidad de correo personalizado y enlazan de vuelta a POM Tweaks para su configuración. Edita estas notificaciones en POM Tweaks.

Eventos compatibles

Evento Desencadenante
New order Los pedidos pendientes, fallidos o cancelados pasan a estar en procesamiento, completados o en espera.
Cancelled order Los pedidos en procesamiento, en espera o pendientes pasan a estar cancelados.
Failed order Los pedidos pendientes o en espera pasan a estar fallidos.
Order on-hold Los pedidos pendientes, fallidos o cancelados pasan a estar en espera.
Processing order Los pedidos pendientes, en espera, fallidos o cancelados pasan a estar en procesamiento.
Completed order Un pedido pasa a estar completado.
Refunded order Se genera una notificación de reembolso total o parcial.
Customer invoice / Order details WooCommerce entrega correctamente su mensaje nativo de factura/detalles del pedido al transporte de correo, incluidos los reenvíos manuales. No se ejecuta en eventos de reembolso.
Customer note Se añade una nota dirigida al cliente a un pedido.
Reset password WooCommerce genera una notificación de restablecimiento de contraseña con su clave de restablecimiento existente.
New account WooCommerce genera su notificación de cliente creado.
Booking confirmed WooCommerce Bookings genera una notificación de confirmación para una reserva con un pedido.

Se trata de notificaciones de eventos, no de una programación ni de un historial de mensajes ya entregados. Repetir deliberadamente un evento puede enviar otro mensaje. El éxito del transporte no garantiza la entrega en la bandeja de entrada.

Etiquetas de combinación existentes

Todas las etiquetas de combinación originales siguen siendo compatibles. Usa las etiquetas literalmente, incluidas las llaves dobles. Las etiquetas de pedido están vacías cuando un evento de cuenta no tiene pedido. Las etiquetas de producto van dentro de un bloque de artículo.

Etiqueta Valor
{{blogname}} Nombre del sitio.
{{order_number}} Número de pedido mostrado, incluida la numeración personalizada.
{{order_date}} Fecha de creación del pedido en el formato de fecha de la tienda.
{{customer_details}} Detalles de cliente y dirección de WooCommerce para este correo.
{{order_meta}} Detalles proporcionados por el gancho de metadatos del pedido del correo de WooCommerce.
{{order_meta_field="key"}} El valor de metadatos del pedido especificado; admite HPOS.
{{order_product}}…{{/order_product}} Repite el marcado encerrado una vez por cada línea de producto del pedido. Se admiten varios bloques independientes.
{{product_name}} Título del producto actual, con alternativa al nombre guardado de la línea del pedido si el producto se eliminó.
{{product_price}} Precio del producto actual, como en la función original; los productos eliminados recurren al total guardado de la línea dividido por la cantidad. Usa {{line_total}} para el total real de la línea del pedido.
{{product_description}} Descripción del producto actual como HTML seguro.
{{product_stock}} Cantidad de existencias actual, o vacío cuando no está disponible.
{{product_sku}} SKU del producto o variación actual.
{{product_quantity}} Cantidad guardada en la línea del pedido.
{{product_meta_field="key"}} Metadatos del producto principal, incluido cuando el artículo comprado es una variación.
{{order_item_meta_field="key"}} Metadatos guardados en esta línea de pedido específica.

Los metadatos escalares se insertan como texto escapado; los metadatos estructurados se representan como JSON. Usa comillas dobles o simples alrededor de las claves de metadatos. Las apariciones repetidas de la misma etiqueta reciben el mismo valor dentro de ese artículo. Las etiquetas desconocidas permanecen sin cambios para que sean visibles durante la revisión.

<p>Thank you for order {{order_number}}.</p>
{{order_product}}
<p>{{product_name}} × {{product_quantity}} — {{line_total}}</p>
{{/order_product}}
{{customer_details}}

Etiquetas de combinación adicionales

Etiquetas Contexto
{{order_id}}, {{order_total}}, {{order_currency}} ID interno del pedido, total del pedido sin formato y código de moneda.
{{customer_name}}, {{customer_email}} Detalles de facturación del pedido o detalles de la cuenta.
{{customer_note}} Nota proporcionada con una notificación de nota de cliente.
{{refund_amount}} Importe del reembolso que desencadenó la notificación.
{{booking_id}} Referencia de confirmación de la reserva.
{{user_login}} Nombre de usuario para las notificaciones de cuenta.
{{account_url}} URL de la página Mi cuenta.
{{reset_password_url}} URL de recuperación que usa la clave proporcionada por WooCommerce, disponible solo durante las notificaciones de restablecimiento de contraseña.
{{product_id}}, {{product_url}}, {{line_total}} Dentro de un bloque de artículo: ID de producto/variación, URL del producto actual y total guardado de la línea después de descuentos, sin impuestos.

Los asuntos y los encabezados admiten etiquetas de combinación textuales. Mantén los bucles de artículos y los detalles de cliente con formato en el cuerpo del correo. Para un mensaje de restablecimiento de contraseña, incluye un enlace como <a href="{{reset_password_url}}">Choose a new password</a>. Los correos de cuenta nueva pueden usar {{account_url}}; no crean una segunda clave de restablecimiento de contraseña ni invalidan el enlace de bienvenida de WooCommerce.

Verificar y solucionar problemas

  • Comprueba el destinatario, el asunto, el encabezado, todos los bloques de artículos, los archivos adjuntos y los enlaces de cada evento activado. Incluye un pedido con varios productos y un segundo pedido para verificar su contenido de forma independiente.
  • Verifica el propio evento. Un correo de pedido completado no se activa al reenviar una factura, y un complemento de factura requiere que el transporte nativo de facturas informe de éxito.
  • Si no aparece ningún mensaje adicional, comprueba ambos interruptores de activación, la primera fila de ese evento, las coincidencias de categoría y el correo del cliente. Los eventos de cuenta no aceptan anulaciones de destinatario de administrador.
  • Si una etiqueta de combinación permanece visible, comprueba su escritura y su contexto. La vista previa de diseño de WooCommerce usa datos de ejemplo; los valores de cuenta, nota, reembolso y reserva requieren su evento real para verificarse por completo.
  • Si falta un archivo adjunto, confirma su ID de la biblioteca de medios y que su archivo esté disponible localmente. Seleccionar una URL de medios o un archivo fuera de las cargas no lo adjunta.
  • Comprueba el proveedor de entrega de correo de tu sitio si los mensajes se generan pero no llegan. Esta función usa el transporte de correo de WooCommerce y no configura SMTP.

Desactiva una fila para detener ese evento, o desactiva Custom WooCommerce emails para detener todas sus notificaciones adicionales. Los pedidos existentes y las notificaciones estándar de WooCommerce siguen estando disponibles.