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

You can use OAuth 2.0 to authenticate with the email server for email automation. Based on your email service provider, perform the relevant steps:

Outlook/Office 365
- If you use Client credentials flow authentication mode, then perform the following steps:
  1. Log in to the Microsoft Azure portal.
  2. Register an application with the Microsoft identity platform to obtain the client ID and tenant ID. See Register an application.
  3. Add a Client secret. See Add a client secret.
  4. Based on which mail server you connect to, perform the relevant steps:
    - IMAP/POP3
      Add the POP and IMAP permissions to your AAD application . See Authenticate an IMAP, POP or SMTP connection using OAuth.
    - EWS
      - Configure for app-only authentication. See Configure for app-only authentication.
      - Configure an application access policy and limit the scope of application permissions. See Configure application access policy.
- If you use the Authorization code with PKCE authentication mode, then perform the following steps:
  1. Log in to the Microsoft Azure portal.
  2. Register an application with the Microsoft identity platform to obtain the client ID and tenant ID. See Register an application.
  3. When registering the application, set the redirect URI to http://localhost:9999/callback.
  4. Add permissions with type delegated for IMAP, POP3, and SMTP and grant the application the required permission for Microsoft Graph to the application.
Gmail
To authorize your application with Gmail using the Authorization code with PKCE authentication method, perform the following steps:
1. Configure the OAuth2.0 settings in the Google Cloud Platform (GCP) and retrieve the necessary credentials to connect Automation 360 with your G Suite applications.
2. If you have not already done so, create a project.
3. To generate the Client ID and Client secret, complete the steps in Setting up OAuth 2.0.
  Nota:
  - Select the Web application option.
  - Add this authorized redirect URI: http://localhost:8888/Callback.
4. Complete the steps to set up user consent for the username that you will use to connect to the Automation 360.
Nota:
- Client Credentials flow does not support Gmail.
- The Client Credentials and Authorization code with PKCE authentication modes do not support Yahoo and MSN mail servers.

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:

Multi-factor authentication for Azure EWS (A-people login required)

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.
  - Authentication mode: Choose from the following authentication modes:
    - Basic: Uses the username and password.
    - OAuth2 – Authorization code with PKCE: See Microsoft identity platform and OAuth 2.0 authorization code flow
    - OAuth2 – Client credentials: See Microsoft identity platform and the OAuth 2.0 client credentials flow
    Depending on the authentication mode that you selected, you must specify the details in the following fields as applicable.
    - Username: Enter the username that you want to use to access the mail server.
      For example, john.smith@myCompanyName.com
    - Password: Enter the password for the username you provided.
    - For Client ID, Tenant ID, Redirect URI, and Client secret fields, enter the information that is provided for your account on your Azure portal.
    - Email provider: Select your email service provider from the drop-down list.
      
      Outlook/Office365
      If you select this option, then provide the Tenant ID.
      
      Gmail
    For Username, Password, Tenant ID, Client ID, and Client secret fields, choose from Credential, Variable, or Insecure string tab:
    - Credential: Use a value available in the credential vault.
    - Variable: Use a user-defined variable that stores the values.
    - Insecure string: Manually enter a value.
- 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 Espaço de trabalho RPA 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 Espaço de trabalho RPA usará o nome de domínio fornecido no campo Nome de usuário.
  - Authentication mode: Choose from the following authentication modes:
    Nota: From Automation 360v.27 or later, the authorization type OAuth2-Silent authentication mode is renamed to OAuth2-ROPC, and the OAuth2-Interactive authentication mode is renamed to OAuth2-Implicit.
    - Basic: Uses the username and password.
    - OAuth2-ROPC: See Microsoft identity platform and OAuth 2.0 Resource Owner Password Credentials
    - OAuth2-Implicit: See Microsoft identity platform and implicit grant flow
    - OAuth2 – Authorization code with PKCE: See Microsoft identity platform and OAuth 2.0 authorization code flow
    - OAuth2 – Client credentials: See Microsoft identity platform and the OAuth 2.0 client credentials flow
    Depending on the authentication mode that you selected, you must specify the details in the following fields as applicable.
    - Username: Enter the username that you want to use to access the mail server.
      For example, john.smith@myCompanyName.com
    - Password: Enter the password for the username you provided.
    - For Client ID, Tenant ID, Redirect URI, and Client secret fields, enter the information that is provided for your account on your Azure portal.
    - Test connection: Click Test connection to sign in to your account, accept the permissions requested to authenticate, and establish a connection with the server.
      Nota: When you perform desktop operation and click Test connection to sign in to your account, then add this redirect URI: https://outlook.office365.com.
    For Username, Password, Tenant ID, Client ID, and Client secret fields, choose from Credential, Variable, or Insecure string tab:
    - Credential: Use a value available in the credential vault.
    - Variable: Use a user-defined variable that stores the values.
    - Insecure string: Manually enter a value.
Clique em Salvar.

Automation 360