# Envio de e-mail com OAuth 2.0 no QlikView

O QlikView pode enviar e-mails por meio do Microsoft Graph usando OAuth 2.0 com o Microsoft 365. O OAuth 2.0 é um método adicional de conexão de e-mail; a configuração existente de SMTP permanece disponível.

Quando o OAuth 2.0 é selecionado, o QlikView não se conecta diretamente a um servidor SMTP. Ele obtém um token de acesso de `login.microsoftonline.com` e envia e-mail por meio da API REST do Microsoft Graph em `graph.microsoft.com/v1.0/users/{sender}/sendMail`.

## Pré-requisitos

Antes de configurar o QlikView, registre um aplicativo no Microsoft Entra ID:

1. Entre no portal do Azure e vá para Microsoft Entra ID > Registros de aplicativo > Novo registro.
2. Registre o aplicativo.
3. Em Certificados & segredos, crie um segredo do cliente e copie seu valor. O valor é exibido apenas uma vez.
4. Em Permissões de API, adicione a permissão de aplicativo Mail.Send do Microsoft Graph.
5. Conceda consentimento do administrador para a permissão.
6. Registre a ID do aplicativo (cliente) e a ID do diretório (locatário).

O aplicativo deve ter a permissão Mail.Send para a caixa de correio usada como remetente.

## Segurança

O QlikView criptografa o ID do locatário, o ID do cliente e o segredo do cliente antes de armazená-los. As credenciais não são armazenadas como texto simples.

## Testando e-mail OAuth 2.0

Use o controle de e-mail de teste na página de configuração:

* No QlikView Desktop, clique em Testar na página Preferências do Usuário > Email.
* No console de gerenciamento do QlikView, insira um endereço em Enviar E-mail de Teste Para e clique em Enviar.

O QlikView obtém um token OAuth 2.0 e envia o e-mail de teste por meio do Microsoft Graph. Se uma etapa falhar, verifique a mensagem de erro.

## Anexos de arquivo

Quando o QlikView envia e-mails com anexos, ele inclui os anexos inline na solicitação do Microsoft Graph como conteúdo codificado em Base64. Cada anexo é limitado a 3 MB. Para arquivos maiores, use outro método de entrega.

## Solução de problemas

| Erro | Causa | Resolução |
| --- | --- | --- |
| `OAuth 2.0 Client ID, Tenant ID, and Client Secret are required.` | Um ou mais campos OAuth estão vazios. | Verifique se todos os três campos estão preenchidos na página de configurações de e-mail. |
| `OAuth token request failed: AADSTS7000215` | O segredo do cliente é inválido. | Gere um novo segredo do cliente no Microsoft Entra ID e atualize o QlikView. |
| `OAuth token request failed: AADSTS700016` | O ID do aplicativo (cliente) está incorreto ou o aplicativo não existe no locatário especificado. | Verifique a ID do aplicativo (cliente) e a ID do diretório (locatário). |
| `Graph sendMail failed: ErrorAccessDenied` | O aplicativo não possui a permissão `Mail.Send`, ou o consentimento do administrador não foi concedido. | Adicione a permissão de aplicativo `Mail.Send` e conceda consentimento do administrador no Microsoft Entra ID. |
| `Graph sendMail failed: ErrorItemNotFound` | O endereço do remetente não corresponde a uma caixa de correio válida no locatário. | Certifique-se de que o endereço do remetente corresponda a uma caixa de correio existente do Microsoft 365. |
| `Attachment too large` | Um anexo de arquivo excede o limite inline de 3 MB. | Reduza o tamanho do arquivo ou use outro método de entrega. |