Perguntas frequentes sobre a descontinuidade da API do EWS
- Última atualização2024/11/06
A Microsoft anunciou a descontinuação para APIs EWS que são usadas para se conectar ao Exchange Online. Essa descontinuidade pode afetar as automações (bots) que usam o Email package ou o gatilho do Email com a opção EWS. Consulte as Perguntas frequentes para obter detalhes sobre a descontinuidade da API do EWS.
- O que é descontinuidade da API do EWS?
- A Microsoft descontinuou 25 APIs menos usadas do EWS desde 31 de março de 2022. Essa é uma descontinuação contínua e a Microsoft continuará descontinuando APIs EWS adicionais à medida que as APIs Graph equivalentes estiverem disponíveis.
Para saber mais sobre a descontinuação da API do EWS, consulte Upcoming API Deprecations in Exchange Web Services for Exchange Online.
- Por que essa mudança?
- O EWS é uma API herdada, que é menos segura e não atende às necessidades de segurança e gerenciabilidade do desenvolvimento de aplicativos modernos. De acordo com a Microsoft, é solicitado que você mude de APIs EWS baseadas em SOAP para API Graph baseada em REST se seus clientes ou aplicativos estiverem usando APIs EWS para se conectar ao servidor Exchange por meio do Exchange Online.O Microsoft Graph oferece as seguintes vantagens em comparação com o EWS:
- Segurança: O Microsoft Graph é mais seguro e tem políticas de governança mais rígidas com o OAuth e permite limitar o acesso aos dados em uma caixa de correio, em comparação com o modelo de acesso "tudo ou nada" no EWS.
- Simplicidade: O Microsoft Graph fornece o Graph Explorer para descobrir e testar APIs de forma fácil e rápida, SDKs em diferentes linguagens de programação e uma comunidade de desenvolvedores ativa.
- Eficiência: As APIs do Microsoft Graph são baseadas em REST, enquanto as APIs do EWS são baseadas em SOAP. A vantagem de usar protocolos baseados em REST inclui a serialização mais rápida de JSON e o menor uso da rede.
Nota: A descontinuação da API EWS se aplica somente ao Exchange Online e não à versão local do Exchange.
- Como essa descontinuidade me afetará?
- Por enquanto, você não será afetado porque o Automation 360 não usa nenhuma das APIs do EWS que foram descontinuadas pela Microsoft. De acordo com a Microsoft, as APIs do EWS não obsoletas continuarão a ter suporte para uso em ambientes de produção e não temos um cronograma fixo de quando essas APIs serão obsoletas no futuro.
Caso as APIs específicas do EWS usadas em Automation 360 fiquem obsoletas no futuro e se você tiver automatizado o e-mail usando Email do acionador package Email e actions com a opção EWS, essas automações serão interrompidas devido à falha de conexão com o Exchange Online.
- Onde o Automation 360 usa a API do EWS?
- Automation 360 utiliza a API do EWS no Email do package e gatilho de Email para a opção EWS que permite conectar ao Exchange Online hospedado no Azure Cloud e acessar e-mails pelo Microsoft 365.
- Como posso identificar os bots afetados que usam a opção EWS de Email?
- Você pode usar o utilitário Automation 360 Bot Scanner para o recurso descontinuado para fazer uma varredura e identificar os bots afetados que usam o EWS. Consulte Digitalizar bots para a autenticação Básica.
- Qual é a orientação para os clientes do Automation 360 mudarem da API do EWS para a API do Graph?
- Lançamos um novo Microsoft 365 Outlook package com Automation 360 v.29, que se baseia na versão mais recente da API do Graph. Você pode usar esse package para automatizar e-mails do Outlook para o Exchange Online. Esse package contém todas as actions semelhantes às disponíveis no Email package. Você pode usar o Microsoft 365 Outlook package em vez do Email package com a opção EWS para alternar da API do EWS para a API do Graph.
- Como faço para atualizar meus bots existentes para o Microsoft 365 Outlook package?
- Para atualizar os bots afetados existentes para o Microsoft 365 Outlook package, consulte Depreciação da APIs EWS no Exchange Online.
- A Automation Anywhere fornecerá alguma ferramenta para que os clientes do Automation 360 atualizem os bots da API do EWS para a API do Graph?
- Não. Você precisa atualizar manualmente os bots afetados para mudar para a API do Graph (Microsoft 365 Outlook package).
- Existe um mapeamento individual entre Email e Microsoft 365 Outlook packages ou há alguma diferença?
- Todos as actions disponíveis no Email
package também estão disponíveis no Microsoft 365 Outlook
package. No entanto, você precisa considerar as seguintes diferenças ao criar um bot com o novo Microsoft 365 Outlook
package:
- No package Email, as actions Enviar, Encaminhar, Responder e Responder a todos possuem parâmetros de conexão e, portanto, ao criar uma automação, você pode usar estas actions independentemente da action Conectar. Contudo, no caso do package Microsoft 365 Outlook, você deve usar a action Conectar antes de cada uma dessas actions já que se referem à sessão criada pela action Conectar, consulte Microsoft 365 Outlook package
- O novo Microsoft 365 Outlook
package é compatível com dois modos de autenticação: Código de autorização com PKCE e credenciais de cliente. O Email
package com opção EWS é compatível com quatro modos de autenticação: ROPC, implícita, código de autorização com PKCE e credenciais de cliente.Nota: Os modos de autenticação ROPC e implícita estão obsoletos e, portanto, não são compatíveis com o Microsoft 365 Outlook package. Você deve usar o código de autorização mais seguro com o fluxo PKCE para automação assistida e o fluxo de credenciais do cliente para automação não assistida.