Conexão de Email

Introdução

Uma conexão de Email, criada usando o conector de Email, estabelece acesso a um servidor de email. Após a configuração de uma conexão, você pode criar instâncias de atividades de Email associadas a essa conexão para serem usadas como origens (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 Email é criada usando o conector de 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 Global Endpoints (consulte Criar um endpoint global em Endpoints globais).

Uma conexão de 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 Endpoints globais (consulte Editar um endpoint global em Endpoints globais).

Configurar uma conexão de email

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

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

• Tipo de autenticação: Selecione o método de autenticação, um dos Aut. 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: Esta opção está confirmada para funcionar com o Microsoft 365 (consulte os pré-requisitos). Espera-se que outros servidores de email funcionem, mas não foram testados pelo Jitterbit. Quando selecionados, estes campos adicionais para configurar a autenticação OAuth 2.0 ficam visíveis:

    

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

      !!! tip "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: Digite o segredo do cliente.

    • Escopo: Insira o escopo.

    • Tipo de Concessão: Selecione Credenciais do Cliente (padrão) ou ROPC (Credenciais de Senha de Propriedade do Recurso) como o tipo de concessão para autenticação OAuth. Se ROPC (Credenciais de Senha de Propriedade do Recurso) estiver selecionado, você poderá especificar uma Senha adicional.

      !!! important "Importante" Para enviar emails pelo Microsoft 365 (smtp.office365.com), você deve selecionar ROPC (Resource Owned Password Credentials) para Tipo de concessão.

    • Senha: Digite uma senha válida. Visível somente se o Tipo de Concessão estiver definido como ROPC (Credenciais de Senha de Propriedade do Recurso).

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

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

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

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

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

• Porta SMTP: Insira o número da porta do servidor de email SMTP com o qual deseja se conectar. A porta padrão é 25. Um valor neste campo será 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 Email.

• Segurança SMTP: Quando Atividade estiver definida como Ambos ou Enviar Email, use o menu para selecionar uma destas opções:

  • 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: Digite a senha (se exigido pelo servidor de email SMTP). Visível somente quando o Tipo de Autenticação estiver definido como Aut. Básica.

  Nota

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

• Host IMAP: Insira o nome do hospedar do servidor de email IMAP com o qual deseja se conectar. Este campo é exibido somente quando Atividade está definido como Ambos ou Ler Email.

• Porta IMAP: Insira o número da porta do servidor de email IMAP com o qual deseja se conectar. A porta padrão é 993. Este campo é exibido somente quando a Atividade está definida como Ambos ou Ler Email.

• Segurança IMAP: Quando Atividade estiver definida como Ambos ou Ler Email, use o menu para selecionar uma destas opções:

  • 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: Digite a senha (se exigida pelo servidor de email IMAP). Visível somente quando o Tipo de Autenticação estiver definido como Aut. 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 permite suspender o download da versão mais recente do conector usando a política da organização Desativar Atualização Automática do Conector. 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 solicitará que você confirme se 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 solicitará que você confirme se deseja excluir a conexão.

Próximos passos

Após a criação de uma conexão de 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 podem ser acessadas no painel do projeto e na 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 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 Email: Recupera email não lidos usando o Protocolo de Acesso a Mensagens da Internet (IMAP) e deve ser usado como uma fonte para fornecer dados a uma operação.