Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
As APIs de reuniões gerais de eventos virtuais do Microsoft Graph permitem que você obtenha dados da reunião geral do Teams e crie, atualize e cancele programaticamente uma reunião geral do Teams.
Para você fazer o melhor uso das APIs de reuniões gerais de eventos virtuais do Microsoft Graph, é útil entender as personas dos usuários que acessam a experiência de reunião geral do Teams:
- Os organizadores são os funcionários (na sua organização) que gerenciam a reunião geral. Eles são a autoridade sobre quando as reuniões gerais acontecem e quem participa. Eles configuram detalhes da reunião geral, como título, tema, experiência do participante e regras de email.
- Os apresentadores são funcionários (em sua organização) ou convidados que conduzem a reunião geral.
- Os participantes são funcionários (em sua organização) ou convidados que ingressam na reunião geral e são convidados por email ou o link para o evento da reunião geral é compartilhado com eles.
- O administrador de locatários do Teams deve autorizar aplicativos personalizados com permissões apropriadas.
Você pode usar os seguintes tipos de recursos para criar sua solução de reunião geral:
- virtualEventTownhall – usado para criar, obter, atualizar, publicar e cancelar uma reunião geral do Teams.
- virtualEventPresenter – usado para criar, obter, listar, atualizar e excluir um apresentador para uma reunião geral do Teams.
- virtualEventSession – uma reunião geral criada por meio de APIs do Microsoft Graph tem uma sessão que herda as propriedades de reuniões online.
Soluções que você pode criar
A tabela a seguir lista algumas soluções que você pode criar usando o cliente do Teams e as APIs e webhooks da reunião geral do Microsoft Graph.
| Soluções | Descrição |
|---|---|
| Criar/atualizar/cancelar | Criar, atualizar e cancelar reuniões gerais do Teams de forma programática. |
| Sincronização de dados | Extraia dados da reunião geral do Teams em um aplicativo personalizado. |
| Comunicação por Email | Use sua própria infraestrutura de email para enviar emails de notificação relacionados à reunião geral. |
Observação
Para criar qualquer solução do Microsoft Graph, você precisa se registrar e conceder as permissões corretas ao seu aplicativo. Para obter mais informações, consulte Noções básicas de autenticação e autorização.
RSC (consentimento específico de recurso) para eventos virtuais
O RSC (consentimento específico do recurso) permite que os aplicativos solicitem permissões com escopo para um webinar ou reunião geral específico, em vez de exigir privilégios de administrador global. As permissões RSC melhoram a segurança, simplificam os fluxos de consentimento e permitem que os desenvolvedores criem integrações que respeitem os limites organizacionais.
APIs de eventos virtuais do Microsoft Graph habilitadas e permissões RSC
| Permissão RSC | APIs | Descrição |
|---|---|---|
| VirtualEvent.Read. Chat | Webinar e reunião geral | Leia as informações para este webinar ou reunião geral, incluindo horários, palestrantes, configurações de eventos e registros de webinar. |
| OnlineMeetingArtifact.Read. Chat | Relatório de presença e registo de presença | Leia os relatórios de presença e os registros de presença deste webinar ou da reunião geral. |
| VirtualEventRegistration-Anon.ReadWrite. Chat | Registros de eventos virtuais | Registre os participantes e cancele as inscrições para este webinar ou reunião geral. |
Fluxo de autenticação tradicional
Se o RSC não for necessário ou viável, você poderá usar os seguintes fluxos OAuth tradicionais:
- Fluxo de token somente aplicativo: use-o para serviços de back-end ou cenários de automação em que o aplicativo atua sem contexto do usuário.
- Fluxo de token delegado (usuário): use quando as ações exigirem contexto e consentimento do usuário.
Quando usar RSC versus fluxo de token tradicional
| Cenário | Abordagem recomendada |
|---|---|
| O aplicativo precisa apenas de acesso a um webinar ou reunião geral específico | RSC |
| O aplicativo requer acesso em todo o locatário a vários eventos | Fluxo de token somente aplicativo |
| Ações orientadas pelo usuário, como organizador gerenciando eventos | Fluxo de token delegado |
| Mandatos de conformidade ou de segurança exigem privilégios mínimos | RSC |
Introdução ao uso das permissões RSC
As etapas a seguir descrevem como começar a configurar seu aplicativo e usar as permissões RSC:
- Registre seu aplicativo e defina as permissões RSC no manifesto do aplicativo.
- Publique seu aplicativo por meio do portal do desenvolvedor do Teams ou do Partner Center.
- Administração concede RSC no centro de administração do Teams.
- Use as APIs do Microsoft Graph para webinars e reuniões gerais com permissões de escopo.
Criar/atualizar/cancelar
- Use a API Criar reunião municipal para criar um rascunho do evento, seguida pela API Publicar reunião municipal para concluir a criação e torná-la visível para o público.
- A reunião geral criada por meio das APIs do Microsoft Graph é um evento da reunião geral do Teams que é visível e editável no cliente do Teams.
- Assim como no Teams, somente o organizador pode criar, publicar e cancelar reuniões gerais. A API de criação de prefeitura só dá suporte a permissões delegadas em nome do organizador.
- Assim como no Teams, os coorganizadores podem atualizar as reuniões gerais. Para atualizar uma reunião geral, use a API Atualizar reunião geral com permissões delegadas em nome do coorganizador.
Sincronização de dados
- Use a API Obter reunião geral para extrair dados sobre uma reunião geral específica, como quem é convidado, quem criou a reunião geral e quem são os coorganizadores.
- Liste todas as reuniões gerais em um locatário, incluindo as reuniões gerais das quais o usuário é organizador ou coorganizador. Esse cenário tem suporte para permissões delegadas e de aplicativo . No momento, essas APIs só estão disponíveis no ponto de extremidade beta.
Comunicação por Email
Você pode desativar as comunicações por email com os participantes ao criar a reunião geral. Na propriedade settings , defina isAttendeeEmailNotificationEnabled como false. Os emails ainda são enviados para organizadores, coorganizadores e apresentadores (internos e externos).