# E-mail SMTP LocaWeb

## Introdução

>[!TIP] Definição - E-mail SMTP:
>**SMTP (Simple Mail Transfer Protocol)** é um protocolo padrão de comunicação usado para o **envio de e-mails** pela internet. Ele é responsável por definir como as mensagens de correio eletrônico são transmitidas entre servidores de e-mail e dispositivos de envio (como clientes de e-mail ou sistemas automatizados). Este protocolo é essencial para o funcionamento do sistema de e-mails, possibilitando que mensagens sejam enviadas de um remetente para um destinatário de forma confiável e eficiente.

A **[Locaweb](https://www.locaweb.com.br/)** é uma empresa que fornece serviços de tecnologia, como hospedagem de sites, servidores e soluções de e-mail corporativo. No contexto do sistema **IXC Soft**, a Locaweb é utilizada como provedora de serviços de e-mail, facilitando a comunicação e automação de processos. No IXC Soft, os serviços da Locaweb podem ser usados principalmente para gerenciar o envio e recebimento de e-mails relacionados a notificações, cobranças, suporte e outros processos.


> [!NOTA] **Acesso à Configuração**
> **Caminho:** Configurações > Integrações > E-mail SMTP

### Requisitos de Uso
Para utilizar este recurso, é necessário atender as seguintes condições:
- Possuir acesso à conta administrativa da plataforma **[Locaweb](https://www.locaweb.com.br/)**.

## Entrega de Valor
A integração com o servidor SMTP da **[Locaweb](https://www.locaweb.com.br/)** permite:
- Envio automatizado e manual de e-mails pelo sistema;
- Maior confiabilidade na entrega de mensagens;
- Utilização de um serviço de e-mail profissional.

## Estrutura da Funcionalidade
A funcionalidade de integração do E-mail SMTP **[Locaweb](https://www.locaweb.com.br/)** no sistema consiste na configuração de credenciais (usuário e senha API) da plataforma, juntamente com a definição da porta e do método de segurança. Essa configuração permite a autenticação da conta SMTP no sistema, viabilizando as requisições de envio ao servidor de e-mail. Uma vez integrada, a conta pode ser utilizada para diversos tipos de comunicação automatizada, como cobranças, comunicados aos técnicos, confirmações de rotinas, envio de boletos, entre outras funcionalidades.

>[!EXAMPLE] Exemplos de envios:
>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

## Configuração do E-mail SMTP - LocaWeb
Para realizar a configuração do servidor de e-mail no sistema, siga os passos conforme a orientação a seguir:

### Passo 1: Acesso à Locaweb
Nesta etapa, serão coletados os dados de integração, como usuário e senha necessários para o cadastro no sistema IXC. 

1. Acesse o site Locaweb e selecione a opção **Central do Cliente;**
2. Realize o acesso com seus dados de usuário e senha conforme repassados pela plataforma;
3. Em seguida, na guia da Central do Assinante, siga em **Início**, na opção de Produtos;
4. Selecione a opção SMTP Locaweb. O site exibirá os dados de integração do SMTP:
	- **Usuário;**
	- **Senha;**
	- **Servidor de saída;**
	- **Portas;**
	  
Estes dados serão utilizados na configuração da integração no sistema. Após coletar estes dados, retorne a configuração no sistema IXC.

### Passo 2: Cadastro no Sistema
Após coletar os dados da API para integração no sistema, siga os passos abaixo para cadastrar a conta SMTP:

#### Aba SMTP
 1. No sistema IXC, acesse o formulário **[[e-mail smtp|E-mail SMTP]]** através do caminho: **Configurações > Integrações > E-mail SMTP**;
2. Clique no botão **Novo**;
3. Na aba **SMTP,** Preencha os campos conforme as instruções para a configuração. Você poderá configurar o SMTP de duas maneiras: utilizando o tipo de segurança **TLS** ou **SSL**. Abaixo, veja as instruções para cada tipo de segurança:

##### Servidor de e-mail TLS
Para a configuração utilizando o tipo de segurança TLS, preencha os campos conforme descrito a seguir:
- **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. Ao utilizar o tipo de segurança **TLS**, insira o servidor de saída **smtplw.com.br**;
- **E-mail de envio:** endereço de e-mail que constará como remetente ao destinatário;
- **Usuário:** insira o dado informado no campo **usuário** ao acessar a Locaweb no *passo 1;*
- **Senha:** senha informada no campo **senha** ao acessar a Locaweb no *passo 1;*
- **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. Insira o valor **587** neste campo;
- **Requer autenticação:** a autenticação é utilizada para enviar os e-mails por algum gerenciador, utilizando as credenciais de acesso à sua conta. Marque como **sim** neste parâmetro;
- **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.
	- Marque o tipo de segurança **TLS** (Transport Layer Security), o qual suporta a porta 587, permitindo o envio de e-mails com segurança;
	  
- **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.
- **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.
4. Após preencher os campos, acesse a aba **Mensagem** para prosseguir com as parametrizações.
##### Servidor de e-mail SSL
Para a configuração utilizando o tipo de segurança SSL, preencha os campos conforme descrito a seguir:
	- **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. Ao utilizar o tipo de segurança TLS, insira o servidor de saída **email-ssl.com.br**;
	- **E-mail de envio:** endereço de e-mail que constará como remetente ao destinatário;
	- **Usuário:** insira o dado informado no campo **usuário** ao acessar a Locaweb no *passo 1;*
	- **Senha:** senha informada no campo **senha** ao acessar a Locaweb no *passo 1;*
	- **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. Insira o valor **465** neste campo;
	- **Requer autenticação:** a autenticação é utilizada para enviar os e-mails por algum gerenciador, utilizando as credenciais de acesso à sua conta. Marque como **sim** neste parâmetro;
	- **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.
		- Marque o tipo de segurança **SSL** (Secure Sockets Layer), o qual 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.
	- **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.
4. Após preencher os campos, acesse a aba **Mensagem** para prosseguir com as parametrizações.

#### Aba Mensagem
Na aba **Mensagem**, será configurado o conteúdo da mensagem enviada ao destinatário.

5. Após preencher os campos de configuração na aba SMTP, acesse a aba **Mensagem** e preencha os campos apresentados para a configuração de uma mensagem padrão para o SMTP:
	- **Responsável de envio:** campo opcional, que indica o responsável pelo envio para o destinatário. Recomenda-se preencher o campo com o nome do departamento responsável pelo envio, de acordo com o conteúdo da mensagem;
	- **Assunto:** insira o assunto da mensagem, será correspondente ao título da mensagem enviada ao destinatário;
	- **Mensagem:** insira o conteúdo da mensagem que será enviada ao destinatário.
	  
6.  Clique em **Salvar** para concluir as configurações.

>[!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[Início] --> B[Acessar Configurações]
    B --> C[Selecionar Integrações]
    C --> D[Clicar em E-mail SMTP]
    D --> E[Clicar em Novo]
    E --> F[Preencher Configurações LocaWeb]
    F --> G[Salvar]
    G --> H[Enviar E-mail Teste]
    H --> I{Teste Bem-sucedido?}
    I -->|Sim| J[Configuração Concluída]
    I -->|Não| K[Verificar Configurações]
    K --> F
```

## Considerações Finais
A integração do SMTP no sistema é uma funcionalidade que proporciona automação, eficiência e profissionalismo à comunicação corporativa. Por meio dessa ferramenta, é possível centralizar e gerenciar o envio de mensagens críticas, como notificações de cobrança, boletos, relatórios e atualizações operacionais, garantindo confiabilidade e segurança nas interações com clientes, fornecedores e equipes internas.
Ao configurar corretamente o SMTP, utilizando provedores como a Locaweb, empresas podem não apenas otimizar processos, mas também melhorar a experiência do usuário e reforçar a imagem de organização e competência. É importante validar periodicamente as configurações e acompanhar a performance dos envios para assegurar a continuidade das operações.
Assim, o SMTP no sistema se torna uma ferramenta estratégica para fortalecer a comunicação e o relacionamento do cliente com a empresa.

## Etiquetas
#Integracoes #IntegracoesEmailSMTP #IntegracaoLocaWeb #LocaWeb

## Leia Também
- [[integracoes|Integrações]]
- [[e-mail smtp|E-mail SMTP]]
- [Cadastrar Senha de app no Gmail](https://support.google.com/mail/answer/185833?hl=pt-BR&ref_topic=3394217&sjid=5657612785838300091-SA)
- [[aba contato - cliente|Aba Contato - Cliente]]
- [[aba e-mails enviados - cliente|Aba E-mails enviados - Cliente]]
- [[parametros financeiro|Parâmetros Financeiro]]
- [[notificacoes de e-mail - grupo de monitoramento de host|Notificações de E-mail - Grupo de Monitoramento de Host]]
- [[como configurar o envio automatico nf-e por e-mail|Como Configurar o Envio Automático NF-e por E-mail]]
- [[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]]
- [[mensagens de e-mail|Mensagens de E-mail]]
- [[cadastro de mensagem de e-mail|Cadastro de Mensagem de E-mail]]
- [[modelos de e-mail|Modelos de e-mail]]
- [[rotina de cobranca (crm de cobranca)|Rotina de Cobrança (CRM de Cobrança)]]
-  [[aba e-mail - configuracoes hotsite|Aba E-mail - Configurações Hotsite]]
- [[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]]
- [[envio de pix por e-mail|Envio de Pix por E-mail]]
- [[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]]