Integração do Exchange

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.

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.

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:

  Restrict the folder filter scope to the minimum your use case needs. If you leave Allowed folders empty, the integration continuously syncs from every folder in the mailbox — including Archive and Recoverable Items (purges) — which slows the sync dramatically. For most BAU processing, allow only:

  • 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
  Observação:

  Você será inscrito automaticamente para notificações se tiver a permissão Exibir integrações , mas também pode fazer isso ou cancelar a assinatura por meio do Serviço de Notificação. Para atualizar as configurações de integração, a permissão Modificar integrações é necessária.

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

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

Colete os seguintes detalhes:

• URL do Exchange Server
• Nome de usuário e senha do usuário de serviço
• Tipo de acesso (delegado ou personificação)
• Lista de caixas de correio a serem sincronizadas.

Configure a integração do Exchange conforme descrito na parte "Criar uma nova integração no Communications Mining™" do tutorial, escolhendo a opção NTLM e inserindo os detalhes coletados: URL do Exchange Server, nome de usuário e senha do usuário do serviço, tipo de acesso, lista de caixas de correio a serem sincronizadas.

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.