# E-mail

Configure como a plataforma envia e-mail (a entrega integrada ou o seu próprio fornecedor) e envie uma mensagem de teste.

Requires: customMailProvider

> **Nota de plano:** Um fornecedor de e-mail próprio está disponível a partir do plano Essential. Consulte [Planos e add-ons](https://dts-identity.com/pt/docs/getting-started/plans-and-addons.md). Nos níveis inferiores, a plataforma envia todo o e-mail através da sua entrega integrada.

A plataforma envia e-mail transacional para reposições de palavra-passe, verificação de endereço, inscrição de multifator, mensagens de boas-vindas, notificações de aprovação, convites e recuperação de conta. Por predefinição, estas mensagens são entregues por um fornecedor integrado, sem qualquer configuração. A partir do plano Essential pode ligar o **seu próprio** fornecedor de e-mail, para que as mensagens tenham origem no seu domínio e usem os seus controlos de entregabilidade e de conformidade.

[Image: O separador Mail das definições de branding]

## Escolher um modo de entrega

1. Na Admin Console, abra **Branding → E-mail**.
2. Escolha como o e-mail é entregue:
   - **Default delivery provider**: o serviço integrado. Nada a configurar.
   - **Fornecedor de e-mail personalizado**: ligue um dos fornecedores suportados abaixo.
3. Selecione **Guardar alterações**.

Se ficar pelo fornecedor predefinido, não há mais nada a configurar: o seu e-mail já está a ser entregue.

## Ligar o seu próprio fornecedor

1. Selecione **Fornecedor de e-mail personalizado**.
2. Escolha um fornecedor na grelha. Cada fornecedor revela apenas os campos de que precisa.
3. Preencha o endereço **De** (por exemplo, `"Your App" <support@yourapp.com>`) e os campos específicos do fornecedor.
4. Selecione **Guardar alterações**.

### Fornecedores suportados

| Fornecedor | O que indica |
|---|---|
| **Custom SMTP server** | Host, porta, versão de TLS, se usa TLS, e um nome de utilizador e palavra-passe caso o seu servidor exija autenticação |
| **Microsoft 365** | Tenant ID, Client ID e Client Secret de uma aplicação registada |
| **Amazon SES** | Região, Access Key ID e Secret Access Key |
| **SendGrid** | Chave de API |
| **Mailgun** | Chave de API, domínio de envio e região (EU/US) |
| **Resend** | Chave de API |
| **Azure Communication Services** | Endpoint e Access Key |
| **SparkPost** | Chave de API e região (EU/US) |
| **Mandrill** | Chave de API |

> **Custom SMTP:** A autenticação é opcional. Deixe o nome de utilizador e a palavra-passe em branco se o seu relay aceitar submissões não autenticadas vindas da plataforma. Escolha a versão de TLS que o seu servidor suporta.

### Campos secretos

As credenciais como chaves de API, client secrets e palavras-passe SMTP são guardadas de forma segura e apresentadas como um campo mascarado com um controlo para **revelar** o valor, para que possa confirmá-lo sem o expor no ecrã. Para deixar um segredo existente inalterado, deixe o respetivo campo tal como está guardado.

## Enviar um e-mail de teste

Depois de guardar a configuração de um fornecedor, use **Enviar e-mail de teste** para a verificar de ponta a ponta. A plataforma envia uma mensagem de teste para o seu próprio endereço de administrador, usando a configuração **guardada**.

> **Importante:** O teste usa as definições *guardadas*, pelo que deve guardar o formulário antes de testar. O botão de teste não está disponível enquanto o formulário de um fornecedor estiver vazio ou tiver edições por guardar.

Se o teste não chegar, verifique as credenciais do fornecedor, o endereço De e o domínio de envio ou a verificação de remetente do seu fornecedor.

## Que mensagens de e-mail a plataforma envia

A plataforma envia e-mail transacional para os fluxos abaixo. Use esta lista para confirmar que um fornecedor funciona com os fluxos que lhe interessam: percorra cada caminho consigo próprio e verifique a entrega. Vários destes são avisos de eventos de segurança que ficam também registados como entradas de auditoria, pelo que um administrador pode correlacionar um e-mail questionado por um utilizador com o registo de auditoria (consulte [Proteção contra ameaças](https://dts-identity.com/pt/docs/security/threat-protection.md)).

| E-mail | Acionado quando |
|---|---|
| Verificar endereço de e-mail | Um utilizador adiciona ou altera o seu e-mail e tem de o confirmar |
| Verificar número de telemóvel | Um utilizador adiciona ou altera o seu número de telefone |
| Convite / ativação | Um administrador convida um utilizador, ou um registo self-service precisa de ativação |
| Reposição de palavra-passe | Um utilizador pede uma reposição, ou um administrador envia uma |
| Conta desbloqueada | Uma conta que estava bloqueada é recuperada ou desbloqueada |
| Aviso de palavra-passe comprometida | Um início de sessão é bloqueado porque a palavra-passe apareceu numa violação conhecida |
| Confirmação de inscrição de MFA | Um utilizador regista um novo segundo fator |
| Código de MFA por e-mail | Um código único é entregue para MFA por e-mail |
| Notificação de novo início de sessão | Um início de sessão chega a partir de um dispositivo desconhecido |
| Notificação de aprovação | Um pedido submetido por um utilizador é aprovado ou recusado |

## O que pode personalizar

- **O endereço De (remetente)**: definido por fornecedor nesta página (por exemplo, `"Your App" <support@yourapp.com>`), para que as mensagens tenham origem no seu domínio.
- **Logótipo e cor de destaque**: o logótipo de [Definições → Geral](https://dts-identity.com/pt/docs/settings/general.md) e a cor de destaque de [Aspeto](https://dts-identity.com/pt/docs/branding/appearance.md) são aplicados a todas as mensagens, para que os e-mails combinem com a sua experiência de início de sessão.

As formulações de cada mensagem vêm dos textos traduzidos da instância, um conjunto por idioma ativado, e não de um editor livre por modelo. Não existe um motor de modelos HTML ou de código, nem scripting de variáveis por mensagem. Para alterar os idiomas usados nos seus e-mails, faça a gestão dos idiomas ativados em [Definições → Geral](https://dts-identity.com/pt/docs/settings/general.md).
