Integração do Exchange

Integração do Exchange para Extração e Processamento Inteligente (IXP) no Automation Cloud para sincronizar dados de e-mail com o Communications Mining, incluindo detalhes de cobrança e visão geral da configuração.

AVISO:

A Microsoft vai descontinuar o Exchange Web Services (EWS) para o Exchange Online em 1º de outubro de 2026 (anúncio da Microsoft). Recomendamos trocar suas integrações do Exchange para a API do Microsoft Graph o mais rápido possível. Para as etapas de migração, consulte o guia de migração da API do EWS para o Microsoft Graph.

Visão geral

A integração do Exchange fornece uma maneira conveniente e fácil de configurar para sincronizar seus dados de email de desenvolvimento e produção no Communications Mining™ em tempo real.

Observação:

Será cobrado 1 AI Unit ou 0,2 Platform Units por comentário criado ou por comentário atualizado, com base no ID da mensagem do email, se seu texto foi modificado.

A integração do Exchange pesquisa continuamente seu servidor do Exchange em busca de novos e-mails nas caixas de correio configuradas. Os e-mails são limpos, enriquecidos e convertidos em objetos de comentário do Communications Mining e podem ser acessados por usuários na plataforma web do Communications Mining e por aplicativos ou bots por meio da API do Communications Mining. A integração do Exchange é executada na nuvem do Communications Mining.

As caixas de correio a serem pesquisadas podem ser configuradas de forma conveniente na interface do usuário do Communications Mining, que também oferece a funcionalidade de iniciar ou interromper a integração, além de atualizar os parâmetros de configuração usados para se conectar ao seu Exchange Server.

Observação:

• A integração do Exchange é compatível com o Exchange Online e com o servidor do Microsoft Exchange 2010-2019 usando o Exchange Web Services (EWS).
• A integração do Exchange pesquisa o servidor do Exchange fazendo solicitações GET autenticadas no HTTPS. A integração do Exchange recebe dados por meio das solicitações GET que ela inicia e não aceita nenhuma conexão de entrada iniciada em outro lugar. A integração do Exchange pode ser configurada com cifras específicas.
• É suficiente dar à integração do Exchange acesso somente de leitura para suas caixas de correio.

Como os e-mails são sincronizados

A integração sincronizará continuamente e-mails de cada caixa de correio configurada. Se não for informado o horário de início, todos os emails serão sincronizados.

A integração definirá o message_id do comentário como o comment ID codificado em hexadecimal do e-mail sincronizado. Se várias caixas de correio contendo o mesmo email, por exemplo, devido a serem adicionadas ao campo CC do mesmo email, forem sincronizadas no mesmo bucket, o comentário resultante terá os metadados da última sincronização dos emails duplicados.

A integração atualizará a propriedade Pasta do usuário de um comentário quando o e-mail correspondente for movido para uma pasta diferente. A integração não atualizará o assunto ou o corpo do comentário se algo estiver atualizado no e-mail após ele ter sido enviado ou recebido.

Você também pode habilitar a sincronização de anexos no nível da caixa de correio em uma integração do Exchange. A API de streams torna os anexos recuperáveis por meio de uma referência de anexo. Verifique mais sobre a sincronização de anexos nas páginas Anexos e Usando integrações do Exchange .

A imagem a seguir contém um exemplo de uma configuração de caixa de correio com os valores:

• Bucket: caixa de correio (org2/example-2b2f8982)

• Regras de filtro de conteúdo:

  • Pastas explicitamente permitidas: raiz/Superior do repositório de informações/Caixa de entrada
  • Pastas negadas explicitamente: nenhuma
  • A partir de 1º de fevereiro de 2023, 12h UTC
  Observação:

  Você deve expressar a parte superior do repositório de informações no idioma do Exchange Server, não no idioma do usuário.

  Ao aplicar filtros de pastas, certifique-se de levar em consideração o seguinte:

  • Pastas aninhadas são separadas por uma barra /.
  • As pastas visíveis no Outlook normalmente têm o prefixo root/Top of Information Store.
  • Permitir pastas significa que as pastas não permitidas explicitamente são negadas.
  • É possível negar uma pasta dentro de uma pasta permitida.
  • Não é possível permitir uma pasta dentro de uma pasta negada.
  Dica:

  Restrinja o escopo do filtro de pasta ao mínimo necessário para seu caso de uso. Se você deixar as pastas Permitidas vazias, a integração será sincronizada continuamente a partir de todas as pastas na caixa de correio — incluindo Arquivar e Itens Recuperáveis (limpezas) — o que desacelera a sincronização drasticamente. Para a maior parte do processamento BUI, permita apenas:

  • root/Top of Information Store/Inbox
  • root/Top of Information Store/Sent Items

  

