Configurações - Histórico de Envios de E-mail

O que é

O Histórico de Envios reúne todos os e-mails que o Viagilize mandou em nome da sua empresa: confirmação de reserva, cartão de embarque, cobrança, lembrete de pagamento, pesquisa de satisfação, avisos de pendência e os demais e-mails automáticos disparados pelo sistema. Cada linha mostra para quem foi, o assunto, o tipo do e-mail, quando foi enviado e o status atual, permitindo confirmar rapidamente se uma mensagem específica realmente saiu.

Você normalmente chega aqui quando um cliente diz que não recebeu um e-mail (o cartão de embarque, por exemplo), quando quer conferir se as cobranças do dia foram enviadas, ou quando precisa investigar um e-mail que falhou para tentar reenviá-lo. A tela também serve como conferência geral: os cinco indicadores do topo dão um resumo do volume de envios sem precisar abrir cada mensagem.

Como usar

1. Vá em Relatórios > Histórico de Envios no menu lateral.
2. Confira os indicadores no topo da tela: Total, Hoje, Enviados, Pendentes e Falhas.
3. Use o formulário de filtros para refinar a lista:
   • Email, nome ou assunto... - busca livre que procura o termo digitado no e-mail, no nome do destinatário ou no assunto da mensagem.
   • Status - filtra por Pendente, Enviado, Confirmado ou Falhou.
   • Tipo de Email - filtra pelo tipo de mensagem (confirmação de reserva, cartão de embarque, pesquisa de satisfação, entre outros).
   • Data início e Data fim - restringe o período pela data de criação do envio.
4. Clique em Filtrar para aplicar os filtros. A lista é paginada em 50 e-mails por página.
5. Clique no botão verde com o ícone de download, ao lado de Filtrar, para baixar a lista atual (com os filtros aplicados) em um arquivo CSV.
6. Na lista, cada item mostra um ícone colorido de status, o assunto (cortado em até 50 caracteres, com o texto completo disponível ao passar o mouse), o tipo do e-mail, o status, o destinatário e a data do envio.
7. Clique no menu Ações, à direita de cada item, e escolha Ver detalhes para abrir uma janela com as informações completas: para quem foi enviado, quem enviou, o assunto completo, quando foi enviado, quando foi confirmado, quantas tentativas o sistema fez e, se houve falha, a mensagem de erro registrada.
8. Nos e-mails com status Falhou, o menu Ações mostra também a opção Reenviar (o mesmo botão aparece no rodapé da janela de detalhes). Ao confirmar, o sistema pergunta "Deseja reenviar este email?"; confirmando, a página recarrega com o novo status.

O que você precisa saber antes

• Enviado e Confirmado não significam a mesma coisa. O status Enviado indica que o Viagilize entregou a mensagem para o servidor de e-mail processar; Confirmado indica que esse servidor concluiu o envio. Nenhum dos dois garante que a mensagem chegou à caixa de entrada do destinatário: o sistema não recebe de volta a confirmação de entrega final, então um e-mail com status Confirmado pode, ainda assim, ter caído em spam ou sido recusado silenciosamente pelo provedor do destinatário.
• Reenviar não é instantâneo. Clicar em Reenviar apenas devolve aquele e-mail para a fila de processamento (o status volta para Pendente); o envio de fato acontece em segundo plano, não na hora do clique. Se o status continuar Pendente por muito tempo depois disso, é sinal de que o reprocessamento não está rodando, e vale acionar o suporte.
• A busca não olha dentro da mensagem. O campo de busca livre encontra apenas o que está no e-mail do destinatário, no nome dele ou no assunto - não procura texto dentro do corpo do e-mail.
• A exportação tem um teto. O CSV gerado pelo botão de download traz no máximo os 10.000 registros mais recentes que combinam com os filtros aplicados no momento do clique.
• Alguns tipos de e-mail aparecem com um nome mais técnico. Quando um tipo de e-mail ainda não tem um rótulo amigável cadastrado, ele aparece na lista com o nome bruto usado internamente. Isso é esperado e não indica erro no envio.

Casos especiais

E-mail com status Falhou

Ao abrir Ver detalhes de um e-mail que falhou, a janela mostra a mensagem de erro registrada e o horário da falha, além do número de tentativas já feitas. É esse mesmo item que ganha a opção Reenviar, tanto no menu Ações da lista quanto no rodapé da própria janela de detalhes.

Exportar a lista filtrada

O botão de exportação usa exatamente os filtros ativos na tela no momento do clique (busca, status, tipo de e-mail e período). Para exportar só os e-mails falhados de uma data específica, por exemplo, aplique esses filtros com Filtrar antes de clicar no ícone de download. O arquivo baixado abre corretamente no Excel, com o destinatário, o assunto, o tipo, o status, a data de envio e o erro (quando houver) em colunas separadas.

Nenhum e-mail encontrado

Quando a lista fica vazia, a tela mostra a mensagem "Nenhum email encontrado" com o aviso "Os emails enviados aparecerão aqui". Isso acontece tanto quando os filtros aplicados não combinam com nenhum registro quanto quando a empresa ainda não teve nenhum e-mail automático disparado.

Erros comuns

• "Nenhum email encontrado" - Causa: os filtros aplicados (busca, status, tipo, período) não encontram nenhum registro. Solução: limpe os filtros pelo link de limpar no formulário e refine de novo, um campo por vez.
• "Apenas emails com falha podem ser reenviados." - Causa: você tentou reenviar um e-mail que já não está mais com status Falhou (por exemplo, alguém já reprocessou ou o próprio sistema já tinha mudado o status entre a abertura da tela e o clique). Solução: atualize a página e confira o status atual antes de tentar de novo.
• "Erro ao reenviar email" - Causa: falha de comunicação ao chamar o reenvio (rede instável ou instabilidade momentânea do sistema). Solução: aguarde alguns segundos e tente novamente pelo menu Ações.

Onde encontrar

• URL: /admin/envios
• Caminho no menu: Relatórios > Histórico de Envios
• Permissão necessária: ver o histórico de envios
• Módulo necessário: nenhum

Veja também

• Configurações - Templates de E-mail
• Configurações - Notificações Automáticas