# E-mail SMTP (Beta)

## Introdução

>[!tip] Atenção!
>Este conteúdo está presente na **versão [[clientes beta ixc soft|Beta]]** do sistema.
>A disponibilidade desta integração na **versão Estável** será a partir de Abril de 2025.

---

>[!TIP] **Definição:**
> O e-mail SMTP é um serviço de comunicação que utiliza o protocolo _Simple Mail Transfer Protocol_ (Protocolo Simples de Transferência de Correio, em português). Esse protocolo permite a transmissão de e-mails do remetente para o servidor do destinatário. Requer autenticação do usuário para segurança e prevenção de _spam_. O sistema consiste em um servidor que processa e encaminha e-mails, mas não é utilizado para receber e-mails. Para utilizar esse recurso, é necessário configurar um endereço de e-mail e ajustar as configurações conforme o provedor utilizado.

A integração de um servidor **SMTP** (Simple Mail Transfer Protocol) no sistema oferece uma solução completa para o gerenciamento e envio de e-mails, abrangendo tanto processos automatizados quanto manuais. Esta funcionalidade versátil permite:
1. Alertas de manutenção de rede
2. Envio de faturas
3. Notificações de pendências financeiras
4. Comunicados de abertura de Ordens de Serviço (OS) para técnicos
5. Outras informações relevantes para clientes e colaboradores do provedor

Esta integração otimiza a comunicação interna e externa, permitindo o envio eficiente de informações críticas de forma automatizada, enquanto mantém a flexibilidade para interações mais personalizadas através de envios manuais. Assim, o sistema se adapta às diversas necessidades de comunicação da empresa, melhorando a eficiência operacional e a satisfação do cliente. 

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

### Requisitos de Uso
Para utilizar uma integração de [[e-mail smtp|E-mail SMTP]] no sistema, é necessário realizar o credenciamento com uma das plataformas das quais o IXC possui compatibilidade, sendo elas:

> [!Example] Provedores de e-mail que são compatíveis com o sistema:
> - [[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]]
>- [[public/menu configuracoes/integracoes/e-mail smtp/e-mail smtp sendpulse|E-mail SMTP SendPulse]]
>- [[e-mail smtp iagentsmtp|E-mail SMTP IAGENTsmtp]]
>- [[e-mail smtp undermail|E-mail SMTP Undermail]]
>- [[e-mail smtp hotmail|E-mail SMTP 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]]

## Entrega de Valor
- Habilita o envio de e-mail através do sistema;
- Configura e integra contas de e-mail que serão utilizadas pelo sistema para enviar mensagens de e-mail aos clientes;
- Possibilidade de automação de envios a partir da configuração da integração do servidor SMTP;
- Permite o envio de mensagens personalizadas de acordo com o tipo de conteúdo a ser enviado, como envio de boletos tradicionais, cobranças do tipo pix, campanhas promocionais, entre outros;
- Centraliza o gerenciamento das contas de e-mail utilizadas para comunicações do sistema e promover um contato mais efetivo com o cliente.

## Estrutura do Formulário
A funcionalidade de integração de E-mail SMTP no sistema é implementada através do formulário E-mail SMTP, uma ferramenta essencial para configurar e gerenciar o envio de e-mails. Este formulário permite o registro detalhado das informações necessárias para que o sistema atue como intermediário eficaz no processo de envio de mensagens. O formulário E-mail SMTP está dividido em três seções principais:

- **Aba SMTP**: Configurações do servidor SMTP para envio de e-mails, favorecendo o cadastro da integração com os dados necessários;
- **Aba Mensagem:** Configurações e edição de modelos de mensagens que serão enviadas. Permite a configuração de [[modelos padrao e-mail smtp|Modelos Padrão E-mail SMTP]], com mensagens previamente configuradas e cadastradas no sistema;
- **Aba Fila:** Armazenamento dos e-mails antes de serem direcionados ao destinatário, onde são alocados temporariamente. Este processo respeita os limites de envios diários e por hora da conta de e-mail cadastrada. A fila mantém o controle do status de cada mensagem, desde o enfileiramento até a confirmação de envio.

### Campos Obrigatórios

