# Fila de E-mails

## Introdução
A Fila de E-mails no sistema gerencia a alocação temporária das mensagens antes do envio ao destinatário. Esta funcionalidade controla o volume de envios, aplicando filtros por hora e dia conforme os limites estipulados pelo provedor de e-mail. O sistema monitora o status de cada mensagem e organiza o processo de enfileiramento, permitindo uma distribuição otimizada que respeita os limites temporais e evita sobrecargas no servidor.

Esta funcionalidade é centralizada no Formulário de Fila de E-mails, uma ferramenta essencial para gerenciar e visualizar informações sobre os e-mails a serem enviados. Isso permite às empresas controlarem eficientemente o fluxo de saída de e-mails, garantindo uma entrega confiável.

O Formulário de Fila de E-mails está diretamente associado à integração de [[e-mail smtp|E-mail SMTP]]. Cada integração SMTP possui sua própria fila dedicada, permitindo um gerenciamento individualizado do fluxo de envios para cada configuração SMTP.

> [!NOTA] Acesso ao Formulário
>Caminho: Configurações > Integrações > E-mail SMTP > Fila

## Entrega de Valor
- Gerencia o fluxo de envio de e-mails, baseado no limite de envios determinado na configuração do SMTP;
- Proporciona uma interface intuitiva para gerenciamento da fila de e-mails;
- Distribui a carga de envio ao longo do tempo;
- Evita sobrecarga do servidor SMTP;
- Melhora o desempenho geral do sistema de e-mail.

> [!NOTA] **Importância da Fila de E-mail:** 
> A implementação de uma fila de e-mail é crucial para empresas que dependem de comunicação eletrônica em larga escala, pois ajuda a manter a reputação do servidor de e-mail e melhora a taxa de entrega.

## Estrutura do Formulário

### Escopo
A aba Fila é implementada através do formulário **[[fila de e-mails|Fila de E-mails]]**. Sua interface apresenta uma grid organizada em linhas e colunas, exibindo os principais dados de cada envio de e-mail. Cada registro na grid corresponde a um e-mail específico, ordenado cronologicamente de acordo com a sequência de enfileiramento e o período programado para envio.

| Coluna        | Descrição                                                                                                                                                                                                                                                                                                              |
| ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ID            | Número de identificação do registro, definido automaticamente no sistema.                                                                                                                                                                                                                                              |
| Status        | Define o status da mensagem conforme o período da qual fica armazenada na fila:<br>**Enviada**: a mensagem enviada assume o status de **Enviada** quando é enviada ao cliente;<br>**Aguardando:** a mensagem assume o status de **Aguardando** quando ainda não foi enviada ao cliente e permanece na fila de e-mails. |
| E-mail        | E-mail do destinatário.                                                                                                                                                                                                                                                                                                |
| Nome          | Nome do cliente do qual recebeu o envio.                                                                                                                                                                                                                                                                               |
| Assunto       | Assunto da mensagem enviada, cadastrada na aba Mensagem da conta de e-mail SMTP integrada ao sistema.                                                                                                                                                                                                                  |
| Data inclusão | Data e hora da qual a mensagem foi inclusa na fila.                                                                                                                                                                                                                                                                    |
| Data envio    | Data e hora da qual a mensagem saiu da fila de e-mail para ser efetivamente enviada ao cliente.                                                                                                                                                                                                                        |
| Anexos        | Registra o caminho de onde o arquivo está localizado no sistema de arquivos do software. É o diretório raíz para arquivos do servidor web                                                                                                                                                                              |

### Princípios de Funcionamento
Após a integração de uma conta de e-mail no formulário [[e-mail smtp|E-mail SMTP]], o envio de mensagens é ativado no sistema. Quando um e-mail é enviado, ele é inicialmente alocado na fila de e-mail. A entrega ao destinatário ocorre respeitando os limites de envio por hora e por dia estipulados, considerando tanto a prioridade da mensagem quanto a ordem cronológica de sua inclusão na fila.

O processo resume-se nas seguintes etapas:
1. Cadastro da integração de [[e-mail smtp|E-mail SMTP]];
2. Cadastro das [[mensagens de e-mail|Mensagens de E-mail]];
3. Requisição de envio das mensagens;
4. Mensagens passam pela fila de e-mail;
5. Assumem o status de **Aguardando** ou de **Enviado**, conforme são disparadas da fila de E-mail.

## Funcionalidades principais
A fila de e-mail é um componente crucial para o gerenciamento eficiente do fluxo de mensagens de e-mail. Suas principais funcionalidades incluem:

