Como usar a ação Conectar para o E-mail

Use a ação Conectar para estabelecer uma conexão com um servidor de e-mail. Esta é a primeira ação que você deve usar para automatizar uma tarefa relacionada a e-mail.

Pré-requisitos

Você pode usar o OAuth 2.0 para fazer a autenticação com o servidor de e-mail para automação de e-mail. Com base em seu provedor de serviços de e-mail, execute as etapas relevantes:

Outlook/Office 365
- Se você usar o modo de autenticação Fluxo de credenciais do cliente, execute as seguintes etapas:
  1. Faça login no Portal do Azure Microsoft.
  2. Registre seu aplicativo na plataforma Microsoft Identity para obter a ID do cliente e a ID do locatário. Consulte Registrar um aplicativo.
  3. Adicione um segredo do Client. Consulte Adicionar uma senha do cliente.
  4. Com base no servidor de e-mail ao qual você se conecta, execute as etapas relevantes:
    - IMAP/POP3
      Adicione as permissões POP e IMAP ao seu aplicativo AAD. Consulte Autenticar uma conexão IMAP, POP ou SMTP usando o OAuth.
    - EWS
      - Configurar para autenticação somente de aplicativo. Consulte Configurar para autenticação somente de aplicativo.
      - Configure uma política de acesso a aplicativos e limite o escopo das permissões de aplicativos. Consulte Configurar a política de acesso ao aplicativo.
- Se você usar o modo de autenticação Código de autorização com PKCE, execute as seguintes etapas:
  1. Faça login no Portal do Azure Microsoft.
  2. Registre seu aplicativo na plataforma Microsoft Identity para obter a ID do cliente e a ID do locatário. Consulte Registrar um aplicativo.
  3. Ao registrar o aplicativo, defina o URI de redirecionamento para http://localhost:9999/callback.
  4. Adicione permissões com o tipo delegado para IMAP, POP3 e SMTP e conceda ao aplicativo a permissão necessária para o Microsoft Graph.
Os vídeos na lista de reprodução a seguir fornecem informações sobre como configurar e usar a autenticação OAuth 2.0 na ação Conectar E-mail:
<span>Lista de reprodução para configurar a autenticação OAuth2 no pacote de e-mail</span>
Nota: Se a caixa de correio for usada dentro de uma ação Loop, certifique-se de registrar o usuário que está atribuído para executar a automação. Para obter mais informações, consulte Gerenciar a atribuição de usuários e grupos a um aplicativo.
Gmail
Para autorizar seu aplicativo com o Gmail usando o método de autenticação Código de autorização com PKCE, execute as seguintes etapas:
Nota:
- O fluxo de credenciais do cliente não suporta o Gmail.
- As credenciais do cliente e o código de autorização com os modos de autenticação PKCE não suportam servidores de e-mail Yahoo e MSN.

Important: Se quiser utilizar tanto o modo de autenticação (credenciais de cliente e código de autorização com PKCE), inscreva-se em duas aplicações separadas.

