Como usar a action Conectar no package Email

Use a action Conectar no package Email para estabelecer uma conexão com um servidor de e-mail. Esta é a primeira action 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

    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 Email Conectar do action:

    Nota: Se a caixa de correio for usada dentro de uma action Loop, certifique-se de registrar o usuário que está atribuído para executar a automação. Para obter mais informações, consulte Manage users and groups assignment to an application.
  • Gmail
    • Se você usar o modo de autenticação Código de autorização com PKCE, execute as seguintes etapas:
      1. Defina as configurações do OAuth 2.0 no Google Cloud Platform (GCP) e busque as credenciais obrigatórias para conectar o Automation 360 aos aplicativos do Google Workspace.
      2. Certifique-se de criar um projeto.

        Consulte Como criar um projeto.

      3. Gere o ID e o segredo do cliente.
        Consulte Como configurar OAuth 2.0.
        Nota:
        • Selecione a opção Aplicação Web.
        • Adicione o URI de redirecionamento autorizado: http://localhost:8888/Callback.
      4. Conclua estas etapas para configurar o consentimento do usuário para o nome de usuário que você usará para se conectar com a Automation 360.
    • Se você usar o modo de autenticação Gerenciada pela Control Room, execute estas etapas:
      Importante: No momento, o Email package é compatível com a opção Gerenciada pela Control Room do OAuth para conexões OAuth baseadas apenas no Fluxo de código de autorização.
      1. Defina as configurações do OAuth 2.0 no Google Cloud Platform (GCP) e busque as credenciais obrigatórias para conectar o Automation 360 aos aplicativos do Google Workspace.
      2. Certifique-se de criar um projeto.

        Consulte Como criar um projeto.

      3. Gere o ID e o segredo do cliente.
        Consulte Como configurar OAuth 2.0.
        Nota:
        • Selecione a opção Aplicação Web.
        • Para adicionar o URI de redirecionamento autorizado, execute estas etapas:
          1. Faça login na Control Room como administrador ou qualquer usuário com permissões Gerenciar conexões e Exibir conexões. Depois, acesse Gerenciar > Conexões OAuth.
          2. Clique na guia Criar conexão e selecione a opção Personalizado no campo Tipo de provedor.
          3. Copie o URL de retorno de chamada e volte para a página do aplicativo cliente no Console do Google Cloud.
          4. Clique no botão + ADICIONAR URI em URIs de redirecionamento autorizado e cole o URI no campo URIs.
          5. Clique em Create (Criar).

          Para saber como criar uma conexão OAuth na Control Room, consulte Criar a conexão de OAuth.

      4. Conclua estas etapas para configurar o consentimento do usuário para o nome de usuário que você usará para se conectar com a Automation 360.
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.
Recomendado: Se quiser utilizar os dois modos de autenticação (credenciais de cliente e código de autorização com PKCE), inscreva-se em dois aplicativos separados.
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 MFA não for desabilitada por completo, 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 action 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 Email actions, 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:

Nota: Ao criar uma automação na plataforma macOS e estabelecer uma conexão com um servidor de e-mail, o Outlook não é compatível com o macOS. Você pode usar o Microsoft Outlook (macOS) package para automatizar tarefas relacionadas a e-mail no aplicativo cliente do Microsoft Outlook.

