Conexão de e-Email¶

Introdução¶

Uma conexão de e-Email, criada usando o conector de e-Email, estabelece acesso a um servidor de email. Depois que uma conexão é configurada, você pode criar instâncias de atividades de e-Email associadas a essa conexão para serem usadas como fontes (para fornecer dados em uma operação) ou como destinos (para consumir dados em uma operação).

Criar ou editar uma conexão de email¶

Uma nova conexão de e-Email é criada usando o conector de e-Email de um destes locais:

• A aba endpoints e conectores do projeto da paleta de componentes de design (consulte paleta de componentes de design).
• A página Conexões globais (consulte Criar um endpoint global em Conexões Globais).

Uma conexão de e-Email existente pode ser editada nestes locais:

• A aba endpoints e conectores do projeto da paleta de componentes de design (consulte paleta de componentes de design).
• A aba Componentes do painel do projeto (consulte menu de ações do componente na aba Componentes do painel Projeto).
• A página Conexões globais (consulte Editar um endpoint global em Conexões Globais).

Configurar uma conexão de email¶

Cada elemento da interface do usuário da tela de configuração da conexão de e-Email é descrito abaixo.

• Nome da conexão: Insira um nome para usar para identificar a conexão. O nome deve ser exclusivo para cada conexão de e-Email e não deve conter barras. /ou dois pontos :. Este nome também é usado para identificar o endpoint de e-Email, que se refere tanto a uma conexão específica quanto às suas atividades.

• Tipo de autenticação: Selecione o método de autenticação, um de Autenticação básica ou OAuth2:

  • Autenticação básica: Autenticação de servidor SMTP e IMAP com combinações de nome de usuário e senha.

  • OAuth2: Expande opções adicionais para configurar a autenticação OAuth 2.0:

    

    • Host: Insira o hospedar para autenticação OAuth.

      Dica

      Para autenticação OAuth do Microsoft Entra ID, insira https://login.microsoftonline.com como o hospedar.

    • ID do locatário: Insira o ID do locatário.

    • ID do cliente: Insira o ID do cliente.

    • Segredo do cliente: Insira o segredo do cliente.

    • Escopo: Insira o escopo.

    • Tipo de concessão: Selecione Credenciais do cliente (padrão) ou ROPC (Resource Owned Password Credentials) como o tipo de concessão para autenticação OAuth. Se ROPC (Resource Owned Password Credentials) for selecionado, você pode especificar uma Senha adicional.

      Importante

      Para enviar emails pelo Microsoft 365 (smtp.office365.com), ROPC (Resource Owned Password Credentials) deve ser selecionado para Tipo de concessão.

    • Senha: Insira uma senha válida. Visível somente se o Tipo de Concessão estiver definido como ROPC (Resource Owned Password Credentials).

• Atividade: Selecione o tipo de atividade a ser associada a esta conexão, um dos seguintes: Ambos, Enviar e-Email ou Ler e-Email:

  • Ambos: A conexão será associada ao Enviar email e Ler email atividades. Quando Both é selecionado, todos os campos documentados abaixo são exibidos.

  • Enviar e-Email: A conexão será associada apenas à atividade Enviar email. Quando Enviar e-Email é selecionado, somente os campos que começam com SMTP são exibidos na tela de configuração.

  • Ler e-Email: A conexão será associada apenas à atividade Ler email. Quando Ler e-Email é selecionado, somente os campos que começam com IMAP são exibidos na tela de configuração.

• Host SMTP: Insira o nome do hospedar do servidor de email SMTP. Este campo é exibido somente se a Atividade selecionada for Ambos ou Enviar e-Email.

• Porta SMTP: Insira o número da porta do servidor de email SMTP com o qual se conectar. A porta padrão é 25. Um valor neste campo é aplicável somente se o campo Segurança SMTP abaixo estiver definido como Nenhum ou TLS. Se o campo Segurança SMTP estiver definido como SSL, a porta 465 será sempre usada, independentemente do valor inserido no campo Porta SMTP. Este campo será exibido somente se o tipo de Atividade selecionado acima for Ambos ou Enviar e-Email.

