Gerenciamento de fila
Monitore o status de envio, solucione erros e gerencie sua fila de e-mails.
O Gerenciamento de fila permite monitorar o progresso das tarefas de geração de PDF e envio de e-mail. Ele fornece uma visão detalhada de cada trabalho, desde o status geral do perfil até itens individuais de e-mail.
Visão geral
O sistema de gerenciamento de fila é organizado em quatro níveis para ajudar a investigar problemas:
- Profile List: Visão geral de todos os perfis e suas atividades recentes.
- Batch List: Histórico de importações (arquivos) para um perfil específico.
- Queue List: Itens individuais (destinatários) dentro de um lote.
- Item Details: Dados detalhados e status de um item individual.
1. Profile List (Visão geral)
A visualização principal mostra um card para cada Perfil configurado.
- Stats: Cada card exibe o status dos itens dos últimos 30 dias.
- Error: Itens que falharam (Geração de PDF, Envio ou Importação).
- Pend: Itens aguardando processamento (Geração de PDF).
- PDF Generated: Itens com PDFs gerados, aguardando envio.
Ação: Clique em um card de perfil (ou no ícone Edit) para ver sua Batch List.
2. Batch List (Histórico)
Esta lista mostra todos os arquivos importados para o perfil selecionado.
- Batch Name: Corresponde ao nome do arquivo do CSV importado.
- Import Date: Use para distinguir entre múltiplas importações do mesmo arquivo.
- Colunas de status:
- Total: Número total de itens no lote.
- Error: Total de falhas.
- Pending: Aguardando geração de PDF.
- PDF Generated: PDFs gerados, aguardando envio.
- Sent: Enviados com sucesso.
Ação: Clique no ícone Edit de uma linha de lote específica para ver sua Queue List.
3. Queue List (Itens)
Esta visualização lista todos os destinatários individuais dentro do lote selecionado.
Funcionalidades
- Search: Pesquise por Destinatário (To), Status, Mensagem de Erro ou conteúdo dos dados (JSON).
- Filter: Use o dropdown para mostrar apenas status específicos (ex.: somente "Error").
- Delete Batch: O botão Delete Batch permite remover todo o histórico do lote.
Definições de status
| Status | Valor interno | Descrição |
|---|---|---|
| Pending | pending | Aguardando o sistema gerar o PDF. |
| PDF Generated | pdf_generated | PDF criado com sucesso. Aguardando envio. |
| Sent | sent | E-mail entregue ao servidor SMTP com sucesso. |
| Error (Import) | error_import | A importação de dados falhou para este item. |
| Error (PDF) | error_pdf | A geração de PDF falhou. |
| Error (Email) | error_email | O envio de e-mail falhou (pode ser tentado novamente). |
| Error (Email Fatal) | error_email_fatal | O envio falhou permanentemente (ex.: endereço inválido). |
Mensagens de erro comuns
Os seguintes erros podem aparecer na coluna Error Message ou na Error List do lote:
Erros de envio de e-mail
MISSING_TO_RECIPIENT: O endereço "To" está vazio. Verifique a configuração de mapeamento.INVALID_EMAIL_FORMAT: O formato do endereço de e-mail é inválido.BACKEND_CONNECTION_FAILED: Não foi possível conectar ao servidor SMTP. Verifique sua conexão de internet ou VPN.SMTP_AUTH_ERROR: Falha na autenticação SMTP. Verifique usuário e senha.RETRY_LIMIT_REACHED_SKIP: O sistema desistiu após o número máximo de tentativas e pulou este item.RETRY_LIMIT_REACHED_ABORT: O sistema desistiu após o número máximo de tentativas e abortou o lote.
Erros de importação e processamento
TEMPLATE_FILE_NOT_FOUND: O arquivo de modelo PDF configurado está ausente no workspace.MISSING_MASTER_LOOKUP_VALUE: O item não tem valor para a chave de pesquisa (ex.: ID do Cliente está vazio), então os dados mestre não puderam ser recuperados.CSV_DATA_EMPTY_OR_UNREADABLE: O arquivo CSV importado estava vazio ou corrompido.
4. Item Details (Edição e nova tentativa)
Clicar no ícone Edit de um item permite modificar seus dados ou tentar novamente um processo que falhou.
Modificando dados
Você pode corrigir endereços de e-mail (To, CC, BCC) se foram importados incorretamente.
Aviso de consistência de dados
Campos de entrada vs JSON de dados mestre
Os campos de entrada To/CC/BCC à esquerda são separados do JSON de dados mestre à direita.
- Os campos de entrada controlam para onde o e-mail é enviado nesta tentativa específica.
- Os dados JSON são usados para geração de PDF e renderização do modelo.
- Alterar um não atualiza automaticamente o outro. Se precisar corrigir um endereço de e-mail para envio, atualize o campo de entrada.
Modificando status (Nova tentativa)
O status não muda automaticamente ao salvar. Você deve selecionar manualmente o status apropriado para acionar uma nova tentativa:
- Pending: Selecione para descartar o PDF atual e tentar gerá-lo novamente (ex.: após corrigir dados JSON).
- PDF Generated: Selecione para tentar enviar novamente o PDF existente (ex.: após corrigir um endereço de e-mail).
Editando JSON
Você pode editar diretamente os dados de Document Content Data e Customer Master Data.
Sintaxe JSON
Tenha muito cuidado ao editar JSON. Você deve manter a sintaxe válida, incluindo aspas duplas (""), vírgulas (,) e colchetes/chaves ([], {}). JSON inválido fará com que o processo falhe novamente.