Erros de integração

As integrações que apresentam problemas persistentes serão desabilitadas automaticamente no nível de integração se a integração estiver configurada incorretamente, ou no nível de caixa de correio, se a caixa de correio estiver configurada incorretamente.

Você receberá uma notificação para resolver um ou mais problemas e, depois que forem resolvidos, você poderá reativar a integração.

Isso acontece quando a caixa de correio não pode ser encontrada, caso tenha sido excluída, a conta de serviço não tenha acesso à Caixa de entrada ou as credenciais expiraram e precisam ser atualizadas.

Exemplos de erros que desabilitam a integração incluem:

• Credenciais incorretas
• Credenciais expiradas
• Atingindo um limite de cota para upload de dados
• Configuração incorreta dos detalhes do Exchange Server

Exemplos de erros que desabilitam uma caixa de correio incluem:

• Permissões inválidas para a autenticação da conta de serviço ou do aplicativo
• Endereço da caixa de correio com erros de ortografia
• Caixa de correio excluída

Assinando notificações

Você receberá uma assinatura automática de alertas e notificações de erros de integração se tiver uma das seguintes funções:

• Administrador de Projeto de Extração e Processamento Inteligente
• Treinador de modelos do IXP
• Desenvolvedor de Extração e Processamento Inteligente
• Visualizador de Extração e Processamento Inteligente
• Analista de Extração e Processamento Inteligente

Você também pode fazer autoinscrição ou cancelar a assinatura por meio do Serviço de Notificação. Para gerenciar suas preferências de notificação, consulte Gerenciamento de notificações.

Para atualizar as configurações de integração, são necessárias as funções IXP Project Admin ou IXP Developer .

Configuração

Exchange Online

Siga um dos guias passo a passo:

• Integração do Exchange com Autenticação de Aplicativo do Azure
• Integração do Exchange com usuário do serviço do Azure

Exchange Server auto-hospedado

Os servidores do Exchange auto-hospedados são compatíveis apenas com a API do EWS com autenticação NTLM. A autenticação OAuth, com um segredo do cliente ou uma chave privada, está disponível apenas para o Exchange Online.

Configure uma conta de serviço NTLM e conceda ao usuário de serviço acesso de leitura delegado às caixas de correio que você deseja sincronizar.

Observação:

A integração do Exchange é executada no UiPath Automation Cloud™, então seu ponto de extremidade do EWS deve ser acessível a partir da internet e resolvido para um endereço IP público.

Colete os seguintes detalhes:

• Ponto de extremidade do EWS - o URL completo do serviço do EWS em seu servidor do Exchange. O caminho deve terminar com /EWS/Exchange.asmx, por exemplo, https://mail.example.com/EWS/Exchange.asmx.
• Nome de usuário e senha do usuário do serviço.
• Uma caixa de correio de teste que o usuário do serviço pode acessar, usada para verificar as credenciais quando você as salva.
• Opcionalmente, o número de compilação do seu Exchange Server.
• Lista de caixas de correio a serem sincronizadas.

Para configurar a integração no Communications Mining™:

1. Navegue até a página Administração e selecione a guia Integrações .
2. Selecione Nova integração.
3. Em Conecte-se com seu aplicativo, selecione API do EWS.
4. Selecione Com NTLM e insira o ponto de extremidade EWS, o número de versão se você tiver um e a caixa de correio de teste.
5. Selecione Com acesso de usuário de serviço e insira o nome de usuário e a senha do usuário de serviço.
6. Selecione Validar e salvar credenciais.
7. Adicione as caixas de correio que você deseja sincronizar, conforme descrito em Usando integrações do Exchange.

Importante:

Se você selecionar Todo o tempo na seção Filtros de tempo , isso pode levar à sincronização de mais dados do que o esperado, e as mensagens serão cobradas no upload.