1. Visualização e controle das mensagens que são enviadas por determinado SMTP;
3. Processamento em lote, fragmentando quantidades por período, conforme determina o provedor do e-mail.


## Fluxo de Trabalho 

```mermaid
graph TD
    A[Início] --> B[Cadastro da integração de E-mail SMTP]
    B --> C[Cadastro das mensagens de e-mail]
    C --> D[Requisição de envio das mensagens]
    D --> E[Mensagens entram na fila de e-mail]
    E --> F{Processamento da fila}
    F --> |Aguardando envio| G[Status: Aguardando]
    F --> |Tentativa de envio| H{Enviado?}
    G --> F
    H --> |Sim| I[Status: Enviado]
    H --> |Não| J[Status: Falha]
    I --> K[Registra log de sucesso]
    J --> L[Registra log de falha]
    L --> M[Inicia resolução de problemas]
    M --> N{Problema resolvido?}
    N --> |Sim| E
    N --> |Não| O[Notifica administrador]
    K --> P[Fim]
    O --> P
```


## Considerações finais
A **Fila de E-mails** é uma ferramenta crucial para o gerenciamento eficiente da comunicação por e-mail no sistema. Ela permite um controle preciso sobre os e-mails a serem enviados, melhorando a organização e a eficácia da comunicação com os clientes.

## Etiquetas
#Integracoes #IntegracaoSMTP #EmailSMTP 

## Leia Também
- [[integracoes|Integrações]]
- [[contas de e-mail|Contas de E-mail]]
- [[e-mail smtp|E-mail SMTP]]
- [[e-mail smtp gmail|E-mail SMTP Gmail]]
- [[e-mail smtp locaweb|E-mail SMTP LocaWeb]]
- [[e-mail smtp webmail|E-mail SMTP Webmail]]
- [[e-mail smtp godaddy|E-mail SMTP GoDaddy]]
- [[e-mail smtp hostinger|E-mail SMTP Hostinger]]
- [[private/menu configuracoes - private/integracoes - private/e-mail smtp - private/e-mail smtp sendpulse|private/Menu Configurações - Private/Integrações - Private/E-mail SMTP - Private/E-mail SMTP SendPulse]]
- [[e-mail smtp iagentsmtp|E-mail SMTP IAGENTsmtp]]
- [[e-mail smtp undermail|E-mail SMTP Undermail]]
- [[e-mail smtp bol|E-mail SMTP Bol]]
- [[hotmail|Hotmail]]
- [[e-mail smtp kinghost|E-mail SMTP KingHost]]
- [[e-mail smtp terra|E-mail SMTP Terra]]
- [[e-mail smtp rede host|E-mail SMTP Rede Host]]
- [[e-mail smtp umbler|E-mail SMTP Umbler]]
- [[e-mail smtp zoho|E-mail SMTP Zoho]]
- [[envio de e-mail para relatorios de contratos (novo)|Envio de E-mail para Relatórios de Contratos (Novo)]]
- [[envio de e-mail para relatorios de saidas fiscais (novo)|Envio de E-mail para Relatórios de Saídas Fiscais (Novo)]]
- [[envio de e-mail para relatorios de ordem de servico (novo)|Envio de E-mail para Relatórios de Ordem de Serviço (Novo)]]
- [[envio de e-mail para relatorios de contas a receber (novo)|Envio de E-mail para Relatórios de Contas a Receber (Novo)]]
- [[envio automatico de e-mail para aniversariantes|Envio Automático de E-mail para Aniversariantes]]
- [[tarefa - enviar e-mail clientes aniversariantes|Tarefa - Enviar e-mail clientes aniversariantes]]
- [[envio de sms, e-mail e mensagem omnichannel pelo processo de ordem de servico|Envio de SMS e E-mail pelo processo de ordem de serviço]]
- [[notificacoes de e-mail - grupo de monitoramento de host|Notificações de E-mail - Grupo de Monitoramento de Host]]
- [[envio de boletos por e-mail pelo relatorio de emissao de boletos|Envio de Boletos por E-mail pelo Relatório de Emissão de Boletos]]
- [[aba e-mails enviados - cliente|Aba E-mails enviados - Cliente]]
- [[aba e-mail - configuracoes hotsite|Aba E-mail - Configurações Hotsite]]
- [[variaveis de e-mail - emissao de boletos|Variáveis de E-mail - Emissão de Boletos]]
- [[log de e-mail|Log de E-mail]]
- [[mensagens de e-mail|Mensagens de E-mail]]
- [[cadastro de mensagem de e-mail|Cadastro de Mensagem de E-mail]]