Envio de e-mail com OAuth 2.0 no QlikView
Última atualização: 07/10/2026O 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:
- Entre no portal do Azure e vá para Microsoft Entra ID > Registros de aplicativo > Novo registro.
- Registre o aplicativo.
- Em Certificados & segredos, crie um segredo do cliente e copie seu valor. O valor é exibido apenas uma vez.
- Em Permissões de API, adicione a permissão de aplicativo Mail.Send do Microsoft Graph.
- Conceda consentimento do administrador para a permissão.
- 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. |
