Conexão de Email

Introdução

Uma conexão de Email, criada usando o conector de Email, estabelece acesso a um servidor de email. Uma vez que uma conexão é configurada, é possível criar instâncias de atividades de Email associadas a essa conexão para serem usadas como fontes (para fornecer dados em uma operação) ou como alvos (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 a partir de uma destas localizações:

• A aba Pontos de extremidade e conectores do projeto na paleta de componentes de design (veja Paleta de componentes de design).
• A página Pontos de Extremidade Globais (veja Criar um ponto de extremidade global em Pontos de Extremidade Globais).

Uma conexão de Email existente pode ser editada a partir destas localizações:

• A aba Pontos de extremidade e conectores do projeto na paleta de componentes de design (veja Paleta de componentes de design).
• A aba Componentes do painel do projeto (veja Menu de ações de componentes em Aba Componentes do painel do projeto).
• A página Pontos de Extremidade Globais (veja Editar um ponto de extremidade global em Pontos de Extremidade Globais).

Configurar uma conexão de email

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

• Nome da Conexão: Insira um nome para identificar a conexão. O nome deve ser único 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 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: Esta opção está confirmada para funcionar com Microsoft 365 (veja os pré-requisitos). Espera-se que outros servidores de email funcionem, mas não foram testados pela Jitterbit. Quando selecionado, esses campos adicionais para configurar a autenticação OAuth 2.0 ficam visíveis:

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

      Dica

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

    • ID do Inquilino: Insira o ID do inquilino.

    • 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 (Credenciais de Senha de Recurso Proprietário) como o tipo de concessão para autenticação OAuth. Se ROPC (Credenciais de Senha de Recurso Proprietário) for selecionado, você pode especificar uma Senha adicional.

      Importante

      Para enviar emails através do Microsoft 365 (smtp.office365.com), você deve selecionar ROPC (Credenciais de Senha de Recurso Proprietário) para Tipo de Concessão.

    • Senha: Insira uma senha válida. Visível apenas se o Tipo de Concessão estiver definido como ROPC (Credenciais de Senha de Recurso Proprietário).

• Atividade: Selecione o tipo de atividade a ser associada a esta conexão, uma de Ambas, Enviar Email ou Ler Email:

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

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

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

• Host SMTP: Insira o nome do host do servidor de email SMTP. Este campo é exibido apenas se a Atividade selecionada for Ambas ou Enviar 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 apenas se o campo Segurança SMTP abaixo estiver definido como Nenhuma ou TLS. Se o campo Segurança SMTP estiver definido como SSL, então a porta 465 é sempre usada, independentemente do valor inserido no campo Porta SMTP. Este campo é exibido apenas se o tipo de Atividade selecionado acima for Ambas ou Enviar Email.

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

  • Nenhuma: 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: Insira o nome de usuário (se requerido pelo servidor de email SMTP).

• SMTP Password: Insira a senha (se exigida pelo servidor de email SMTP). Visível apenas quando o Tipo de Autenticação está definido como Autenticação Básica.

  Nota

  Ao conectar-se ao Gmail, insira uma senha de app em vez da senha da conta.

• IMAP Host: Insira o nome do host do servidor de email IMAP com o qual se conectar. Este campo é exibido apenas quando a Atividade está definida como Ambas ou Ler Email.

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

• IMAP Security: Quando a Atividade está definida como Ambas ou Ler Email, use o menu para selecionar uma dessas opções:

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

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

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

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

• IMAP Password: Insira a senha (se exigida pelo servidor de email IMAP). Visível apenas quando o Tipo de Autenticação está definido como Autenticação Básica.

  Nota

  Ao conectar-se ao Gmail, insira uma senha de app em vez da senha da conta.

• Use Proxy Settings (Private Agent Only): Ao usar um agente privado, esta configuração pode ser selecionada para usar as configurações de proxy do agente privado. Esta opção é funcional apenas ao usar OAuth 2.0 como o Tipo de Autenticação.

• Test: Clique para verificar a conexão usando a configuração fornecida. Quando a conexão é testada, a versão mais recente do conector é baixada pelos agentes 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 política organizacional 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 apenas 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 da 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 solicita que você confirme 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 (veja Dependências de componentes, exclusão e remoção). Uma mensagem solicita que você confirme que deseja excluir a conexão.

Próximos passos

Após uma conexão de Email ter sido criada, você coloca um tipo de atividade na tela de design para criar instâncias de atividade que serão usadas como fontes (para fornecer dados em uma operação) ou como alvos (para consumir dados em uma operação).

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

Estes tipos de atividade estão disponíveis:

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

• Ler Email: Recupera emails não lidos usando o Protocolo de Acesso a Mensagens da Internet (IMAP) e é destinado a ser usado como uma fonte para fornecer dados a uma operação.