# E-mail SMTP SendGrid Twilio

## 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.

O **SMTP do SendGrid** (uma plataforma de e-mail marketing adquirida pela Twilio) é um serviço que permite enviar e-mails de forma eficiente, em massa e automatizada. Ele é utilizado por desenvolvedores, empresas e sistemas de gerenciamento de e-mails para enviar e-mails transacionais, promocionais, newsletters e notificações em grande escala. A integração de **E-mail [SMTP SendGrid](https://sendgrid.com/en-us)** com o sistema é uma funcionalidade que permite conectar contas de e-mail ao **Sistema IXC**. Essa integração possibilita o envio de e-mails automatizados, incluindo faturas, notificações e comunicados, utilizando contas do SendGrid comuns.

O formulário de configuração do **SMTP SendGrid** 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 SendGrid. 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 SendGrid](https://mail.SendGrid.com/mail)**.

## 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 SendGrid](https://ahoy.sendgrid.com/email-api-abm-brazil-1?utm_source=google&utm_medium=cpc&utm_term=sendgrid&utm_campaign=SendGrid_G_S_LATAM_Brand_(PTG)&cq_plac=&cq_net=g&cq_pos=&cq_med=&cq_plt=gp&gad_source=1&gclid=Cj0KCQiAvbm7BhC5ARIsAFjwNHuXhBgr69j4pzTX08yBx1TRbI8wDmGZedu45IojXalJh3RO45Dvp9kaAiXvEALw_wcB)**, 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 - SendGrid
A configuração ocorre a partir do credenciamento dos serviços do SendGrid. É necessário ter uma conta no SendGrid, um endereço de e-mail válido e um token de autenticação para integrar a funcionalidade no sistema.

### Passo 1: Configuração SendGrid
Antes de cadastrar a integração no sistema, é necessário realizar a configuração do SMTP no **SendGrid**. Siga os passos abaixo:

1. Acesse a plataforma da SendGrid e selecione a opção "Email APIs";
2. Siga até a opção "Integration Guide" (Guia de integração);
3. Selecione a opção "Choose" (Escolher) na seção "SMTP Relay";
4. Na seção "How to send email using the SMTP Relay" (Como enviar e-mail usando o SMTP Relay), localize a opção "Create an API Key" (Criar uma chave API). Insira uma descrição para a chave API e clique no botão "Create Key";
5. Após isso, será gerado um token, que será utilizado como senha para autenticar a conta no sistema.
6. Serão apresentados os demais dados de integração, como:
	- **Server (servidor);**
	- **Ports (porta);**
	- **Username (usuário);**
	- **Password (chave API/senha).**
	  
	Estes dados serão utilizados na autenticação do e-mail SMTP, nos campos "Servidor de saída", "Porta", "Usuário" e "Senha", respectivamente.


>[!TIP] Dica - Bloco de notas:
>Copie o token gerado e os demais dados e salve-os em um bloco de notas para utilizá-los posteriormente na integração do **IXC**.

### Passo 2: Cadastro no Sistema
Após obter o token, 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.sendgrid.net**, conforme disponível nas configurações da sua conta;
	- **E-mail de envio:** endereço de e-mail que constará como remetente ao destinatário;
	- **Usuário:** insira o usuário apresentado na conta, no campo "Username";
	- **Senha:** insira o token gerado, disponível na SendGrid, no ato da criação da API Key/Chave API ou então disponível no campo "Password" (Senha);
	- **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 SendGrid é 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 SendGrid. É importante monitorar regularmente a taxa de entrega dos e-mails e evitar práticas que possam resultar em blacklisting. O SendGrid 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 #IntegracaoSendGrid #SendGrid #EnvioDeEmail 

## Leia Também
- [[integracoes|Integrações]]
- [[e-mail smtp|E-mail SMTP]]
- [SendGrid](https://ahoy.sendgrid.com/email-api-abm-brazil-1?utm_source=google&utm_medium=cpc&utm_term=sendgrid&utm_campaign=SendGrid_G_S_LATAM_Brand_(PTG)&cq_plac=&cq_net=g&cq_pos=&cq_med=&cq_plt=gp&gad_source=1&gclid=Cj0KCQiAvbm7BhC5ARIsAFjwNHuXhBgr69j4pzTX08yBx1TRbI8wDmGZedu45IojXalJh3RO45Dvp9kaAiXvEALw_wcB)
- [[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]]