Casos de utilização da API do webinar de eventos virtuais

As APIs de webinar de eventos virtuais do Microsoft Graph permitem-lhe obter dados do webinar do Teams e criar, atualizar e cancelar programaticamente um webinar do Teams.

Para que possa utilizar melhor as APIs de webinar de eventos virtuais do Graph, é útil compreender as pessoas que acedem à experiência do webinar do Teams:

• Os organizadores são funcionários (na sua organização) que gerem o webinar. São a autoridade agendada e os participantes. Configuram atributos de webinar, tais como título, tema, experiência de participante e regras de e-mail.  
• Os apresentadores são funcionários (na sua organização) ou convidados que lideram o webinar.  
• Os registos são utilizadores (dentro ou fora da sua organização) que se registaram num webinar. Podem ser registados, na lista de espera ou rejeitados. Podem optar por cancelar o registo do webinar.  
• Os participantes são entidades de registo que aderiram ao webinar. Têm de se registar através de um portal e responder a perguntas de registo.
• O administrador inquilino do Teams tem de autorizar aplicações personalizadas com as permissões adequadas.

Pode utilizar os seguintes tipos de recursos para criar a sua solução de webinar:

• virtualEventWebinar – utilizado para criar, obter, atualizar, publicar, cancelar e listar webinars do Teams.
• virtualEventRegistration – utilizado para criar, obter, cancelar e listar registos de registos de entidades de registo de um webinar. Fornece o URL de associação ao webinar do Teams exclusivo para o registo registado.
• virtualEventRegistrationQuestion – utilizado para criar, listar e eliminar perguntas de registo personalizadas ou perguntas de registo predefinidas para os registos responderem quando se registam num webinar.
• virtualEventRegistrationConfiguration – contém informações sobre uma configuração de registo de webinar que armazena o URL do portal de registo do webinar.
• virtualEventPresenter – utilizado para criar, obter, listar, atualizar e eliminar um apresentador de um webinar do Teams.
• virtualEventSession – um webinar criado através das APIs do Microsoft Graph tem apenas uma sessão que herda as propriedades das reuniões online.
• meetingAttendanceReport – sempre que um webinar termina, é gerado um relatório de participação para a sessão, mas não inclui os dados dos participantes.
• attendanceRecord – fornece os dados dos participantes do webinar no relatório de presenças.
• webhooks de eventos virtuais – pode receber notificações de alterações a um webinar, registo de webinar, sessão, relatório de participação, entre outros.

Soluções que pode criar

A tabela seguinte lista algumas soluções que pode criar com o cliente teams e as APIs de webinar e webhooks do Microsoft Graph.

Consentimento específico do recurso (RSC) para eventos virtuais

O consentimento específico do recurso (RSC) permite que as aplicações solicitem permissões no âmbito de um webinar ou câmara municipal específico em vez de exigirem privilégios de administrador global. As permissões RSC melhoram a segurança, simplificam os fluxos de consentimento e permitem aos programadores criar integrações que respeitam os limites organizacionais.

APIs e permissões RSC de eventos virtuais do Microsoft Graph ativadas

Fluxo de autenticação tradicional

Se o RSC não for necessário ou viável, pode utilizar os seguintes fluxos OAuth tradicionais:

• Fluxo de token apenas de aplicação: utilize-o para serviços de back-end ou cenários de automatização em que a aplicação age sem contexto de utilizador.
• Fluxo de token delegado (utilizador): utilize quando as ações requerem o contexto e o consentimento do utilizador.

Quando utilizar o RSC vs. fluxo de token tradicional

Introdução à utilização de permissões RSC

Os passos seguintes descrevem como começar a configurar a sua aplicação e utilizar permissões RSC:

1. Registe a sua aplicação e defina as permissões RSC no manifesto da aplicação.
2. Publique a sua aplicação através do portal do programador do Teams ou do centro de parceiros.
3. Administração concede RSC no centro de administração do Teams.
4. Utilize as APIs do Microsoft Graph para webinars e câmaras municipais com permissões de âmbito.

Criar/atualizar/cancelar

• Utilize a API Criar webinar para criar um rascunho do evento, seguido da API Publicar webinar para concluir a criação e torná-la visível para a audiência.
  • O webinar criado através das APIs do Microsoft Graph é um webinar do Teams que é visível e editável no cliente do Teams.
  • Tal como no Teams, apenas o organizador pode criar, publicar e cancelar eventos de webinar. A API de criação de webinar só suporta permissões delegadas em nome do organizador.
• Tal como no Teams, os coorganizadores podem atualizar webinars. Para atualizar os webinars, utilize a API do webinar Update com permissões delegadas em nome do coorganizador.
• Subscreva as notificações de alteração para obter atualizações sobre quaisquer alterações efetuadas ao webinar. 

Sincronização de dados

• Subscreva as notificações de alteração para obter atualizações sobre quaisquer alterações efetuadas ao webinar.
• Para obter dados de relatórios de assiduidade de um webinar, utilize Listar registos de participação ou Obter registo de presença com uma opção de consulta.
  • Para obter informações de presença de um participante do webinar, após uma lista ou obter um pedido, mapeie a propriedade ID no registo de eventos virtuais para a propriedade registrationId no registo de presença (atualmente apenas disponível no ponto final beta).
• Obtenha dados para um webinar específico, liste todos os webinars num inquilino, liste webinars em que o utilizador é um organizador ou coorganizador, liste webinars em que o utilizador especificado é o organizador ou coorganizador.
• Para obter o URL do portal de registo do webinar do Teams para o seu webinar, utilize Obter configuração de registo do webinar.

Registro

• Utilize Criar registo para registar utilizadores através de programação no seu webinar. Os organizadores, coorganizadores e apresentadores não precisam de se registar. Se os registos têm ou não contas Microsoft Entra afeta as permissões de que precisa para chamar a API.
• As perguntas de registo CREATE (predefinidas ou personalizadas) têm de responder às perguntas necessárias durante o registo.
• Depois de o registo se registar no webinar, utilize Sessões de lista para obter o exclusivo joinWebURL para o webinar.

comunicação Email

• Pode desativar as comunicações por e-mail para os participantes quando criar o webinar. Na propriedade definições , defina isAttendeeEmailNotificationEnabled como false. Os e-mails continuam a ser enviados para organizadores, coorganizadores e apresentadores (internos e externos).
• Pode subscrever as notificações de alteração para criar o seu próprio sistema de comunicação por e-mail personalizado.