Saltar al contenido principal
— Tutorial de configuración

Sigue el estado de entrega del email

Alva Digital Downloads registra cada email de entrega que envía en la tabla EmailLog y lo expone en la página de detalle del pedido en el admin. Cada entrada guarda el asunto, el destinatario, la marca de tiempo de envío y la respuesta del proveedor — el ID de mensaje de Postmark cuando hay éxito, o un código de error cuando el envío falla.

Dónde ver el estado de entrega

El registro de email vive en cada pedido, no como un feed global. Abre el pedido para ver cada email que Alva intentó enviar.

1. Abre el pedido en el admin de Alva

En el admin de Alva, haz clic en Pedidos y luego en el número de pedido que quieres inspeccionar.

2. Baja a la sección Historial de email

Debajo de las tarjetas de cliente y producto, busca la tarjeta Historial de email. La insignia de la derecha muestra el total, p. ej. 2 emails enviados.

Captura de pantalla necesaria

Página de detalle del pedido con la tarjeta Historial de email visible. Muestra el encabezado de la sección, la insignia de conteo y la flecha para expandir. Sin datos reales de clientes visibles.

La tarjeta Historial de email en la página de detalle del pedido.

3. Expande para ver cada entrada

Haz clic en la flecha de la tarjeta. Cada fila muestra la marca de tiempo de envío, el destinatario, la insignia de estado (verde para éxito, rojo para fallo, ámbar para pendiente o rebotado) y el tipo de email — Enlace de descarga, Reenvío manual o Entrega de clave de licencia.

4. Inspecciona la respuesta del proveedor

El ID de mensaje de Postmark, el código de error y el mensaje de error se guardan en metadata en la fila del registro — reenvía esos valores a soporte si hay que investigar un envío.

Captura de pantalla necesaria

Una única fila de registro de email expandida, mostrando marca de tiempo, destinatario, insignia de estado, insignia de tipo y el bloque de metadatos con el ID de mensaje del proveedor. Sin datos reales de clientes visibles.

Una fila de registro expandida mostrando la respuesta de Postmark.

Qué significan los valores de estado

  • SUCCESS — Postmark aceptó el email y va de camino a la bandeja del destinatario. Es el estado terminal normal.
  • PENDING — Alva creó la fila del registro pero aún espera respuesta del proveedor, o hay un reintento de respaldo en curso.
  • BOUNCED — Postmark rechazó al destinatario. Cubre rebotes duros y aciertos en lista de supresión (error de Postmark 406 InactiveRecipientsError). Alva no reintenta estos.
  • FAILED — ocurrió un error no recuperable (fallo de red, 5xx del proveedor o una excepción interna en email.ts). El mensaje de error queda capturado en los metadatos.
  • COMPLAINT — el destinatario marcó el mensaje como spam tras la entrega.

Reenviar emails fallidos

Si una fila muestra FAILED tras un problema transitorio del proveedor, dispara un envío nuevo desde la misma página de pedido — el tutorial Reenvía un email de descarga a un cliente cubre los pasos. Las filas BOUNCED suelen necesitar una dirección de email corregida antes de que reenviar ayude.

¿Por qué mi email no aparece en el registro?

Si Shop.isEmailEnabled está desactivado, Alva omite el envío por completo y no escribe entrada en el registro. Los envíos con dominio personalizado también se omiten si el plan de pago que aprovisionó el dominio ha caducado, ya que getFromEmail() bloquea el envío cuando la comprobación de suscripción falla. Reactiva el email en Ajustes → Email, o restablece el plan, y luego reenvía.

Preguntas frecuentes

¿Cuánto tiempo guarda Alva Digital Downloads los registros de email?

Los registros de email se conservan indefinidamente en el pedido. Las compras realizadas antes del 20 de septiembre de 2025 son anteriores al registro de email y no muestran entradas.

¿El registro se actualiza cuando un cliente abre o hace clic en el email?

No. El registro recoge solo el resultado del envío. Los eventos de apertura y clic no se rastrean, así que un estado SUCCESS confirma la entrega al proveedor de bandeja pero no que el cliente haya leído el email.

¿Por qué el registro muestra dos entradas para un solo pedido?

Cada envío crea su propia entrada. Un reenvío manual, un reenvío disparado por Flow o un fallback al proveedor de respaldo añaden cada uno una fila nueva para que puedas auditar cada intento por separado.

Ver también

¿Te ha resultado útil?

¿Sigues atascado? Escríbenos.

Última actualización 2026-05-06