Pular para o conteúdo principal
— Passo a passo de configuração

Acompanhe o status de entrega do e-mail

O Alva Digital Downloads registra todo e-mail de entrega que envia na tabela EmailLog e o exibe na página de detalhes do pedido no admin. Cada entrada registra o assunto, o destinatário, o timestamp de envio e a resposta do provedor — ID da mensagem do Postmark em caso de sucesso ou um código de erro quando um envio falha.

Onde ver o status de entrega

O log de e-mail fica em cada pedido, não como um feed global. Abra o pedido para ver todo e-mail que o Alva tentou enviar.

1. Abra o pedido no admin do Alva

No admin do Alva, clique em Pedidos, depois clique no número do pedido que você quer inspecionar.

2. Role até a seção Histórico de e-mail

Abaixo dos cards de cliente e produto, encontre o card Histórico de e-mail. O selo à direita mostra a contagem total, por exemplo 2 e-mails enviados.

Captura de tela necessária

Página de detalhes do pedido com o card Histórico de e-mail visível. Mostre o título da seção, o selo de contagem e o chevron para expandir. Sem dados reais de cliente visíveis.

O card Histórico de e-mail na página de detalhes do pedido.

3. Expanda para ver cada entrada

Clique no chevron do card. Cada linha mostra o timestamp de envio, o destinatário, o selo de status (verde para sucesso, vermelho para falha, âmbar para pendente ou retornado) e o tipo de e-mail — Link de download, Reenvio manual ou Entrega de chave de licença.

4. Inspecione a resposta do provedor

O ID da mensagem do Postmark, o código de erro e a mensagem de erro são armazenados em metadata na linha do log — encaminhe esses valores ao suporte se um envio precisar ser investigado.

Captura de tela necessária

Uma única linha de log de e-mail expandida, mostrando timestamp, destinatário, selo de status, selo de tipo e o bloco de metadados com o ID da mensagem do provedor. Sem dados reais de cliente visíveis.

Uma linha de log expandida mostrando a resposta do Postmark.

O que os valores de status significam

  • SUCCESS — o Postmark aceitou o e-mail e ele está a caminho da caixa de entrada do destinatário. Esse é o estado terminal normal.
  • PENDING — o Alva criou a linha do log mas ainda aguarda uma resposta do provedor, ou uma nova tentativa de fallback está em andamento.
  • BOUNCED — o Postmark rejeitou o destinatário. Cobre rejeições permanentes e correspondências em lista de supressão (erro Postmark 406 InactiveRecipientsError). O Alva não tenta novamente.
  • FAILED — ocorreu um erro não recuperável (falha de rede, 5xx do provedor ou exceção interna em email.ts). A mensagem de erro é capturada nos metadados.
  • COMPLAINT — o destinatário marcou a mensagem como spam após a entrega.

Reenviar e-mails que falharam

Se uma linha mostrar FAILED após um problema transitório do provedor, dispare um novo envio pela mesma página de pedido — o passo a passo Reenvie um e-mail de download para um cliente cobre os passos. Linhas BOUNCED normalmente precisam de um endereço de e-mail corrigido antes de o reenvio ajudar.

Por que meu e-mail não está no log?

Se Shop.isEmailEnabled estiver desligado, o Alva ignora o envio inteiramente e não escreve nenhuma entrada de log. Envios de domínio personalizado também são ignorados se o plano pago que provisionou o domínio caducou, já que getFromEmail() bloqueia o envio quando a checagem de assinatura falha. Reative o e-mail em Configurações → E-mail, ou restaure o plano, depois reenvie.

FAQ

Por quanto tempo o Alva Digital Downloads mantém logs de e-mail?

Logs de e-mail são retidos indefinidamente no pedido. Compras feitas antes de 20 de setembro de 2025 são anteriores ao registro de e-mails e não mostram entradas.

O log atualiza quando um cliente abre ou clica no e-mail?

Não. O log registra apenas o resultado do envio. Eventos de abertura e clique não são rastreados, então um status SUCCESS confirma a entrega ao provedor da caixa de entrada, mas não que o cliente leu o e-mail.

Por que o log mostra duas entradas para um pedido?

Cada envio cria sua própria entrada. Um reenvio manual, um reenvio acionado por Flow ou um fallback para o provedor de backup adicionam uma nova linha cada para que você possa auditar cada tentativa separadamente.

Veja também

Foi útil?

Ainda travado? Escreva para nós.

Última atualização 2026-05-06