• Segurança SMTP: Quando o tipo de Atividade selecionado for Ambos ou Enviar e-Email, use o menu para selecionar Nenhum, SSL ou TLS.

  • Nenhum: O servidor de email não requer autenticação.

  • SSL: O servidor de email usa criptografia SSL para autenticação.

  • TLS: O servidor de email usa criptografia TLS para autenticação.

• Nome de usuário SMTP: Digite o nome de usuário (se exigido pelo servidor de email SMTP).

• Senha SMTP: Insira a senha (se exigido pelo servidor de email SMTP). Visível somente se Tipo de autenticação estiver definido como Autenticação básica.

  Nota

  Ao conectar-se ao Gmail, insira uma senha do aplicativo em vez da senha da conta.

• IMAP Host: Insira o nome do hospedar do servidor de email IMAP com o qual se conectar. Este campo é exibido somente se o tipo de Atividade selecionado acima for Ambos ou Ler e-Email.

• Porta IMAP: Insira o número da porta do servidor de email IMAP com o qual se conectar. A porta padrão é 993. Este campo é exibido somente se o tipo de Atividade selecionado acima for Ambos ou Ler e-Email.

• Segurança IMAP: Quando o tipo de Atividade selecionado for Ambos ou Ler e-Email, use o menu para selecionar Nenhum, SSL ou TLS.

  • Nenhum: O servidor de email não requer autenticação.

  • SSL: O servidor de email usa criptografia SSL para autenticação.

  • TLS: O servidor de email usa criptografia TLS para autenticação.

• Nome de usuário IMAP: Digite o nome de usuário (se exigido pelo servidor de email IMAP).

• Senha IMAP: Insira a senha (se exigido pelo servidor de email IMAP). Visível somente se Tipo de autenticação estiver definido como Autenticação básica.

  Nota

  Ao conectar-se ao Gmail, insira uma senha do aplicativo em vez da senha da conta.

• Usar configurações de proxy (somente Agente privado): Ao usar um agente privado, esta configuração pode ser selecionada para usar configurações de proxy do agente privado. Esta opção só é funcional ao usar o OAuth 2.0 como o Tipo de autenticação.

• Teste: Clique para verificar a conexão usando a configuração fornecida. Quando a conexão é testada, a versão mais recente do conector é baixada pelo(s) agente(s) no grupo de agentes associado ao ambiente atual. Este conector suporta a suspensão do download da versão mais recente do conector usando a Desabilitar atualização automática do conector política da organização. Os campos de nome de usuário e senha para um determinado protocolo são usados para verificação somente se ambos estiverem presentes e o campo de segurança estiver definido como SSL ou TLS.

• Salvar alterações: Clique para salvar e fechar a configuração de conexão.

• Descartar alterações: Após fazer alterações em uma configuração nova ou existente, clique para fechar a configuração sem salvar. Uma mensagem pede para você confirmar que deseja descartar as alterações.

• Excluir: Após abrir uma configuração de conexão existente, clique para excluir permanentemente a conexão do projeto e fechar a configuração (consulte Dependências, exclusão e remoção de componentes). Uma mensagem pede para você confirmar que deseja excluir a conexão.

Próximos passos¶

Após a criação de uma conexão de e-Email, você coloca um tipo de atividade na quadro de design para criar instâncias de atividade a serem usadas como fontes (para fornecer dados em uma operação) ou como destinos (para consumir dados em uma operação).

As ações de menu para uma conexão e seus tipos de atividade são acessíveis a partir do painel do projeto e da paleta de componentes de design. Para obter detalhes, consulte Menus de ações em Noções básicas do conector.

Esses tipos de atividades estão disponíveis:

• Enviar e-Email: Envia email usando o Protocolo Simples de Transferência de Correio (SMTP) para destinatários especificados e deve ser usado como alvo em uma operação.

• Ler e-Email: Recupera email não lidos usando o Internet Message Access Protocol (IMAP) e deve ser usado como uma fonte para fornecer dados a uma operação.