Solução de problemas de integrações do Exchange

Soluções para problemas de sincronização de integração do Exchange no Communications Mining, cobrindo caixas de correio e integrações desabilitadas, lacunas de sincronização silenciosa e problemas de filtro de pasta.

Esta página ajuda você a diagnosticar problemas de sincronização de integração do Exchange no Communications Mining™. Comece com o que você pode observar:

• A integração ou uma de suas caixas de correio foi desabilitada com um erro.
• Nenhum erro aparece em lugares, mas os emails estão ausentes.

Uma integração ou caixa de correio foi desabilitada com um erro

Quando a sincronização encontra um erro persistente, o Communications Mining desabilita a parte com falha — uma única caixa de correio quando possível ou toda a integração quando as próprias credenciais falham — e notifica os usuários que têm permissões de integração no projeto. Para ler o erro, acesse a página Administração , selecione a guia Integrações e expanda a integração ou caixa de correio desabilitada.

A maioria dos erros de caixa de correio inclui uma linha Detalhes do erro: contendo o erro não modificado retornado pela Microsoft. Essa linha nomeia o erro subjacente da Microsoft; portanto, inclua-o em qualquer tíquete de suporte. Depois de resolver a causa, reabilite a caixa de correio ou a integração.

Erros de caixa de correio

Erro	Causa e resolução
Cannot access '<mailbox>' please review the access policies that are in place. com detalhes do Erro: ErrorAccessDenied: Access to OData is disabled: [RAOP] : Blocked by tenant configured AppOnly AccessPolicy settings.	A caixa de correio está fora da sua política de acesso ao aplicativo. Peça ao administrador do Exchange para adicioná-la ao grupo de segurança com escopo, confirme com Test-ApplicationAccessPolicy e, em seguida, reabilite a caixa de correio.
Mailbox '<mailbox>' was not found. The SMTP address has no mailbox associated with it. com detalhes do Erro: MailboxNotEnabledForRESTAPI: The mailbox is either inactive, soft-deleted, or is hosted on-premise.	O endereço existe, mas não é uma caixa de correio que a API do Graph possa ler. Em vez disso, sincronize uma caixa de correio licenciada do Exchange Online.
Mailbox '<mailbox>' was not found. The SMTP address has no mailbox associated with it. com detalhes do Erro: ErrorInvalidUser	O endereço está com erros ortográficos ou a caixa de correio foi excluída. Corrija o endereço ou remova a caixa de correio da integração.
Inbox folder was not found for mailbox '<mailbox>'	O aplicativo ou usuário de serviço não pode acessar a caixa de correio. Conceda acesso de leitura ou verifique as permissões e a política de acesso do aplicativo com seus administradores.
Mailbox '<mailbox>' has encountered an unknown error with code: 403.	O Exchange Online recusou o acesso sem classificar o motivo, por exemplo, uma cota de caixa de correio excedida. Leia a linha Detalhes do erro: e resolva o erro que ela relata.
Um erro contendo The security principal specified is already on the permission set, please remove duplicate.	A caixa de correio tem entradas de permissão duplicadas para a mesma conta ou aplicativo. Peça ao administrador do Exchange para remover a duplicata.

MailboxNotEnabledForRESTAPI abrange uma lista de distribuição, um usuário habilitado para email sem uma caixa de correio, uma conta não licenciada e uma caixa de correio ainda hospedada em um servidor Exchange local em uma configuração híbrida.

Erros de integração

Cada um dos seguintes erros aparece Error acquiring Microsoft Exchange access token em:

Erro	Causa e resolução
AADSTS7000215 ou AADSTS7000222	O segredo do cliente é inválido ou já expirou. Crie um novo, atualize as credenciais de integração e observe a data de expiração — um segredo expirado interrompe a ingestão até ser rotacionado.
AADSTS700016 ou AADSTS7000112	O aplicativo não foi encontrado no seu diretório ou um administrador do tenant o desabilitou. Confirme a ID do cliente e a ID de tenant e verifique o aplicativo no portal do Azure.
AADSTS50076, AADSTS50079, ou AADSTS53003	A autenticação multifator ou uma política de acesso condicional bloqueia o login na conta. Peça aos administradores de identidade que a excluam ou mude para a autenticação do aplicativo.
Uma mensagem sobre limites de consumo ou de cota	Sua organização atingiu a cota de consumo ou upload. Revise seu uso da licença e reabilite a integração.

Nenhum erro é exibido, mas os emails estão ausentes

As seguintes situações são situações em que a integração parece íntegro, mas os e-mails não chegam, incluindo o comportamento esperado que pode parecer uma falha.

Problema	Causa e resolução
Os emails pararam de chegar logo após você alternar uma integração do Exchange Web Services (EWS) para o Graph.	Esperado: a integração verifica novamente os emails do primeiro ponto que qualquer pasta atingiu o EWS, portanto, um intervalo é seguido por um período de recuperação, sem duplicatas.
As credenciais foram validadas com sucesso, mas nenhum e-mail chega.	Validar e salvar credenciais confirma apenas a autenticação, não o acesso à caixa de correio. Verifique cada caixa de correio em relação à sua política de acesso ao aplicativo e verifique a lista de caixas de correio para entradas desabilitadas.
Uma pasta que você espera não está sincronizada e nenhum erro é exibido.	Os filtros de pasta correspondem o texto literal com o caminho completo da pasta, e um caminho que não corresponde a nada é ignorado silenciosamente. Verifique o prefixo, a ortografia, as letras maiúsculas e os espaços à direita.
Os filtros de pastas que funcionam em uma caixa de correio não funcionam em outra.	Os caminhos das pastas usam o idioma da caixa de correio, não do usuário, portanto, tanto o prefixo quanto os nomes das pastas são localizados. Use os nomes das pastas da própria caixa de correio.
Mais pastas sincronizadas do que o esperado.	Permitir uma pasta também sincroniza suas subpastas, e uma caixa de correio sem filtro de pasta permitida sincroniza tudo, incluindo Arquivar e Itens Recuperáveis. Uma pasta negada substitui um pai permitido.
Os e-mails específicos estão ausentes mesmo que sua pasta esteja sincronizada.	Um participante, domínio ou organização negado corresponde ao remetente e a todos os destinatários, incluindo Cc e Cco. Nege a pasta Itens enviados em vez do seu próprio domínio.
Uma caixa de correio não mostra emails, mas também não mostra erros.	A causa mais comum é um caminho de pasta incompleto. Uma lista de pastas permitidas nega tudo o que não corresponde, portanto, uma única entrada incorreta interrompe toda a caixa de correio.
A primeira sincronização parece lenta.	A caixa de correio começa a ser sincronizada em minutos; alcançar o histórico leva mais tempo, na proporção do e-mail após seu carimbo de data/hora de início. Use um carimbo de data/hora de início recente.

Os caminhos das pastas devem começar com root/Top of Information Store/, e esse prefixo está localizado em uma caixa de correio não em inglês — por exemplo, root/Oberste Ebene des Informationsspeichers/ em um alemão.

Para confirmar se um filtro é a causa, remova temporariamente o filtro de pasta permitida e verifique se a caixa de correio sincroniza sem ele. Uma caixa de correio que está instantaneamente vazia ou cujos filtros não correspondem a nenhum e-mail, faz pesquisas com sucesso e não relata nada: esse é um estado íntegro, em vez de uma falha.

Para o que esperar ao mudar uma integração existente para o Graph, consulte o guia de migração da API do EWS para o Microsoft Graph. Se seu problema não estiver listado, envie um tíquete de Suporte da UiPath®.