> 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="/files/KxoWd7KmibdJzBGrnTm5" 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          |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.gaiodataos.com/gaio-dataos-portuguese/configuracoes/geral/smtp.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.