Casos de uso de la API de seminario web de eventos virtuales

Las API de seminario web de eventos virtuales de Microsoft Graph le permiten obtener datos del seminario web de Teams y crear, actualizar y cancelar un seminario web de Teams mediante programación.

Para que pueda hacer el mejor uso de las API de seminario web de eventos virtuales de Graph, es útil comprender los roles de los usuarios que acceden a la experiencia del seminario web de Teams:

• Los organizadores son empleados (de su organización) que administran el seminario web. Son la autoridad según la programación y los participantes. Configuran atributos de seminario web, como título, tema, experiencia de asistente y reglas de correo electrónico.  
• Los moderadores son empleados (de su organización) o invitados que dirigen el seminario web.  
• Los solicitantes de registro son usuarios (dentro o fuera de su organización) que se registraron para un seminario web. Se pueden registrar, incluir en la lista de espera o rechazarse. Pueden optar por cancelar el registro del seminario web.  
• Los asistentes son solicitantes de registro que se unieron al seminario web. Deben registrarse a través de un portal y responder a las preguntas de registro.
• El administrador de inquilinos de Teams debe autorizar aplicaciones personalizadas con los permisos adecuados.

Puede usar los siguientes tipos de recursos para compilar la solución de seminario web:

• virtualEventWebinar : se usa para crear, obtener, actualizar, publicar, cancelar y enumerar seminarios web de Teams.
• virtualEventRegistration : se usa para crear, obtener, cancelar y enumerar registros de solicitantes de registro de un seminario web. Proporciona la dirección URL única de unión al seminario web de Teams para el solicitante de registro registrado.
• virtualEventRegistrationQuestion : se usa para crear, enumerar y eliminar preguntas de registro personalizadas o preguntas de registro predefinidas para que los solicitantes de registro respondan cuando se registren en un seminario web.
• virtualEventRegistrationConfiguration : contiene información sobre una configuración de registro de seminario web que almacena la dirección URL del portal de registro del seminario web.
• virtualEventPresenter : se usa para crear, obtener, enumerar, actualizar y eliminar un moderador para un seminario web de Teams.
• virtualEventSession : un seminario web creado a través de las API de Microsoft Graph solo tiene una sesión que hereda las propiedades de las reuniones en línea.
• meetingAttendanceReport : cada vez que finaliza un seminario web, se genera un informe de asistencia para la sesión, pero no incluye los datos de los asistentes.
• attendanceRecord : proporciona datos de asistentes del seminario web en el informe de asistencia.
• webhooks de eventos virtuales : puede recibir notificaciones de cambios en un seminario web, registro de seminario web, sesión, informe de asistencia, etc.

Soluciones que puede crear

En la tabla siguiente se enumeran algunas soluciones que puede crear mediante el cliente de Teams y las API de seminario web y webhooks de Microsoft Graph.

Consentimiento específico de recursos (RSC) para eventos virtuales

El consentimiento específico de recursos (RSC) permite a las aplicaciones solicitar permisos con ámbito a un seminario web o ayuntamiento específico en lugar de requerir privilegios de administrador global. Los permisos de RSC mejoran la seguridad, simplifican los flujos de consentimiento y permiten a los desarrolladores crear integraciones que respeten los límites de la organización.

API de eventos virtuales de Microsoft Graph habilitadas y permisos de RSC

Flujo de autenticación tradicional

Si RSC no es necesario o factible, puede usar los siguientes flujos de OAuth tradicionales:

• Flujo de token de solo aplicación: úselo para los servicios back-end o escenarios de automatización en los que la aplicación actúa sin contexto de usuario.
• Flujo de token delegado (usuario): se usa cuando las acciones requieren el contexto y el consentimiento del usuario.

Cuándo usar RSC frente al flujo de token tradicional

Introducción al uso de permisos de RSC

En los pasos siguientes se describe cómo empezar a configurar la aplicación y usar permisos de RSC:

1. Registre la aplicación y defina los permisos de RSC en el manifiesto de la aplicación.
2. Publique la aplicación a través del portal para desarrolladores de Teams o del Centro de partners.
3. Administración concede RSC en el Centro de administración de Teams.
4. Use las API de Microsoft Graph para seminarios web y ayuntamientos con permisos con ámbito.

Crear, actualizar o cancelar

• Use la API Crear seminario web para crear un borrador del evento, seguido de la API publicar seminario web para completar la creación y hacer que sea visible para su público.
  • El seminario web creado a través de las API de Microsoft Graph es un seminario web de Teams que es visible y editable en el cliente de Teams.
  • Al igual que en Teams, solo el organizador puede crear, publicar y cancelar eventos de seminario web. La API create webinar solo admite permisos delegados en nombre del organizador.
• Al igual que en Teams, los coorganizadores pueden actualizar seminarios web. Para actualizar seminarios web, use la API Actualizar seminario web con permisos delegados en nombre del coorganizador.
• Suscríbase a notificaciones de cambios para obtener actualizaciones sobre los cambios realizados en el seminario web. 

Sincronización de datos

• Suscríbase a notificaciones de cambios para obtener actualizaciones sobre los cambios realizados en el seminario web.
• Para obtener datos de informes de asistencia de un seminario web, use Enumerar registros de asistencia o Obtener registro de asistencia con una opción de consulta.
  • Para obtener información de asistencia de un asistente al seminario web, después de una lista u obtener una solicitud, asigne la propiedad Id en el registro de eventos virtuales a la propiedad registrationId en el registro de asistencia (actualmente solo está disponible en el punto de conexión beta).
• Obtenga datos para un seminario web específico, enumere todo el seminario web de un inquilino, enumere los seminarios web en los que el usuario sea organizador o coorganizador, enumere los seminarios web en los que el usuario especificado sea el organizador o coorganizador.
• Para obtener la dirección URL del portal de registro del seminario web de Teams para su seminario web, use Obtener configuración de registro del seminario web.

Registro

• Use Crear registro para registrar usuarios mediante programación en el seminario web. Los organizadores, coorganizadores y moderadores no necesitan registrarse. Si los solicitantes de registro tienen o no cuentas de Microsoft Entra afecta a los permisos que necesita para llamar a la API.
• Los asistentes create registration questions (predefinidos o personalizados) deben responder a las preguntas necesarias durante el registro.
• Una vez que el solicitante de registro se registre en el seminario web, use Sesiones de lista para obtener el único joinWebURL para el seminario web.

Email comunicación

• Puede desactivar las comunicaciones por correo electrónico a los asistentes al crear el seminario web. En la propiedad settings , establezca en isAttendeeEmailNotificationEnabledfalse. Los correos electrónicos se siguen enviando a los organizadores, coorganizadores y moderadores (internos y externos).
• Puede suscribirse a notificaciones de cambio para crear su propio sistema de comunicación por correo electrónico personalizado.