> For the complete documentation index, see [llms.txt](https://library.zoom.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://library.zoom.com/technical-library/pt/canto-do-administrador/third-party-integrations/zoom-calendaring-integration-explainer/zoom-calendaring-endpoints.md). # Pontos de extremidade de calendário do Zoom ### Serviço de Calendário Web O Serviço de Calendário Web é o Coração da capacidade do Zoom de fornecer informações de calendário a todos os Zoom Apps. #### Que informação o Zoom armazena? O Serviço Web de Calendário do Zoom armazena os objetos necessários para autenticar o provedor de calendário de cada usuário. Isso significa que o Zoom armazena o token de atualização quando as organizações usam OAuth para conectar o Outlook ou o Google Agenda aos serviços do Zoom. Também significa que, para organizações que usam autenticação básica no Exchange On-Premises, o Zoom armazena o Nome de usuário da conta e a senha. | Eventos Sincronizados | | --------------------------------- | | `participante omitido` | | `descrição` | | `nome de exibição` (participante) | | `e-mail` (participante) | | `Localização de trabalho fixa` | | `UID do iCal` | | `Localização` | | `nome de exibição` (organizador) | | `e-mail` (organizador) | | `resumo` | | `proposta de horário` | | `Localização de trabalho ativada` | Quando a função Sincronizar Bidirecional do calendário está ativada, o Zoom não retém dados de eventos de calendário externos (do Microsoft 365 ou Google Agenda) em sua base de dados.\ \ Em vez disso, o serviço monitora uma janela móvel de 18 meses de atividade de calendário (até 6 meses no passado e 12 meses no futuro). Se ocorrerem alterações dentro dessa janela, o Zoom recebe notificações de alteração do provedor de calendário e recupera sob demanda os dados atualizados do Evento para processar as atualizações correspondentes da reunião Zoom. Em seguida, o serviço de reunião é notificado para aplicar as alterações necessárias. Os administradores podem Configurar este conjunto de Recursos no nível de uma conta ou de um grupo de usuários. Consulte a nossa [documentação de Suporte](https://support.zoom.us/hc/en-us/articles/8522918261645-Enabling-bi-directional-calendar-sync) para mais informações. #### Como são protegidos os tokens e as credenciais armazenados? Os tokens e credenciais armazenados são criptografados em repouso usando criptografia AES-GCM de 256 bits. Estes dados são considerados conteúdo do cliente e estão sujeitos às políticas e padrões de controle de acesso da Zoom. Estes controles são avaliados por firmas de auditoria independentes quando indicado em nossas certificações e declarações de segurança, como o SOC 2. O acesso Privilégio a dados e sistemas de infraestrutura é registrado, monitorado e controlado usando autenticação de vários fatores e controles de acesso com menor privilégio. #### Como o tráfego entre os aplicativos e o provedor de calendário é protegido? As comunicações entre provedores de calendário e qualquer software Zoom — aplicativos de desktop/mobile do Zoom, Serviço de calendário Web do Zoom, ferramentas de agendando e o Conector de API — são criptografadas em trânsito usando TLS 1.2. #### Por quanto tempo um token OAuth é válido? Zoom solicitará tokens de acesso que expiram em 1 hora e tokens de atualização que expiram em 90 dias, mas os provedores de calendário podem fornecer tokens com limites alternativos. Siga as instruções do seu provedor se precisar modificar os valores padrão. #### Posso revogar um token OAuth ou uma credencial? Os administradores do Zoom podem Escolher remover a integração de calendário de uma única conta Zoom a qualquer momento, o que vai impedir o calendário do usuário de funcionar. Exclua imediatamente quaisquer tokens ou credenciais armazenados para esse usuário. Os administradores do Microsoft 365 podem remover o acesso ao calendário do Zoom de todas as contas de usuário, excluindo o aplicativo Zoom no portal de aplicativo empresarial do Entra ID, e os administradores do Google local de trabalho podem revogar o acesso usando o Console da plataforma Google nuvem. #### Posso limitar a capacidade do Zoom de gravar dados de calendário ou de contato num provedor? Após a configuração inicial, os administradores do Zoom podem Escolher entre permissões de leitura e leitura/gravação para calendários e contatos quando Conectando por meio dos métodos do Microsoft 365. Os administradores também podem limitar integrações do Google local de trabalho para calendários do usuário. ### Aplicativos para desktop e dispositivos móveis #### Os Zoom Apps armazenam algum dado de calendário ou contato? Os Zoom Apps mantêm informações de calendário em memória temporária (RAM) e não persistem nenhum item no disco local. Isso inclui tokens de autenticação, credenciais, informações de Evento do calendário e dados de contato. Esses dados não estão mais Disponível depois que o cliente Zoom é encerrado. #### O que acontece no início de sessão? Os Zoom Apps iniciam uma atualização completa em cada início de sessão para coletar a lista de próximos eventos. Isso envolve receber o seu token de Acessar OAuth ou credenciais armazenadas do Serviço de Calendário Web do Zoom e, em seguida, usar esse objeto para atualizar diretamente os dados de Evento do provedor de calendário. Se o token de Acessar for inválido, o Serviço de Calendário Web do Zoom usará o token de atualização para solicitar e passar um novo token de Acessar para o cliente Zoom. #### Como o cliente sabe que precisa atualizar a sua lista de próximos Evento? O Serviço de Calendário Web do Zoom assina um webhook de calendário para cada usuário depois que o calendário é conectado no portal da web. Esses webhooks notificam o Serviço de Calendário Web de quaisquer alterações para que ele possa então notificar o cliente Zoom de que é necessária uma notificação de atualização. Por fim, o cliente Zoom solicitará uma atualização diretamente ao provedor de calendário. Os Apps que não receberem uma notificação de atualização atualizarão sua lista de Evento a cada 30 minutos. #### Quais detalhes da reunião estão disponíveis para o cliente? Os Zoom Apps exibem os dados da reunião após higienizar os eventos que analisa, o que significa que descartou todos os atributos que não usa. Os atributos do Evento salvos para uso e descartados estão descritos na tabela abaixo. | Salvo para Exibição no Cliente | Descartado e não retido | | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------ | | | | | \*Apenas quando a captura de Evento com tecnologia do AI Companion 2.0 estiver ativada | | #### Alguns dados de calendário são armazenados nos registos do cliente? As Zoom Apps não imprimirão dados confidenciais de calendário, como tokens, credenciais ou eventos, em quaisquer registos do cliente. ### Ferramentas de agendando O Zoom oferece uma variedade de ferramentas para simplificar a experiência de agendando de reunião do Zoom com produtos Microsoft e Google. Esses produtos incluem integrações nativas de agendamento para Google local de trabalho e Microsoft 365, ou extensões de software para uso com navegadores Selecionar e Outlook. #### Como funcionam as ferramentas de agendando? Todas as ferramentas de agendando, exceto o Plug-in para Outlook, enviam diretamente solicitações de API tanto ao provedor de calendário quanto ao Serviço de Calendário Web do Zoom. O Plug-in para Outlook é diferente, pois permite Agendar uma reunião por meio do cliente Zoom para computador, que envia a solicitação de API ao Serviço de Calendário Web do Zoom em nome do Plugin. #### Que informações são enviadas ao Zoom ao agendando com uma ferramenta? Os únicos dados retidos ao usar uma ferramenta de agendando são as informações necessárias para Agendar uma reunião. Por exemplo, quando um usuário usa o complemento do Microsoft 365 para Agendar uma reunião do Zoom, o complemento usará o assunto do Evento, a data, a hora, o fuso horário e o sinalizador de recorrência para Agendar a reunião do Zoom. O complemento do Zoom não solicita nem usa detalhes adicionais, como o corpo ou a lista de participantes. #### Há algum requisito de firewall ou segurança? As ferramentas de agendando não exigem alterações adicionais de firewall ou segurança além do que já é necessário para integrações de calendário. A lista completa de requisitos está documentada em [regras de rede e firewall para Zoom](https://support.zoom.us/hc/en-us/articles/201362683-Network-firewall-or-proxy-server-settings-for-Zoom). #### Qual é a diferença entre o Plug-in para Outlook e o complemento do Outlook? O Plug-in para Outlook é instalado na máquina de um usuário final e ajuda os usuários com o agendamento de Zoom Meetings por meio do seu cliente Outlook. O plugin se comunica com o cliente Zoom Workplace para computador por meio de um canal de comunicação entre processos (IPC). Usando esse IPC, o plugin envia agendamentos ao Serviço de Calendário Web do Zoom por meio dos recursos do cliente. Para oferecer a melhor experiência aos nossos usuários, enquanto seguimos as políticas e diretrizes definidas pela Apple e pela Microsoft, o Zoom recomenda fortemente a implementação e utilização do Plugin Zoom para Outlook. O complemento oferece implantação mais fácil e Soluções de gerenciamento administrativo mais robustas, tem suporte ativo da Microsoft e atende melhor aos requisitos de segurança recentemente reforçados de fornecedores como a Apple. {% hint style="danger" %} **Aviso** Novas melhorias de Recursos não serão implementadas para o Plugin Zoom para Outlook. É altamente recomendado migrar para o complemento do Plugin Zoom para Outlook. {% endhint %} O complemento do Outlook é um aplicativo baseado na web que não requer instalação local nas máquinas do usuário e, em vez disso, aparece como um aplicativo web integrado, Disponível tanto no cliente local quanto no Outlook na web. O complemento opera por meio de APIs da web que se comunicam diretamente com o serviço web de calendários do Zoom. O Plugin e o complemento oferecem funcionalidades semelhantes, mas o complemento requer que o conjunto de requisitos v1.8 da API JavaScript do Outlook — uma versão que existe apenas nas versões modernas do Outlook e não está Disponível para o Exchange Server local de forma alguma — esteja Disponível. Isso significa: * O complemento do Outlook não pode ser usado para o agendando delegado com o Exchange Server local. * Os delegados devem usar o cliente Outlook do Microsoft 365, Outlook 2021 ou posterior para Mac/PC, ou Outlook na Web para Agendar reuniões em nome de outro usuário. #### Como posso identificar o aplicativo oficial do complemento Zoom? O aplicativo oficial Plugin Zoom para Outlook Disponível a partir do [loja Microsoft AppSource](https://appsource.microsoft.com/en-us/product/office/WA104381712?tab=Overview) é instalado no diretório de Aplicativos empresarial do Entra ID com o nome “Zoom-Office-Adicionar-in-SSO” e a ID do aplicativo ce63c970-e2d7-45e6-bee1-80c330b0800b. #### Preciso atualizar o Plug-in para Outlook ou Adicionar-in? A partir de janeiro de 2025, a Microsoft começou a substituir os tokens legados do Exchange Online pela autenticação de aplicativo aninhado (NAA). Os administradores do Zoom, em colaboração com os administradores do Entra, devem Configurar a NAA no Portal web do Zoom seguindo as instruções no artigo de Suporte [Configurando a autenticação de aplicativo aninhado para suplementos do Office](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0078410). {% hint style="info" %} **Nota** A autenticação de aplicativo aninhado (NAA) é compatível apenas com o Exchange Online. As organizações que usam o Exchange 2019 (ou outras versões locais do Exchange) precisarão continuar utilizando tokens legados de identidade de usuário do Exchange e tokens de retorno de chamada, pois eles não são bloqueados em ambientes locais. {% endhint %} Caso contrário, o suplemento Plugin Zoom para Outlook é um aplicativo baseado na web que não exige instalação local nas máquinas dos usuários e, em vez disso, aparece como um aplicativo web integrado que opera por meio de APIs da web para se comunicar com o Serviço de Calendário Web da Zoom. O suplemento está Disponível para os aplicativos Outlook para Windows e macOS, os aplicativos Outlook para Android e iOS e o Outlook na web. O suplemento pode ser configurado e implantado em massa por administradores do Outlook ou instalado por usuários individuais. O Plug-in para Outlook opera como um software instalado, que está sujeito a atualizações e melhorias ocasionais. Consequentemente, o Plugin exige gerenciamento de versões e atualizações ao longo do tempo. {% hint style="info" %} **Nota** A autenticação de aplicativo aninhado não é necessária para o Plug-in para Outlook. {% endhint %} #### Qual ferramenta de agendando é mais adequada ao meu ambiente? **Google local de trabalho** As organizações que usam o Google local de trabalho podem facilmente Habilitar todos os usuários a Agendar Zoom Meetings por meio do Google Agenda, instalando o aplicativo Zoom para GSuite a partir do Marketplace do Google local de trabalho. O aplicativo é gerenciado centralmente e é atualizado automaticamente à medida que a Zoom envia melhorias ao Google. Como alternativa, as extensões baseadas em navegador também estão Disponível para uso, mas geralmente são mais adequadas para usuários de contas pessoais, pois exigem uma instalação local, atualizações periódicas e não são gerenciadas centralmente. **Microsoft** Para organizações que usam o Microsoft 365 ou o Exchange Server local, a melhor opção depende tanto do ambiente quanto de como a integração de calendário está configurada. O suplemento Plugin Zoom para Outlook é a ferramenta preferida para ambientes Microsoft 365 — independentemente de você usar as versões para desktop, web ou dispositivos móveis do Outlook. O suplemento exige o Outlook para Microsoft 365, o Outlook 2013 ou posterior para Windows, ou o Outlook 2016 ou posterior para Mac. Sincronizar calendário bidirecional garante atualizações contínuas do calendário e é habilitado por padrão ao integrar calendários. Isso permite que o Zoom reflita automaticamente as alterações feitas em eventos do calendário do Outlook — como horários reagendados ou cancelamentos — sem exigir que os usuários atualizem ou removam manualmente reuniões por meio do suplemento. Isso é especialmente importante porque os links de reunião do Zoom podem expirar se as alterações não forem registradas, principalmente quando uma reunião é movida para mais de 30 dias após sua data original. Os IDs de reunião geralmente expiram após 30 dias, a menos que façam parte de uma série recorrente. A moderna API JavaScript (v1.8), que alimenta a automação baseada em Evento, como OnAppointmentSend, não é suportada pelos seguintes ambientes e aplicativos: * Ambientes do Exchange locais * Outlook clássico conectado ao M365 * Outlook móvel no iOS e Android Como resultado, o Zoom não pode detectar ou atualizar reuniões automaticamente por meio do complemento nessas configurações. Sem Sincronizar Bidirecional ou automação baseada em API, até mesmo reuniões recorrentes podem não refletir alterações — levando a links do Zoom expirados ou inválidos. O Plug-in do Zoom para Outlook é suportado apenas em sistemas Windows. Ele oferece sincronização aprimorada de reuniões por meio de Integrações diretas com o aplicativo Zoom Workplace, contornando as limitações da API da Microsoft. Embora seja recomendado para sistemas Windows sem Sincronizar Bidirecional, ele tem restrições notáveis: * Requer atualizações MSI gerenciadas pela TI * Agendando reuniões mais lentamente * Sem Suporte para macOS ou dispositivos móveis ### Zoom Rooms As Integrações de calendário do Zoom Rooms são realizadas independentemente das Integrações do cliente de desktop ou móvel do usuário. Após a configuração, os Evento do calendário aparecem nos Exibir do Zoom Rooms, incluindo ecrãs de televisão, interfaces de agendando e painéis de controlo. Os utilizadores podem iniciar ou Entrar/entrar numa reunião com um toque no controlador da sala. #### Resumo da configuração As Integrações de calendário do Zoom Rooms envolvem duas camadas de configuração distintas. A primeira camada é necessária independentemente do método de autenticação que você Selecionar. **Camada 1: configuração da caixa de correio de recursos do Exchange (necessária para todos os métodos)** Antes de configurar a autenticação, os administradores devem configurar caixas de correio de recursos do Exchange Online para cada Zoom Room. Isso inclui configurar a caixa de correio de recursos no Exchange Online e atualizar as regras de processamento de calendário por meio do PowerShell do Exchange Online. Por padrão, o Exchange Online define várias propriedades de processamento de calendário como `Verdadeiro`, o que faz com que o Exchange remova detalhes da reunião — como a linha de assunto, as informações do organizador e os comentários — das entradas de calendário nas caixas de correio de recursos. O Zoom Rooms precisa que esses detalhes sejam preservados para exibir informações significativas do Evento nas Exibir e nos controladores da sala. Os administradores devem atualizar as seguintes propriedades de processamento de calendário para `Falso` para cada caixa de correio de recursos do Zoom Room usando o `Set-CalendarProcessing` cmdlet: * `ExcluirAssunto` * `AdicionarOrganizadorAoAssunto` * `ExcluirComentários` * `RemoverPropriedadePrivada` Esta configuração deve ser repetida para cada caixa de correio de recurso. Para o procedimento completo do PowerShell, incluindo as etapas de validação, consulte o artigo do Suporte do Zoom [Configurando Zoom Rooms com Office 365](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0063474\&DeviceId=70283b61-c13a-475f-ab4d-4a89b1632c1b\&SessionId=1782321876035).Esta camada é necessária independentemente de qual método de autenticação você Selecionar na Camada 2. **Camada 2: seleção do método de autenticação** Depois de configurar a caixa de correio do recurso, os administradores devem Selecionar um método de autenticação para Habilitar o acesso aos dados do calendário para Zoom Rooms: {% stepper %} {% step %} *Permissões do aplicativo (Microsoft Graph API)* * **RECOMENDADO**: Este método usa o fluxo de credenciais do cliente OAuth 2.0 por meio de uma inscrição de aplicativo do Azure com consentimento do administrador. Não requer uma conta de serviço dedicada. {% endstep %} {% step %} *Acesso total de delegado (Microsoft Graph API)* * Este método usa o fluxo do código de autorização OAuth 2.0 com permissões delegadas da caixa de correio. Ele requer uma conta de serviço dedicada e mais esforço para a configuração e manutenção iniciais. {% endstep %} {% endstepper %} O Zoom recomenda a Microsoft Graph API com permissões de aplicativo como o método de integração padrão. Esta recomendação está alinhada com o plano da Microsoft de remover os protocolos Exchange Web Services (EWS). O método da Graph API oferece a conexão mais estável entre Zoom Rooms e calendários do Microsoft 365. {% hint style="info" %} Organizações que usam sistemas de sala de conferência de terceiros (como Cisco, Poly e Lifesize) devem concluir etapas adicionais por meio do Conector de API Avançado do Zoom para garantir as funções corretas de calendário e reunião. Consulte nosso documento M365 Calendaring Field Guide para obter mais informações sobre a configuração do acesso ao calendário para o Zoom Rooms. {% endhint %} #### Quais métodos posso usar para conceder acesso às caixas de correio da sala? A integração de calendários do Zoom Rooms depende da Microsoft Graph API (MGAPI). A Microsoft começou [a descontinuar os métodos do Exchange Web Services (EWS)](https://techcommunity.microsoft.com/blog/exchange/retirement-of-exchange-web-services-in-exchange-online/3924440) que estavam disponíveis anteriormente para conectar os dados do Microsoft 365 com os Serviços Zoom. O Zoom considera esses métodos EWS como opções legadas. O Google local de trabalho só tem um único método para aplicar permissões. #### Quais permissões são necessárias para a conta de serviço? A permissão específica varia de acordo com o método selecionado. Cada opção e as permissões necessárias estão detalhadas na tabela abaixo: | Fornecedor | Método | Permissões necessárias | | --------------------------------------- | ---------------------------------------------- | --------------------------------------------------------------------- | | Microsoft 365/Microsoft Exchange Server | Permissões do aplicativo (Microsoft Graph API) | Conta de administrador: Organização Management e Recipient Management | | Microsoft 365/Microsoft Exchange Server | Acesso total de delegado (Microsoft Graph API) | Enviar como Acesso total | | Google local de trabalho | - | Fazer alterações e gerenciar compartilhamento | {% hint style="info" %} **Recomendação da Zoom** Zoom recomenda que as Integrações de calendário usem o método de Permissões de aplicativo. Essa configuração exige menos esforço do administrador e não requer uma conta de serviço dedicada. Também é a abordagem recomendada da Microsoft para aplicativos de nível empresarial executados como serviços em segundo plano. {% endhint %} ### Conector de API Aprimorado Integrações de calendário para sistemas de sala H.323 e SIP baseados em padrões por meio do Conector de API Aprimorado (lançado no início de 2021) são realizadas de forma independente da configuração do cliente do usuário e do Zoom Rooms. A metodologia da conta de serviço e as permissões são idênticas às da seção do Zoom Rooms abordada anteriormente. #### O que há de diferente no fluxo de dados do Conector de API Aprimorado? Os sistemas de sala conectados por meio do Conector de API Aprimorado não entrarão em contato diretamente com os provedores de calendário, o que difere dos fluxos de conexão do cliente Zoom e do Zoom Room. O Serviço Web do Zoom atua como um cliente para esses sistemas e enviará dados de calendário diretamente para os endpoints, com uma exceção para dispositivos Poly. Os dispositivos Poly consultarão primeiro o Serviço Web do Zoom em busca de atualizações de calendário, que então transmitirá dados de calendário para o Dispositivo. #### Quantos dias de eventos de calendário são recuperados? O Conector de API Aprimorado recupera dados das próximas reuniões para os próximos 30 dias e remove reuniões concluídas do armazenamento após 30 dias. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://library.zoom.com/technical-library/pt/canto-do-administrador/third-party-integrations/zoom-calendaring-integration-explainer/zoom-calendaring-endpoints.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.