# Endpoints 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ções o Zoom armazena? O Serviço de Calendário Web 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 Zoom. Também significa, para organizações que usam autenticação básica no Exchange On-Premises, que o Zoom armazena o Nome de usuário da conta e a senha. | Eventos sincronizados | | --------------------------------- | | `attendeesOmitted` | | `descrição` | | `nome de exibição` (participante) | | `e-mail` (participante) | | `localDeTrabalhoFixo` | | `iCalUID` | | `Localização` | | `nome de exibição` (organizador) | | `e-mail` (organizador) | | `resumo` | | `proposta de tempo` | | `localDeTrabalhoAtivado` | Quando a Sincronização bidirecional de calendário (Sincronizar 2.0) está ativada, o Zoom não retém dados de eventos do calendário externo (do Microsoft 365 ou Google Agenda) em sua base de dados.\ \ Em vez disso, o serviço monitora uma janela móvel de 24 meses de atividade do calendário (até 6 meses no passado e 18 meses no futuro). Se ocorrerem Alterar dentro dessa janela, o Zoom recebe notificações de Alterar do provedor de calendário e recupera os dados atualizados do Evento sob demanda para processar as atualizações correspondentes da reunião do Zoom. Em seguida, o serviço de reunião é notificado para aplicar as Alterar necessárias. Os administradores podem Configurar este Recursos no nível de uma conta ou de um grupo de usuário. Consulte nosso [documentação de Suporte](https://support.zoom.us/hc/en-us/articles/8522918261645-Enabling-bi-directional-calendar-sync) para mais informações. #### Como os tokens e credenciais armazenados são protegidos? 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. Esses 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 Privilégio de acesso aos 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 é protegido o tráfego entre as apps e o provedor de calendário? As comunicações entre provedores de calendário e qualquer software Zoom — aplicativos de desktop/móvel do Zoom, Zoom Web Calendar Service, ferramentas de agendando e o Conector da API — são criptografadas em trânsito usando TLS 1.2. #### Por quanto tempo um token OAuth é válido? O 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 credencial? Os administradores do Zoom podem Escolher remover a integração de calendário de uma única conta Zoom a qualquer momento, o que irá 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 empresarial de aplicativo 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 contato em um provedor? Após a configuração inicial, os administradores do Zoom podem Escolher entre permissões de Leitura e Leitura/Gravação tanto para calendários quanto para contatos ao Conectando por meio dos métodos Microsoft 365. Os administradores também podem limitar as integrações do Google local de trabalho para calendários do usuário. ### Aplicações para computador e dispositivos móveis #### Os apps do Zoom armazenam algum dado de calendário ou contato? Os aplicativos Zoom mantêm informações de calendário na memória temporária (RAM) e não persistem nenhum item no disco local. Isso inclui tokens de autenticação, credenciais, informações de eventos do calendário e dados de contato. Esses dados não estão mais disponíveis quando o cliente é encerrado. #### O que acontece ao iniciar sessão? Zoom apps inicia uma atualização completa em cada login para coletar a lista de eventos futuros. Isso envolve receber seu token de acesso OAuth ou credenciais armazenadas do Zoom Web Calendar Service e, em seguida, usar esse objeto para atualizar dados de evento diretamente do provedor de calendário. Se o token de acesso for inválido, o Zoom Web Calendar Service usará o refresh token para solicitar e passar um novo token de acesso para o cliente. #### Como o cliente sabe para atualizar sua lista de próximo Evento? O Serviço de Calendário Web do Zoom subscreve um webhook de um fornecedor de calendário para cada usuário depois de o calendário ser ligado no portal web. Estes webhooks notificam o Serviço de Calendário Web de quaisquer alterações para que este possa depois notificar o cliente Zoom de que é necessária uma atualização. Finalmente, o cliente Zoom solicitará uma atualização diretamente ao fornecedor de calendário. As aplicações que não receberem uma notificação de atualização irão atualizar a sua lista de Evento a cada 30 minutos. #### Que detalhes de reunião estão Disponível para o cliente? Zoom Apps Exibir dados da reunião após sanitizar 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. | Salvos para Exibição no Cliente | Descartados e não retidos | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------ | | | | | \*Somente quando a captura de eventos alimentada pelo AI Companion 2.0 estiver ativada | | #### Algum dado de calendário é armazenado nos logs do cliente? Os apps do Zoom não imprimirão dados sensíveis do calendário, como tokens, credenciais ou eventos, em nenhum log do cliente. ### Ferramentas de agendando O Zoom oferece uma variedade de ferramentas para simplificar a experiência de agendando de reuniões do Zoom com produtos da Microsoft e Google. Esses produtos incluem integrações nativas de agendando para Google local de trabalho e Microsoft 365, ou extensões de software para uso com Selecionar navegadores e Outlook. #### Como funcionam as ferramentas de agendando? Todas as ferramentas de agendamento, exceto o Plug-in para Outlook, enviam diretamente solicitações de API tanto ao provedor de calendários quanto ao Serviço de Calendário Web do Zoom. O Plug-in para Outlook é diferente, pois agenda 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 plug-in. #### Que informações são enviadas ao Zoom ao agendar com uma ferramenta? Os únicos dados retidos ao usar uma ferramenta de agendamento são as informações necessárias para Agendar uma reunião. Por exemplo, quando um usuário agenda uma reunião do Zoom usando o complemento do Microsoft 365, 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 da mensagem ou a lista de participantes. #### Há algum requisito de firewall ou segurança? As ferramentas de agendamento não exigem alterações adicionais de firewall ou segurança além daquelas já necessárias para integrações de calendário. A lista completa de requisitos está documentada em [regras de rede e firewall para o 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 auxilia os usuários a agendar reuniões do Zoom por meio do cliente Outlook. O plug-in se comunica com o cliente Zoom Workplace para computador por meio de um canal de comunicação entre processos (IPC). Usando esse IPC, o plug-in 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, ao mesmo tempo em que seguimos as políticas e diretrizes definidas pela Apple e pela Microsoft, o Zoom está recomendando fortemente a implementação e o uso do Plugin Zoom para Outlook. O complemento oferece implantação mais fácil e soluções de gerenciamento administrativo mais robustas, é ativamente suportado pela Microsoft e atende melhor aos requisitos de segurança recentemente aprimorados de fornecedores como a Apple. {% hint style="danger" %} **Aviso** Novos aprimoramentos de Recursos não serão implementados para o Plugin Zoom para Outlook. É altamente recomendável migrar para o complemento Zoom para Outlook. {% endhint %} O complemento do Outlook é um aplicativo baseado na web que não requer instalação local nas máquinas dos usuários 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 Calendaring Web Service do Zoom. O plugin e o complemento fornecem funcionalidades semelhantes, mas o complemento exige que o conjunto de requisitos da API JavaScript do Outlook v1.8 — 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 suplemento do Outlook não pode ser usado para agendamento delegado com o Exchange Server local. * Os delegados devem usar o cliente Microsoft 365 Outlook, o Outlook 2021 ou posterior para Mac/PC, ou o Outlook na Web para Agendar reuniões em nome de outro usuário. #### Como posso identificar o aplicativo oficial do complemento do Zoom? O aplicativo oficial Plugin Zoom para Outlook Disponível da [loja Microsoft AppSource](https://appsource.microsoft.com/en-us/product/office/WA104381712?tab=Overview) é instalado no seu diretório de aplicativos empresarial do Entra ID com o nome “Zoom-Office-Adicionar-in-SSO” e com o ID do aplicativo ce63c970-e2d7-45e6-bee1-80c330b0800b. #### Preciso atualizar o Plug-in para Outlook ou o complemento? Em janeiro de 2025, a Microsoft começou a substituir os tokens legados do Exchange Online por autenticação de aplicativo aninhada (NAA). Os administradores do Zoom, em colaboração com os administradores do Entra, devem Configurar o NAA no Portal web do Zoom seguindo as instruções no artigo de Suporte [Configurando autenticação de aplicativo aninhada 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) é suportada 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 plugin Zoom para Outlook é um aplicativo baseado na web que não requer instalação local nas máquinas dos usuários e, em vez disso, aparece como um aplicativo da web integrado que opera por meio de APIs da web para se comunicar com o Serviço de Calendário da Web do Zoom. O plugin está disponível para os aplicativos Outlook do Windows e do macOS, os aplicativos Outlook do Android e do iOS e o Outlook na web. O plugin pode ser configurado e implantado em massa por administradores do Outlook ou instalado por usuários individuais. O Plug-in para Outlook funciona como um software instalado, sujeito a atualizações e melhorias ocasionais. Consequentemente, o Plugin requer gestão 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 para o meu ambiente? **Google local de trabalho** Organizações que usam Google local de trabalho podem facilmente Habilitar todos os usuários a Agendar Zoom Meetings por meio do Google Agenda, instalando o aplicativo Zoom for GSuite do Google local de trabalho Marketplace. O aplicativo é gerenciado centralmente e é atualizado automaticamente conforme o Zoom envia melhorias ao Google. Alternativamente, as extensões baseadas no navegador também estão disponíveis para uso, mas geralmente são mais adequadas para usuários de conta pessoal, porque exigem uma instalação local, atualizações periódicas e não são gerenciadas centralmente. **Microsoft** Para organizações que usam Microsoft 365 ou Exchange Server local, a melhor opção depende tanto do ambiente quanto de como a integração de calendário está configurada. O complemento Plugin Zoom para Outlook é a ferramenta preferida para ambientes Microsoft 365 — quer você esteja usando as versões desktop, web ou móvel do Outlook. O complemento requer Outlook para Microsoft 365, Outlook 2013 ou posterior para Windows, ou Outlook 2016 ou posterior para Mac. A Sincronização Bidirecional de calendário garante atualizações de calendário sem interrupções e está habilitada por padrão ao integrar calendários. Isso permite que o Zoom reflita automaticamente as alterações feitas nos eventos do calendário do Outlook — como horários remarcados ou cancelamentos — sem exigir que os usuários atualizem ou removam manualmente reuniões por meio do complemento. Isso é especialmente importante porque os links de reunião do Zoom podem expirar se as alterações não forem capturadas, especialmente quando uma reunião é movida para mais de 30 dias além da data original. Os IDs de reunião normalmente expiram após 30 dias, a menos que façam parte de uma série recorrente. A API JavaScript moderna (v1.8), que alimenta a automação baseada em Evento, como OnAppointmentSend, não é suportada pelos seguintes ambientes e aplicativos: * Ambientes do Exchange local * Outlook clássico conectado ao M365 * Outlook móvel no iOS e Android Como resultado, o Zoom não pode detectar ou atualizar automaticamente reuniões por meio do complemento nessas configurações. Sem Sincronização Bidirecional ou automação baseada em API, até mesmo reuniões recorrentes podem não refletir as 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 da integração direta com o aplicativo Zoom Workplace, contornando as limitações da API da Microsoft. Embora seja recomendado para sistemas Windows sem Sincronização Bidirecional, ele tem restrições notáveis: * Requer atualizações MSI gerenciadas pela TI * Agendamento de reunião mais lento * Sem suporte para macOS ou dispositivos móveis ### Zoom Rooms A Integrações de calendário do Zoom Rooms é realizada independentemente da Integrações do cliente de desktop ou móvel do usuário. Após a configuração, os eventos de calendário aparecem nas telas do Zoom Rooms, incluindo telas de televisão, interfaces de agendando e painéis de controle. Os usuários podem iniciar ou Entrar/entrar em reuniões com um toque no controlador da sala. As etapas a seguir são um resumo de alto nível do processo de configuração: 1. Configurar o Microsoft Exchange Online e atualizar scripts do PowerShell para as Configurações da caixa de correio do Zoom Rooms 2. Configurar as permissões do Microsoft Graph API para Habilitar o acesso aos dados do calendário O Zoom recomenda o Microsoft Graph API com Permissões do aplicativo como o método de Integrações padrão. Essa recomendação está alinhada com o plano da Microsoft de remover os protocolos Exchange Web Services (EWS). O método Graph API oferece a conexão mais estável entre o Zoom Rooms e os calendários do Microsoft 365. {% hint style="info" %} **Nota** Organizações que usam sistemas de sala de conferência de terceiros (como Cisco, Poly e Lifesize) devem concluir etapas adicionais por meio do Zoom Enhanced API Conector para garantir funções adequadas de calendário e reunião. Consulte nosso documento M365 Calendaring Field Guide para obter mais informações sobre como configurar o acesso de calendário para Zoom Rooms. {% endhint %} #### Quais métodos posso usar para conceder acesso às caixas de correio dos quartos? A integração de calendários do Zoom Rooms depende da API Microsoft Graph (MGAPI). A Microsoft começou [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 anteriormente Disponível para conectar 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 variará dependendo do 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/Servidor Microsoft Exchange | Permissões de aplicativo (API Microsoft Graph) | Conta de administrador: Gestão da Organização e Gestão de Destinatários | | Microsoft 365/Servidor Microsoft Exchange | Acesso total delegado (API Microsoft Graph) | Enviar como Acesso total | | Google local de trabalho | - | Fazer alterações e gerir a partilha | {% hint style="info" %} **Recomendação do Zoom** O Zoom recomenda que as integrações de calendário usem o método de Permissões de aplicativo. Esta configuração requer menos esforço do administrador e não requer uma conta de serviço dedicada. Também é a abordagem recomendada da Microsoft para aplicações empresarial que executam como serviços em segundo plano. {% endhint %} ### Conector de API melhorado A Integrações de calendário para sistemas de sala H.323 e SIP baseados em normas através do Conector de API Melhorado (lançado no início de 2021) é realizada de forma independente da configuração do cliente de usuário e do Zoom Rooms. A metodologia da conta de serviço e as permissões são idênticas à secção do Zoom Rooms anteriormente abordada. #### O que é diferente no fluxo de dados do Conector de API Melhorado? Os sistemas de sala ligados através do Conector de API Melhorado não entrarão em contato diretamente com os fornecedores de calendário, o que difere dos fluxos de ligação do cliente Zoom e do Zoom Room. O Serviço Web Zoom atua como um cliente para estes sistemas e enviará os 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 Zoom para obter atualizações de calendário, que depois transmite os dados de calendário para o Dispositivo. #### Quantos dias de eventos de calendário são recuperados? O Conector de API Melhorado recupera dados de próximas reuniões para os próximos 30 dias e remove as reuniões concluídas do armazenamento após 30 dias. --- # Agent Instructions: 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: ``` GET https://library.zoom.com/technical-library/pt/canto-do-administrador/third-party-integrations/zoom-calendaring-integration-explainer/zoom-calendaring-endpoints.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.