Nota: Quando você se conecta a um servidor Exchange Web Services, a autenticação multifator (MFA) deve ser desativada, inclusive em todas as políticas de segurança de nível organizacional onde a MFA pode ser habilitada. Se a autenticação multifator não for completamente desabilitada, os usuários poderão ter erros de conexão ou autorização. No entanto, se você ainda quiser utilizar a MFA, reveja as informações contidas neste artigo (esteja ciente de que uma conexão bem-sucedida não é garantida:

Autenticação multifator para Azure EWS (login no A-People necessário)

Essa ação permite que você forneça as credenciais e os detalhes do servidor de e-mail e as associe a um nome de sessão. Use esse mesmo nome de sessão para outras ações E-mail, de modo que você só precisará fornecer as informações do servidor uma vez.

Procedimento

Para estabelecer uma conexão com um servidor de e-mail, siga estas etapas:

Na paleta Ações, clique duas vezes ou arraste a ação Conectar do pacote E-mail.
Insira um nome de sessão.
Na opção Outlook, Servidor de e-mail ou EWS, especifique se deseja estabelecer uma conexão com o Microsoft Outlook ou um servidor de e-mail.
Quando você estabelece uma conexão com o Microsoft Outlook, as mensagens de e-mail são processadas na caixa de correio compartilhada. Certifique-se de ter configurado a caixa de correio compartilhada em seu aplicativo Outlook.
Nota:
- Este recurso é suportado apenas para o Outlook.
- Você pode selecionar apenas uma caixa de correio da lista de caixas de correio na caixa de correio compartilhada.
- O convite para a reunião não é lido no Outlook porque o bot não seleciona os convites de calendário como objetos de e-mail. Esta característica não é suportada atualmente.
- Se você selecionar a opção Outlook, você não precisará fornecer nenhum detalhe adicional.
- Se você selecionar a opção Servidor de e-mail, você deverá preencher os seguintes campos:
  Nota: para obter informações sobre o host e a porta que serão usados para os vários servidores de e-mail, consulte Configurações do servidor de e-mail.
  - Usar conexão segura (SSL/TLS): selecione esta opção se quiser usar uma conexão segura com o servidor de e-mail.
  - Host: Insira o nome do servidor do e-mail.
    Nota: Esse campo não diferencia maiúsculas de minúsculas.
  - Porta: Insira o número da porta do servidor.
  - Protocolo: Selecione o protocolo IMAP ou POP3.
  - Modo de autenticação: Escolha entre as seguintes configurações avançadas:
    - básico: Use o nome de usuário e a senha
    - OAuth2 - Código de autorização com PKCE: Ver Plataforma de identidade da Microsoft e fluxo de código de autorização OAuth 2.0
      Para obter mais informações sobre como configurar o aplicativo no Azure para usar o código de autorização OAuth com fluxo PKCE para servidor de e-mail, consulte Como configurar o aplicativo no Azure e no Exchange Online para usar o OAuth 2.0 fluxo de credenciais do cliente para o servidor de e-mail IMAP/POP3 (é necessário o login do A-People).
    - OAuth2 - Credenciais de clientes: Ver A plataforma de identidade da Microsoft e o fluxo de credenciais do cliente OAuth 2.0
      Para obter mais informações sobre como configurar um aplicativo no Azure para usar o fluxo de credenciais do cliente OAuth 2.0 para servidor de e-mail IMAP/POP3, consulte Como configurar o aplicativo no Azure e no Exchange Online para usar o OAuth 2.0 fluxo de credenciais do cliente para o servidor de e-mail IMAP/POP3 (é necessário o login do A-People).
    Dependendo do modo de autenticação selecionado, você deve especificar os detalhes nos campos a seguir, conforme aplicável.
    - Nome de usuário: Insira o nome de usuário que deseja usar para acessar o servidor de e-mail.
      Por exemplo, john.smith@myCompanyName.com
    - Senha: Insira a senha para o nome de usuário que você forneceu.
    - Para os campos Identificação do cliente, Identificação do locatário, URI redirecionado e Segredo do cliente insira as informações que são fornecidas para sua conta em seu Portal do Azure.
    - Provedor de e-mail: Selecione seu provedor de serviços de e-mail na lista suspensa.
      
      Outlook/Office365
      Se você selecionar essa opção, forneça o ID do locatário.
      
      Gmail
    Para os campos Nome do usuário, Senha, ID do locatário, ID do cliente, e Segredo do cliente, escolha entre as guias Credencial, Variável ou String insegura:
    - Credencial: Use um valor disponível no cofre de credenciais.
    - Variável: Use uma variável definida pelo usuário que armazene os valores.
    - String insegura: Insira um valor manualmente.
- Se você selecionar a opção EWS, preencha os seguintes campos:
  - Versão do Exchange: selecione a versão que sua organização está usando:
    - Exchange Server 2013
    - Exchange2010_SP2
    - Exchange2010_SP1
    - Exchange2010
    - Exchange2007_SP1
  - Nuvem da Azure: selecione a versão que sua organização está usando:
    - Azure Global: para clientes da versão comercial do Microsoft 365 (login.microsoftonline.com)
    - Azure US GCC High: para clientes da versão governamental do Microsoft 365 (login.microsoftonline.us)
  - Opcional: Nome do domínio:
    - se você for cliente do Office 365 e deixar este campo em branco, o Automatize o espaço de trabalho usará smtp.office365.com para se conectar ao servidor.
    - Se você for cliente do Office 365 e tiver inserido um nome de domínio no campo Nome de usuário, você precisará inserir smtp.office365.com nesse campo.
    - Se você não for um cliente do Office 365, precisará inserir o nome do domínio de sua organização. Caso contrário, o Automatize o espaço de trabalho usará o nome de domínio fornecido no campo Nome de usuário.
  - Modo de autenticação: Escolha entre as seguintes configurações avançadas:
    Nota: A partir do Automation 360 v.27 ou posterior, o tipo de autorização OAuth2-Modo de autenticação silenciosa é renomeado para OAuth2-ROPC e o Modo de autenticação OAuth2-Interativo é renomeado para OAuth2-Implícito.
    - básico: Use o nome de usuário e a senha
    - OAuth2-ROPC: Ver Plataforma de identidade da Microsoft e credenciais da senha do proprietário do recurso OAuth 2.0
    - OAuth2 - Implícito: Ver Plataforma de identidade da Microsoft e fluxo de concessão implícito
    - OAuth2 - Código de autorização com PKCE: Ver Plataforma de identidade da Microsoft e fluxo de código de autorização OAuth 2.0
      Para obter mais informações sobre como configurar um aplicativo no Azure para usar o código de autorização OAuth com fluxo PKCE para EWS, consulte Como configurar o aplicativo no Azure para usar o código de autorização OAuth com o fluxo PKCE para EWS (é necessário o login do A-People).
    - OAuth2 - Credenciais de clientes: Ver A plataforma de identidade da Microsoft e o fluxo de credenciais do cliente OAuth 2.0
      Para obter mais informações sobre como configurar um aplicativo no Azure e no Exchange Online para usar OAuth 2.0 – Fluxo de credenciais do cliente para servidor EWS, consulte Como configurar o aplicativo no Azure e no Exchange Online para usar o OAuth 2.0 - fluxo de credenciais do cliente para o servidor EWS (é necessário o login do A-People).
    Se você tiver problemas para se conectar à caixa de correio compartilhada usando EWS, consulte Não é possível conectar-se à caixa de correio compartilhada usando o erro EWS (é necessário fazer login no A-People).
    Dependendo do modo de autenticação selecionado, você deve especificar os detalhes nos campos a seguir, conforme aplicável.
    - Nome de usuário: Insira o nome de usuário que deseja usar para acessar o servidor de e-mail.
      Por exemplo, john.smith@myCompanyName.com
    - Senha: Insira a senha para o nome de usuário que você forneceu.
    - Para os campos Identificação do cliente, Identificação do locatário, URI redirecionado e Segredo do cliente insira as informações que são fornecidas para sua conta em seu Portal do Azure.
    - Testar conexões: Clique em Testar conexão para entrar em sua conta, aceitar as permissões solicitadas de autenticação e estabelecer uma conexão com o servidor.
      Nota:
      
      Quando você executa uma operação de desktop e clica em Testar conexão, variáveis como (Credencial, variável de credencial ou variáveis de string) não são compatíveis no momento.
      
      Quando você executar a operação da área de trabalho e clicar em Testar conexão para entrar em sua conta, adicione este URI de redirecionamento: https://outlook.office365.com
    Para os campos Nome do usuário, Senha, ID do locatário, ID do cliente, e Segredo do cliente, escolha entre as guias Credencial, Variável ou String insegura:
    - Credencial: Use um valor disponível no cofre de credenciais.
    - Variável: Use uma variável definida pelo usuário que armazene os valores.
    - String insegura: Insira um valor manualmente.
Clique em Salvar.

Automation 360

Como usar a ação Conectar para o E-mail