> For the complete documentation index, see [llms.txt](https://docs.gaiodataos.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.gaiodataos.com/gaio-dataos-portuguese/configuracoes/geral/smtp.md).

# SMTP

<figure><img src="https://1268188283-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F91J5WBQDmSrL6EE6Xqez%2Fuploads%2FOIwJcIlAuLNhR59zbRhU%2Fimage.png?alt=media&amp;token=c71e88b9-d136-45ef-ad4a-bfe94cea9077" alt=""><figcaption></figcaption></figure>

A seção **SMTP Settings** permite configurar um servidor de e-mail utilizado pelo Gaio DataOS para envio de notificações do sistema, alertas e mensagens transacionais (como convites de usuário, redefinição de senha e eventos do sistema).

Essa configuração é **global por projeto** e deve estar habilitada para que o envio de e-mails funcione corretamente.

***

### Acessando as Configurações SMTP

Configure os seguintes campos:

* **SMTP Host**\
  Insira o endereço do seu servidor SMTP, como:\
  `smtp.office365.com`, `smtp.gmail.com`, etc.
* **SMTP Port**\
  Configure a porta SMTP utilizada pelo seu provedor.
* **Tipo de Criptografia**\
  Defina o método de criptografia da conexão SMTP:
  * TLS
  * SSL
* **Nome do Remetente**\
  Defina o nome que aparecerá como remetente dos e-mails do sistema.
* **Usuário SMTP**\
  Insira a conta de e-mail utilizada para autenticação no servidor SMTP.
* **Senha SMTP**\
  Insira a senha associada ao usuário SMTP.
* **Opção Microsoft / Office 365**\
  Ao utilizar SMTP do Microsoft / Office 365, habilite esta opção.\
  Ela aplica configurações específicas de compatibilidade para autenticação.
* **Status (Ativar/Desativar)**\
  Liga ou desliga o envio de e-mails via SMTP:
  * Quando habilitado → O Gaio enviará e-mails utilizando o servidor configurado
  * Quando desabilitado → Nenhum e-mail do sistema será enviado

***

### Testando a Conexão SMTP

Antes de salvar, valide sempre a configuração:

1. Clique em **Test SMTP Connection**
2. O Gaio tentará autenticar e enviar uma mensagem de teste
3. Se for bem-sucedido → A configuração está pronta para uso
4. Se falhar, revise:
   * Host e porta
   * Tipo de criptografia
   * Credenciais
   * Firewall ou restrições do provedor de e-mail

***

### Salvando a Configuração

Após o teste bem-sucedido:

1. Clique em **Save**
2. A configuração SMTP será ativada imediatamente
3. Todas as notificações do sistema passarão a utilizar esse servidor

***

### Provedores SMTP Comuns

| Provedor   | Host                               | Porta | Criptografia |
| ---------- | ---------------------------------- | ----- | ------------ |
| Office 365 | smtp.office365.com                 | 587   | TLS          |
| Gmail      | smtp.gmail.com                     | 587   | TLS          |
| SendGrid   | smtp.sendgrid.net                  | 587   | TLS          |
| Amazon SES | email-smtp.\<região>.amazonaws.com | 587   | TLS          |