Microsoft Outlook (macOS) package

  1. Na paleta Actions , clique duas vezes ou arraste a action Conectar do package Email .
  2. Insira um nome de sessão.
  3. 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.
    Nota:
    • Quando você se conecta ao servidor EWS e usa a action Loop para recuperar todos os e-mails do servidor de e-mail, e se o assunto do e-mail contiver os seguintes caracteres, o bot falha na execução e exibe uma mensagem de erro.
      • Caracteres de controle
        • Intervalo: 0x00 – 0x08 (exceto 0x09 – Horizontal Tab) e 0x0B – 0x0C (exceto 0x0A – Line Feed e 0x0D – Carriage Return)
        • Valores hexadecimais: 0x00-0x08, 0x0B-0x0C, 0x0E-0x1F
      • Pares substitutos altos e baixos
        • Intervalo: 0xD800 – 0xDFFF
        • Valores hexadecimais: 0xD800 – 0xDFFF
      • Pontos de código sem caracteres
        • Intervalo: 0xFDD0 – 0xFDEF, 0xFFFE – 0xFFFF
        • Valores hexadecimais: 0xFDD0 – 0xFDEF, 0xFFFE – 0xFFFF
      • Intervalos restritos
        • Intervalo: 0x1FFFE – 0x1FFFF, 0x2FFFE – 0x2FFFF, 0x3FFFE – 0x3FFFF, 0x4FFFE – 0x4FFFF, 0x5FFFE – 0x5FFFF, 0x6FFFE – 0x6FFFF, 0x7FFFE – 0x7FFFF, 0x8FFFE – 0x8FFFF, 0x9FFFE – 0x9FFFF, 0xAFFFE – 0xAFFFF, 0xBFFFE – 0xBFFFF, 0xCFFFE – 0xCFFFF, 0xDFFFE – 0xDFFFF, 0xEFFFE – 0xEFFFF, 0xFFFFE – 0xFFFFF, 0x10FFFE – 0x10FFFF
        • Valores hexadecimais: 0x1FFFE – 0x1FFFF, 0x2FFFE – 0x2FFFF, 0x3FFFE – 0x3FFFF, 0x4FFFE – 0x4FFFF, 0x5FFFE – 0x5FFFF, 0x6FFFE – 0x6FFFF, 0x7FFFE – 0x7FFFF, 0x8FFFE – 0x8FFFF, 0x9FFFE – 0x9FFFF, 0xAFFFE – 0xAFFFF, 0xBFFFE – 0xBFFFF, 0xCFFFE – 0xCFFFF, 0xDFFFE – 0xDFFFF, 0xEFFFE – 0xEFFFF, 0xFFFFE – 0xFFFFF, 0x10FFFE – 0x10FFFF

          Alternativa: Você pode usar o Microsoft Outlook ou o servidor de e-mail para realizar essa operação. No entanto, recomendamos usar o package Microsoft 365 Outlook, já que a Microsoft anunciou a descontinuação para as APIs EWS que são usadas para se conectar ao Exchange Online. Consulte Depreciação da APIs EWS no Exchange Online

    • 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.
      • 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.

      É possível usar a opção de variável para especificar o endereço de e-mail ao qual deseja se conectar.

      Nota: Não é possível estabelecer uma conexão com o novo cliente do Outlook. No entanto, é possível mudar para o cliente clássico do Outlook para automatizar uma tarefa relacionada a e-mails.
    • 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.
        Nota: Regex é compatível com o protocolo IMAP e lê e-mails de todas as subpastas da Caixa de entrada.
      • 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: Consulte Microsoft identity platform and OAuth 2.0 authorization code flow

          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 How to setup App in Azure and Exchange Online to use OAuth 2.0 Client Credentials Flow for IMAP/POP3 Mail Server (A-People login required).

        • OAuth2 – Credenciais de clientes: Consulte Microsoft identity platform and the OAuth 2.0 client credentials flow

          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 How to setup App in Azure and Exchange Online to use OAuth 2.0 Client Credentials Flow for IMAP/POP3 Mail Server (A-People login required).

        • Control Room gerenciada:
          Para usar o modo de autenticação OAuth2 gerenciado da Control Room para automatizar o Gmail, é obrigatório configurar a conexão OAuth na Control Room. Consulte Criar a conexão de OAuth.
          Nota: Control Room O OAuth Managed oferece suporte apenas para o Gmail e não para o cliente Outlook.

          Atualize as informações nos seguintes campos:

          • Conexão: Clique no botão Escolher para selecionar um tipo de conexão.
          • Selecione Personalizado no campo Tipo de provedor.

          • Selecione o nome da conexão que configurou na Control Room para aplicativos do Google Workspace.

          • Use o campo Tipo de token para selecionar uma das seguintes opções:

            Para informações sobre os tokens de acesso e atualização do aplicativo Google Workspace, consulte Configurar aplicativos corporativos

            • Compartilhado: Selecione essa opção quando o token de acesso do OAuth2 for compartilhado para todos os usuários que executam a automação.
              Nota: A opção exige que o administrador ou qualquer usuário da Control Room (com as opções Gerenciar conexões e Exibir conexões habilitadas para CONEXÕES OAUTH) configure uma conexão do OAuth na Control Room. Salve as credenciais de login uma vez para gerar um token de acesso compartilhado que possa ser usado por todos os usuários que executam a automação.
            • Específico do usuário: Selecione esta opção quando o token de acesso do OAuth2 for específico para cada usuário que executa a automação.
              Nota: A opção exige que o administrador ou qualquer usuário da Control Room (com as opções Gerenciar conexões e Exibir conexões habilitadas para CONEXÕES OAUTH) configure uma conexão do OAuth na Control Room. Certifique-se de não salvar as credenciais de login para que cada usuário que executa a automação possa fornecer as próprias credenciais de login e gerar um token de acesso que só possa ser usado pelo usuário específico.
            • Clique em Confirmar.
          Nota: Ao usar a opção Específico do usuário, faça login em sua conta do Google para autenticar e gerar um token específico do usuário. Execute as seguintes etapas para usar esta opção:
          1. Na Control Room, navegue até seu perfil Minhas configurações > Conexões OAuth.
          2. Clique em Login para autenticar.
          3. Faça login em sua conta do Google e selecione Continuar.
          4. Verifique os serviços aos quais você tem acesso e clique em Continuar.

            Se a conexão for bem-sucedida, o status será exibido como Ativo.

        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 Azure portal.
        • 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 Microsoft 365 e deixar este campo em branco, o Automation Workspace usará smtp.office365.com para se conectar ao servidor.
        • Se você for cliente do Microsoft 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 Microsoft 365, precisará inserir o nome do domínio de sua organização. Caso contrário, o Automation Workspace 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.

        Se você tiver problemas para se conectar à caixa de correio compartilhada usando EWS, consulte Unable to connect to shared mailbox using EWS error (A-People login required).

        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 Azure portal.
        • 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.
      • Duração do tempo limite da conexão (segundos) (Opcional): Neste campo, especifique o tempo necessário para estabelecer uma conexão com o servidor EWS. Você pode definir o valor do tempo limite entre 10 e 60 segundos. Por padrão, o campo Duração do tempo limite de conexão (segundos) (opcional) é definido para 10 segundos.
  4. Clique em Salvar.