| Campo                    | Descrição                                                                                                                                                                           |
| ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ID                       | Identificador único do registro, gerado automaticamente pelo sistema.                                                                                                               |
| Servidor de saída (SMTP) | Endereço do servidor SMTP que será utilizado para o envio de e-mails. Informação variável de acordo com cada provedor de e-mail.                                                    |
| Usuário                  | Usuário de acesso da conta de e-mail utilizada para autenticação. Normalmente é utilizado o endereço de e-mail de acesso à conta.                                                   |
| Senha                    | Senha de acesso da conta de e-mail para autenticação no servidor SMTP.                                                                                                              |
| Porta                    | Especificação da porta utilizada pelo servidor SMTP para estabelecer conexões. As portas padrão são: 587: Porta padrão para SMTP com segurança TLS; 465: Porta para SMTP sobre SSL. |
| Assunto                  | Assunto padrão que será utilizado nos e-mails enviados, título da mensagem que será enviada.                                                                                        |
| Mensagem                 | Conteúdo da mensagem que será enviada aos destinatários.                                                                                                                            |

### Aba SMTP
Na aba SMTP, realiza-se a configuração principal da conta de e-mail, estabelecendo a comunicação com o servidor SMTP. Este processo envolve a autenticação em uma plataforma de serviços de e-mail. Para isso, é necessário uma conta de e-mail válida de um provedor reconhecido. Esta conta será integrada ao sistema, habilitando o uso do serviço SMTP para envios de e-mails automatizados e manuais. A integração do serviço SMTP é efetuada através do preenchimento dos campos de configuração na aba correspondente, os principais campos de configuração incluem:
#### Campos de configuração
- **Servidor de saída:** servidor responsável por enviar e-mails a partir de uma conta de e-mail. Recebe as mensagens de e-mail e faz o encaminhamento aos servidores de destino. Alguns exemplos de servidor de saída são [smtp.gmail.com](http://smtp.gmail.com/) e [mail.dominio.com.br](http://mail.dominio.com.br/).
- **E-mail de envio:** endereço de e-mail que constará como remetente ao destinatário.
- **Usuário:** endereço de e-mail completo que realizará os envios de e-mail. Responsável pela autenticação no sistema.
- **Senha:** senha de acesso ao endereço de e-mail. Chave associada ao e-mail para autenticação.
- **Porta:** a porta é um endpoint de comunicação e tem como objetivo garantir que os e-mails sejam enviados e as informações sejam trocadas entre os servidores de e-mail. 
- **Requer autenticação:** a autenticação é utilizada para enviar os e-mails por algum gerenciador, utilizando as credenciais de acesso à sua conta. 
- **Tipo de segurança:**  tipo de segurança abrange mecanismos que criptografam mensagens enviadas pelo servidor de e-mail e tornam segura a transmissão de dados.
	- O tipo de segurança **TLS** (Transport Layer Security) suporta a porta 587, permitindo o envio de e-mails com segurança;
	- O tipo de segurança **SSL** (Secure Sockets Layer) suporta a porta 465, permitindo a comunicação criptograda enviada entre os e-mails;
- **Codificação UTF-8:** a codificação **UTF-8** é a codificação comum de todos os caracteres na web. É capaz de representar qualquer caractere especial, como letras acentuadas. 
- **Forçar codificação:** nesta seção, pode optar por qual tipo de codificação e formatação utilizar. É recomendado utilizar sempre a codificação UTF-8, pois é a formatação mais eficiente. Entre as opções disponíveis estão as codificações ISO-8859-1, UTF-8 ou Automático.
- **Remover cabeçalho X-Mailer:** campo de utilização opcional. O cabeçalho X-Mailer é utilizado para identificar o software ou dispositivo usado para enviar o e-mail. Por exemplo: "Microsoft Outlook 16.0" ou "iPhone Mail". O sistema permite que esse recurso seja habilitado ou desabilitado conforme a necessidade.
- **E-mail de destino para teste:** e-mail de destino utilizado para testar a comunicação entre o servidor de e-mail e o sistema.
- **Limite de e-mails por hora:** limite de envios do endereço de e-mail por hora.
- **Limite de e-mails por dia:** limite de envios do endereço de e-mail por dia.

>[!CAUTION] Atenção:
>Para realizar a configuração de um endereço de e-mail no sistema, verifique o material individual de cada plataforma. Os dados podem variar de acordo com cada configuração.

### Aba Mensagem
Na aba Mensagem, realiza-se a configuração detalhada do conteúdo e formato das mensagens de e-mail a serem enviadas pelo sistema. Esta seção permite personalizar o texto da comunicação por e-mail, garantindo que as mensagens sejam consistentes com a identidade da empresa e eficazes em sua comunicação.

A mensagem configurada nesta aba é utilizada em diversos processos de envio de e-mail do sistema, incluindo:
- [[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]]
- [[envio de boletos por e-mail pelo financeiro do cliente|Envio de Boletos por E-mail pelo Financeiro do Cliente]]
- [[envio de pix por e-mail|Envio de Pix por E-mail]]
- [[enviar extrato de ligacoes por e-mail|Enviar Extrato de Ligações por E-mail]]

#### Campos de configuração
- **Responsável de envio:** recomendado utilizar o nome da empresa ou departamento responsável. Constará como o responsável de envio/destinatário na mensagem de e-mail.
- **Assunto:** título da mensagem que será enviada ao destinatário.
- **Mensagem:** conteúdo da mensagem que será enviada ao cliente.

#### [[modelos padrao e-mail smtp|Modelos Padrão E-mail SMTP]]
Além da possibilidade de personalização do conteúdo a ser enviado pelo servidor de e-mail, o sistema também permite a configuração de mensagens pré-configuradas para o envio de mensagens de cobrança pix. Esta funcionalidade consiste no uso do botão suspenso de **Modelos Padrão** e oferece dois modelos de mensagens:
- **Pix Modobank**: Modelo utilizado para enviar cobranças Pix geradas exclusivamente através da funcionalidade [[modobank - pix avulso|modobank - Pix Avulso]].
- **Boleto + Pix Modobank**: Modelo utilizado para enviar cobranças com boletos tradicionais, com a opção de pagamento via Pix configurada.

Ao selecionar um dos modelos, os sistema automaticamente preencherá o campo **Mensagem** com o conteúdo da mensagem e esta, também poderá ser personalizada conforme as necessidades da empresa.

### Aba [[fila de e-mails|Fila de E-mails]]
A aba Fila gerencia a alocação temporária das mensagens de e-mail 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. Isso respeita os limites temporais e evita sobrecargas no servidor de e-mail.

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.

#### Grid de Fila de E-mails
| 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                                                                                                                                                                              |

## Casos de Uso

### Configuração padrão de SMTP
A configuração de uma conta de SMTP permite o envio de mensagens no sistema através de métodos manuais e automáticos. Para realizar a configuração de uma conta SMTP no sistema, siga os passos a seguir:

>[!WARNING] Atenção:
>Consulte seu provedor de e-mail para obter as credenciais de autenticação corretas. As informações de configuração podem variar de acordo com o serviço específico contratado.

1. Acesse o formulário de [[e-mail smtp|E-mail SMTP]] através do caminho: Configurações > Integrações > E-mail SMTP;
2. Clique no botão **Novo** para registrar o cadastro;
3. Preencha os campos:
	- **Servidor de saída (SMTP):** o servidor de saída é responsável pelo processamento e encaminhamento de mensagens do remetente para o destinatário. Insira o servidor de saída do endereço de e-mail utilizado, repassado pelo provedor de e-mail. Alguns exemplos de servidor de saída são: **smtp.gmail.com** ao utilizar o provedor **Gmail**, smtp.mail.yahoo.com ao utilizar o provedor **Yahoo**;
	- **E-mail de envio:** campo de preenchimento opcional. A partir deste campo, é possível inserir o endereço de e-mail que constará como remetente ao destinatário;
	- **Usuário:** insira o endereço de e-mail ou o usuário que será utilizado para realizar a autenticação;
	- **Senha:** insira a senha de acesso do endereço de e-mail/usuário utilizado para realizar a autenticação;
	- **Porta:** insira a porta que será utilizada para estabelecer a comunicação na integração. Poderá utilizar as portas 465 (SSL) ou 587 (TLS);
	- **Requer autenticação:** para efetuar a autenticação do e-mail SMTP no sistema, selecione a opção **sim**;
	- **Tipo de segurança:** o tipo de segurança deve corresponder à porta utilizada. Caso utilize a porta 465, marque a opção de segurança SSL. Caso utilize a porta 587, marque a opção TLS;
	- **Codificação UTF-8:** codificação comum de caracteres na web. Marque a opção **sim** para que a codificação destes caracteres seja ativado, mantendo a configuração correta do conteúdo da mensagem;
	- **Forçar codificação:** selecione o tipo de codificação de sua preferência. É recomendável utilizar a codificação UTF-8, pois é a formatação mais eficiente. Selecione uma das opções disponíveis, entre elas: ISO-8859-1, UTF-8 ou Automático (se automático, a identificação de codificação é feita automaticamente pelo sistema).
	- **Remover cabeçalho X-Mailer:** 
		- **Sim:** ao manter este parâmetro marcado como "sim", o sistema irá considerar qual software/aplicativo foi utilizado para enviar uma mensagem. Esta informação constará ao cliente ao verificar o detalhamento do envio. Esta ferramenta pode ser utilizada em filtros de spam para identificar padrões de envio de e-mails.
		- **Não:** ao manter este parâmetro marcado como "não"
	- **E-mail de destino para teste:** e-mail de destino para realizar o envio de teste;
	- **Limite de e-mails por hora:** verifique em seu provedor de e-mail qual o limite de envios por **hora** da sua conta e insira o valor neste campo;
	- **Limite de e-mails por dia:** verifique em seu provedor de e-mail qual o limite de envios por **dia** da sua conta e insira o valor neste campo.
	  
>[!INFO] Limite de envio:
>Considere o limite diário de envio de e-mails para distribuir adequadamente a quantidade de envios por hora, respeitando as restrições do provedor de e-mails.
	  
4. Acesse a aba **Mensagem** para realizar a configuração da mensagem padrão da conta de SMTP integrada. Preencha os campos:
	- **Responsável de envio:** insira o responsável de envio pela mensagem. É recomendado utilizar o nome da empresa ou departamento responsável;
	- **Assunto:** insira o assunto da mensagem de e-mail. Será correspondente ao título do e-mail para o destinatário;
	- **Mensagem:** insira o conteúdo da mensagem de e-mail de e-mail que será enviada ao cliente.
	  
5. Clique em **Salvar** para concluir a configuração do E-mail SMTP.

>[!SUCCESS] Finalização:
>Após concluir o cadastro da conta de e-mail, clique em **Enviar E-mail Teste** para validar a comunicação com a plataforma. Ao realizar o envio, se bem-sucedido, o sistema exibirá a mensagem:	'E-mail enviado com sucesso para (e-mail de destino para teste)!'. Esta confirmação indica que a autenticação foi realizada com êxito, e você poderá utilizar o SMTP para efetuar os envios de e-mail.


## Fluxo de Trabalho


```mermaid
graph TD
    A[Acessar Formulário SMTP] --> B[Preencher Campos Obrigatórios]
    B --> C[Configurar Modelo de Mensagem]
    C --> D[Definir Limites de Envio]
    D --> E[Enviar E-mail Teste]
    E --> F{Teste Bem-sucedido?}
    F -->|Sim| G[Configuração Concluída]
    F -->|Não| H[Revisar Configurações]
    H --> B
```

## Considerações Finais
A integração de um servidor SMTP no sistema permite automatizar e otimizar o envio de mensagens, desde notificações de sistema até comunicações com clientes. A configuração adequada, incluindo a autenticação correta e o respeito aos limites do provedor, é crucial para garantir a entrega confiável e evitar classificações como spam. O uso de uma fila de e-mails melhora a eficiência, controlando o fluxo de envios e respeitando as restrições do servidor. Com esta integração, as empresas podem melhorar significativamente sua comunicação, aumentando a eficiência operacional e a satisfação do cliente.

## Etiquetas
#Integracoes #IntegracaoSMTP #EmailSMTP 

## Leia Também
- [[integracoes|Integrações]]
- [[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]]
- [[fila de e-mails|Fila de E-mails]]
- [[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]]
- [[envio de pix por e-mail|Envio de Pix por E-mail]]
- [[variaveis de e-mail para envio manual de cobrancas pix|Variáveis de E-mail para Envio Manual de Cobranças Pix]]