# E-mail SMTP Gmail

## 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 integração de **E-mail [SMTP Gmail](https://mail.google.com/mail)** com o sistema é uma funcionalidade que permite conectar contas de e-mail do Google, como **Gmail** ou **G Suite**, ao **Sistema IXC**. Essa integração possibilita o envio de e-mails automatizados, incluindo faturas, notificações e comunicados, utilizando contas do Gmail comuns.

O formulário de configuração do **SMTP Gmail** no Sistema oferece uma interface intuitiva, projetada para facilitar o cadastro e a gestão das informações necessárias para estabelecer uma conexão segura com os servidores da Google. Essa funcionalidade garante praticidade, segurança e eficiência na comunicação eletrônica corporativa.

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

### Requisitos de Uso
Para utilizar este recurso, é necessário atender as seguintes condições:
- Ter acesso à conta do endereço de e-mail ou à conta administrativa da plataforma **[SMTP Gmail](https://mail.google.com/mail)**, caso esteja utilizando um **Workspace**.

## Entrega de Valor
- Habilitar o envio de e-mail pelo sistema IXC Soft;
- Configurar e integrar 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;
- Envio de faturas, comunicados e notificações relevantes, direcionadamente ou em massa;
- Centralizar o gerenciamento das contas de e-mail utilizadas para comunicações do sistema e promover um contato mais efetivo com o cliente.

## Estrutura da Funcionalidade
A funcionalidade de integração do E-mail **[SMTP Gmail](https://mail.google.com/mail)**, 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 - Gmail
A configuração ocorre a partir do credenciamento dos serviços do Gmail. Faz-se necessário possuir uma conta de e-mail, proveniente do Gmail e um endereço de e-mail válido para integrar a funcionalidade no sistema.

### Passo 1: Configuração da Senha de App no Google
Antes de cadastrar a integração no sistema, é necessário gerar uma senha de App na plataforma Google. Para obter instruções detalhadas sobre este processo, consulte o manual oficial do Google disponível abaixo.

> [!TIP] Manual Google: 
>- [Geração da senha de App](https://support.google.com/mail/answer/185833?hl=pt-BR&ref_topic=3394217&sjid=5657612785838300091-SA)

### Passo 2: Cadastro no Sistema
Após obter a senha de app, ela será utilizada para que a autenticação do e-mail SMTP ocorra junto ao sistema. Para realizar o cadastro da integração no sistema, siga os passos a seguir:

 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:
	- **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. Insira o servidor de saída **smtp.gmail.com**;
	- **E-mail de envio:** endereço de e-mail que constará como remetente ao destinatário;
	- **Usuário:** insira o endereço de e-mail de acesso à conta do Google;
	- **Senha:** insira a senha de acesso do e-mail utilizado no login da conta Google;
	- **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 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:** 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:** 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:** 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.
	  
>[!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. Após preencher os campos, acesse a aba **Mensagem** para prosseguir com as parametrizações. 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 configuração correta do SMTP Gmail é crucial para garantir a entrega eficiente de e-mails aos clientes. Certifique-se de testar as configurações antes de iniciar os envios em massa e ajustar os limites de envio conforme as políticas do Gmail. É importante monitorar regularmente a taxa de entrega dos e-mails e evitar práticas que possam resultar em blacklisting. O Gmail possui limitações específicas para envios SMTP, portanto, é fundamental adequar o volume de envios às políticas estabelecidas pela plataforma para manter a conta em conformidade.

## Etiquetas
#Integracoes #IntegracoesEmailSMTP #IntegracaoGmail #Gmail #EnvioDeEmail 
## 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]]
- [[Variáveis de E-mail para Envio Manual de Cobranças Pix