> 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). # Endpoints de calendário do Zoom ### Serviço Web de Calendário O Serviço Web de Calendário é 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. Isso 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 | | ------------------------------- | | `participantesOmitidos` | | `descrição` | | `nomeDeExibição` (participante) | | `e-mail` (participante) | | `localDeTrabalhoFixo` | | `iCalUID` | | `Localização` | | `nomeDeExibição` (organizador) | | `e-mail` (organizador) | | `resumo` | | `propostaDeHorário` | | `localDeTrabalhoAtivado` | Quando a Sincronização bidirecional do calendário (Sincronização 2.0) está ativada, o Zoom não retém dados de eventos de calendários externos (do Microsoft 365 ou Google Agenda) na 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 Zoom. O serviço de reunião é então notificado para aplicar as Alterar necessárias. Os administradores podem Configurar este Recursos ao nível da conta ou do grupo de usuário. Consulte a nossa [documentação de Suporte](https://support.zoom.us/hc/en-us/articles/8522918261645-Enabling-bi-directional-calendar-sync) para obter 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. Esses dados são considerados conteúdo do cliente e estão sujeitos às políticas e aos padrões de controle de acesso da Zoom. Esses controles são avaliados por empresas de auditoria independentes quando indicado em nossas certificações e atestaçõ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 multifator e controles de acesso de menor privilégio. #### Como é protegido o tráfego entre as apps e o fornecedor de calendário? As comunicações entre fornecedores de calendário e qualquer software Zoom — aplicações Zoom para computador/dispositivos móveis, Serviço de calendário Web Zoom, ferramentas de agendando e o Conector API — são encriptadas em trânsito utilizando 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 credencial? Os administradores do Zoom podem Escolher remover a integração de calendário de uma única conta Zoom a qualquer momento, o que 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 eliminando o aplicativo Zoom no portal do aplicativo empresarial do Entra ID, e os administradores do Google local de trabalho podem revogar o acesso utilizando a Consola da Google nuvem plataforma. #### Posso limitar a capacidade do Zoom de escrever dados de calendário ou contato para 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 o calendário quanto para os contatos ao Conectando-se por meio dos métodos do Microsoft 365. Os administradores também podem limitar as integrações do Google local de trabalho para os 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 na memória temporária (RAM) e não persistem nenhum item no disco local. Isso inclui tokens de autenticação, credenciais, informações sobre o Evento do calendário e dados de contato. Esses dados deixam de estar disponíveis assim que o cliente sai. #### O que acontece no login? Os Zoom Apps iniciam uma atualização completa em cada login para coletar a lista de eventos futuros. Isso envolve receber o seu token de acesso OAuth ou credenciais armazenadas do Serviço Web de Calendário do Zoom e, em seguida, usar esse objeto para atualizar os dados de Evento diretamente do provedor de calendários. Se o token de acesso for inválido, o Serviço Web de Calendário do Zoom usará o token de atualização para solicitar e passar um novo token de acesso ao cliente. #### Como o cliente sabe quando atualizar sua lista de eventos futuros? O Serviço Web de Calendário 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 Web de Calendário de quaisquer alterações para que este possa então notificar o cliente Zoom de que é necessária uma atualização. Por fim, 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 da reunião estão disponíveis para o cliente? Nas aplicações Zoom, Exibir os dados da reunião ocorre após a sanitização dos Eventos que estas analisam, o que significa que foram descartados todos os atributos que não são utilizados. Os atributos do Evento guardados para utilização e os descartados estão descritos na tabela abaixo. | Guardado para Exibir no cliente | Descartado e não retido | | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------ | | | | | \*Apenas quando a captura de Evento com tecnologia de AI Companion 2.0 estiver ativada | | #### Alguns dados de calendário são armazenados nos registos do cliente? O Zoom Apps não imprimirá dados sensíveis do calendário, como tokens, credenciais ou eventos, em quaisquer registos do cliente. ### Ferramentas de agendando Zoom oferece uma variedade de ferramentas para simplificar a experiência de agendando de reuniões Zoom com produtos 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 navegadores Selecionar e Outlook. #### Como é que as ferramentas de agendando funcionam? Todas as ferramentas de agendando, exceto o Plug-in para Outlook, enviam pedidos API diretamente ao fornecedor de calendários e ao Serviço Web de Calendário do Zoom. O Plug-in para Outlook é diferente, pois permite Agendar uma reunião através do cliente Zoom para computador, que envia o pedido API ao Serviço Web de Calendário do Zoom em nome do Plugin. #### Que informação é enviada ao Zoom ao Agendar uma reunião 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 suplemento do Microsoft 365 para Agendar uma reunião Zoom, o suplemento usará o assunto do Evento, a data, a hora, o fuso horário e o sinalizador de recorrência para Agendar a reunião Zoom. O suplemento 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 quaisquer alterações adicionais de firewall ou segurança além do que já é necessário para as 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 suplemento do Outlook? O Plug-in para Outlook está instalado na máquina de um usuário final e auxilia os usuários agendando Zoom Meetings por meio do cliente Outlook. O Plugin comunica-se com o cliente desktop Zoom Workplace por meio de um canal de comunicação entre processos (IPC). Usando esse IPC, o Plugin envia agendamentos ao Serviço Web de Calendário do Zoom por meio dos recursos do cliente. Para proporcionar a melhor experiência para 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 implantaçã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 Plugin Zoom para Outlook. {% endhint %} O complemento 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 web que se comunicam diretamente com o Serviço Web de Calendário do Zoom. O plugin e o complemento oferecem 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 que não está Disponível de forma alguma para o Exchange Server local — esteja Disponível. Isso significa: * O complemento Outlook não pode ser usado para agendamento delegado com Exchange Server local. * Os delegados devem usar o cliente Outlook do Microsoft 365, 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 Zoom? O aplicativo oficial Plugin Zoom para Outlook, Disponível na [loja Microsoft AppSource](https://appsource.microsoft.com/en-us/product/office/WA104381712?tab=Overview) é instalado no seu diretório empresarial de aplicativos do Entra ID sob o nome “Zoom-Office-Adicionar-in-SSO” com o ID do aplicativo ce63c970-e2d7-45e6-bee1-80c330b0800b. #### Preciso atualizar o Plug-in para Outlook ou o suplemento? A partir de janeiro de 2025, a Microsoft começou a substituir os tokens legados do Exchange Online por 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 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 estes 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 web integrado que opera através de APIs da Web para comunicar-se com o Serviço de Calendário Web do Zoom. O suplemento está Disponível para os aplicativos Outlook para Windows e macOS, Android e iOS Outlook, e Outlook na web. O suplemento pode ser configurado e implementado 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 do 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 utilizam o Google local de trabalho podem habilitar facilmente todos os utilizadores para Agendar Zoom Meetings através do Google Agenda, instalando o aplicativo Zoom para GSuite a partir do Marketplace do Google local de trabalho. O aplicativo é gerido centralmente e atualiza-se automaticamente à medida que o Zoom envia melhorias ao Google. Alternativamente, as extensões baseadas no navegador também estão Disponível 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 Plugin Zoom para Outlook é a ferramenta preferida para ambientes Microsoft 365 — seja para as versões de ambiente de trabalho, 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. Sincronizar Calendário Bidirecional garante atualizações de calendário contínuas e está ativado por padrão quando se integram calendários. Isso permite que o Zoom reflita automaticamente as alterações feitas nos eventos de calendário do Outlook — como horários reagendados ou cancelamentos — sem exigir que os utilizadores atualizem manualmente ou removam reuniões através do complemento. Isso é especialmente importante porque os links de reuniões do Zoom podem expirar se as alterações não forem captadas, particularmente quando uma reunião é remarcada para mais de 30 dias além da sua 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 moderna de JavaScript (v1.8), que impulsiona a automação baseada em Evento, como OnAppointmentSend, não é suportada pelos seguintes ambientes e aplicativos: * Ambientes Exchange locais * Outlook clássico ligado ao M365 * Outlook móvel no iOS e Android Como resultado, o Zoom não consegue detetar ou atualizar automaticamente reuniões através do suplemento nestas configurações. Sem Sincronização 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 fornece sincronização de reunião melhorada através de Integrações direta com o aplicativo Zoom Workplace, contornando as limitações da API da Microsoft. Embora seja recomendado para sistemas Windows sem Sincronização bidirecional, tem limitações importantes: * Requer atualizações MSI geridas pela TI * agendando reunião mais lento * Sem suporte para macOS ou dispositivos móveis ### Zoom Rooms A Integrações de calendário do Zoom Rooms é realizada de forma independente da Integrações do cliente de computador ou móvel do usuário. Após a configuração, os eventos do calendário aparecem nos ecrãs do Zoom Rooms, incluindo ecrãs de televisão, interfaces de agendando e painéis de controlo. Os utilizadores podem iniciar ou entrar em reuniões com um toque no controlador da sala. #### Visão geral da configuração As Integrações de calendário do Zoom Rooms envolvem duas camadas distintas de configuração. A primeira camada é necessária independentemente de qual método de autenticação 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 Exchange Online PowerShell. 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. As Zoom Rooms precisam que esses detalhes sejam preservados para Exibir informações significativas do Evento nas telas da sala e nos controladores. 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: Selecionar o método de autenticação** Depois de configurar a caixa de correio do recurso, os administradores Selecionar um método de autenticação para Habilitar o Acessar 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. Ele não requer uma conta de serviço dedicada. {% endstep %} {% step %} *Acesso Delegado Completo (Microsoft Graph API)* * Este método usa o fluxo de 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 inicial e a manutenção. {% endstep %} {% endstepper %} A Zoom recomenda a Microsoft Graph API com Permissões de aplicativo como o método padrão de Integrações. Essa recomendação está alinhada com o plano da Microsoft de remover os protocolos do Exchange Web Services (EWS). O método da API do Graph oferece a conexão mais estável entre o Zoom Rooms e os 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 Aprimorado 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 como configurar o acesso de calendários para o Zoom Rooms. {% endhint %} #### Quais métodos posso usar para conceder acesso às caixas de correio das salas? A integração de calendários do Zoom Rooms depende da API do Microsoft Graph (MGAPI). A Microsoft começou [a descontinuar os métodos dos Serviços Web do Exchange (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. A Zoom considera esses métodos EWS 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 vai 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 do aplicativo (Microsoft Graph API) | Conta de administrador: Gestão da Organização e Gestão de destinatários | | Microsoft 365/Servidor Microsoft Exchange | Acesso Delegado Completo (Microsoft Graph API) | Enviar como — Acessar 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. Essa configuração exige menos esforço do administrador e não requer uma conta de serviço dedicada. Também é a abordagem recomendada pela Microsoft para aplicativos de nível empresarial executados como serviços em segundo plano. {% endhint %} ### Conector de API Aprimorado As Integrações de calendário para sistemas de sala baseados em padrões H.323 e SIP por meio do Conector de API Aprimorado (lançado no início de 2021) são realizadas independentemente 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 é 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 Rooms. O Serviço Web do Zoom atua como um cliente para esses sistemas e enviará os dados de calendário diretamente aos endpoints, com exceção dos dispositivos Poly. Os dispositivos Poly consultarão primeiro o Serviço Web do Zoom para obter atualizações de calendário, que então transmite os dados de calendário ao Dispositivo Poly. #### 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 as 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.