From b18d4f81fb88aa7e9402cbd16159c1d010e725ed Mon Sep 17 00:00:00 2001 From: Annie Wang <107498920+awang119@users.noreply.github.com> Date: Mon, 11 Nov 2024 03:41:34 -0800 Subject: [PATCH 001/130] added virtual events into toc.yml --- concepts/toc.yml | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/concepts/toc.yml b/concepts/toc.yml index f3e75d5dc36..02a64223092 100644 --- a/concepts/toc.yml +++ b/concepts/toc.yml @@ -926,6 +926,14 @@ items: href: cloud-communications-identifylargegalleryview.md - name: Manage watermarks for sensitive meetings href: cloud-communications-watermark-meeting.md + - name: Virtual events + items: + - name: Choose the right meeting type + href: cloud-communications-virtual-events-overview.md + - name: Town hall use cases + href: cloud-communications-virtual-events-townhall-usecases.md + - name: Webinar use cases + href: cloud-communications-virtual-events-webinar-usecases.md - name: Change notifications items: - name: Subscribe to teams, chats, channels From 73a57e199a0a9bda815fbe2d7febc19ac70370be Mon Sep 17 00:00:00 2001 From: Annie Wang <107498920+awang119@users.noreply.github.com> Date: Mon, 11 Nov 2024 03:43:15 -0800 Subject: [PATCH 002/130] Create cloud-communications-virtual-events-overview.md --- ...-communications-virtual-events-overview.md | 27 +++++++++++++++++++ 1 file changed, 27 insertions(+) create mode 100644 concepts/cloud-communications-virtual-events-overview.md diff --git a/concepts/cloud-communications-virtual-events-overview.md b/concepts/cloud-communications-virtual-events-overview.md new file mode 100644 index 00000000000..9a196339150 --- /dev/null +++ b/concepts/cloud-communications-virtual-events-overview.md @@ -0,0 +1,27 @@ +--- +title: "Choose the right meeting type" +description: "Consider when to use online meetings API, webinar API or town hall API for Teams meetings." +author: "awang119" +ms.localizationpriority: medium +ms.subservice: "cloud-communications" +--- + +# Choose the right meeting type + +Microsoft Teams and Microsoft Graph supports multiple types of scheduled real-time voice and video experiences. These range from ad hoc meetings suitable for a small number of participants to large structured virtual events like webinars and town halls with thousands of attendees. + +Use the following table to choose the right meeting type for your use case. +| **Teams Meeting type** |**Microsoft Graph** | **Use cases** | +| ------------- | ------------- | ------------- | +| [Online meeting](https://support.microsoft.com/en-us/office/meetings-in-microsoft-teams-e0b0ae21-53ee-4462-a50d-ca9b9e217b67) |[onlineMeeting](../api-reference/v1.0/resources/onlinemeeting.md)
[attendanceReport](../api-reference/v1.0/resources/meetingattendancereport.md)
[attendanceRecord](../api-reference/v1.0/resources/attendancerecord.md)
[online meeting webhooks](/concepts/changenotifications-for-onlinemeeting.md) | | +| [Webinar](https://support.microsoft.com/en-us/office/get-started-with-microsoft-teams-webinars-42f3f874-22dc-4289-b53f-bbc1a69013e3) |[virtualEventWebinar](../api-reference/v1.0/resources/virtualeventwebinar.md)
[virtualEventRegistration](../api-reference/v1.0/resources/virtualeventregistration.md)
[virtualEventRegistrationConfiguration](../api-reference/v1.0/resources/virtualeventregistrationconfiguration.md)
[virtualEventRegistrationQuestion](../api-reference/v1.0/resources/virtualeventregistrationquestionbase.md)
[meetingAttendanceReport](../api-reference/v1.0/resources/meetingattendancereport.md)
[attendanceRecord](../api-reference/v1.0/resources/attendancerecord.md)
[virtualEventSession](../api-reference/v1.0/resources/virtualeventsession.md)
[virtualEventPresenter](../api-reference/v1.0/resources/virtualeventpresenter.md)
[virtual event webhooks](/concepts/changenotifications-for-virtualevent.md)| | +| [Town hall](https://support.microsoft.com/en-us/office/get-started-with-town-hall-in-microsoft-teams-33baf0c6-0283-4c15-9617-3013e8d4804f) | [virtualEventTownhall](../api-reference/v1.0/resources/virtualeventtownhall.md)
[virtualEventSession](../api-reference/v1.0/resources/virtualeventsession.md)
[virtualEventPresenter](../api-reference/v1.0/resources/virtualeventpresenter.md) | + +To learn more about the differences between each meeting type to help you choose the one that is best suited for your use case, see the [feature comparison chart](https://learn.microsoft.com/en-us/microsoftteams/meeting-webinar-town-hall-feature-comparison). + + +## Next Steps +- [Create or join online meetings](cloud-communications-online-meetings.md) - Learn about how to use online meetings APIs. +- [Webinar use cases](cloud-communications-virtual-events-webinar-usecases.md) - Learn how to create solutions with webinar APIs. +- [Town hall use cases](cloud-communications-virtual-events-townhall-usecases.md) - Learn how to create solutions with town hall APIs. From 495054f9afa568c6ff1fcfc19795f2e888eaad55 Mon Sep 17 00:00:00 2001 From: Annie Wang <107498920+awang119@users.noreply.github.com> Date: Mon, 11 Nov 2024 03:44:08 -0800 Subject: [PATCH 003/130] Create cloud-communications-virtual-events-webinar-usecases.md --- ...cations-virtual-events-webinar-usecases.md | 62 +++++++++++++++++++ 1 file changed, 62 insertions(+) create mode 100644 concepts/cloud-communications-virtual-events-webinar-usecases.md diff --git a/concepts/cloud-communications-virtual-events-webinar-usecases.md b/concepts/cloud-communications-virtual-events-webinar-usecases.md new file mode 100644 index 00000000000..069de29f3c5 --- /dev/null +++ b/concepts/cloud-communications-virtual-events-webinar-usecases.md @@ -0,0 +1,62 @@ +--- +title: "Virtual events webinar use cases" +description: "List of use cases that can be enabled using virtual events webinar APIs" +author: "awang119" +ms.localizationpriority: medium +ms.subservice: "cloud-communications" +--- +# Virtual events webinar API overview +Microsoft Graph virtual events webinar APIs allows you to get Teams webinar data and programmatically create, update and delete a Teams webinar. + +To make the best use of the Graph virtual events webinar APIs, it’s helpful to understand the personas for the users who access the Teams webinar experience: + +- **Organizers** are employees (in your organization) who manage the webinar. They are the authority on schedule and participants. They configure webinar attributes such as title, theme, attendee experience, and email rules.   +- **Presenters** are employees (in your organization) or external participants who lead the webinar.   +- **Registrants** are users (in or outside of your organization) who have registered for a webinar. They can be registered, waitlisted, or rejected. They can choose to cancel their webinar registration.   +- **Attendees** are registrants who join the webinar. They need to have registered through a portal and answered registration questions. +- **Teams tenant administrator** must authorize custom applications with appropriate permissions. + +**[INSERT TABLE OF DIFF PERSONAS AND PERMISSIONS]** + +The following resource types can be used to build your webinar solution +- [virtualEventWebinar](../api-reference/v1.0/resources/virtualeventwebinar.md) – Used to create, get, update, publish, cancel, and list Teams webinars. +- [virtualEventRegistration](../api-reference/v1.0/resources/virtualeventregistration.md) – Used to create, get, cancel, and list registration records of registrants of a webinar. Provides the unique Teams webinar join URL for the registered registrant. +- [virtualEventRegistrationQuestion](../api-reference/v1.0/resources/virtualeventregistrationquestionbase.md) – Used to create, list, and delete either custom registration questions or predefined registration questions for registrants to answer when they register for a webinar. +- [virtualEventRegistrationConfiguration](../api-reference/v1.0/resources/virtualeventregistrationconfiguration.md) – Contains information about a webinar registration configuration that stores the registration portal URL of the webinar. +- [virtualEventPresenter](../api-reference/v1.0/resources/virtualeventpresenter.md) – Used to create, get, list, update and delete a presenter for a Teams webinar. +- [virtualEventSession](../api-reference/v1.0/resources/virtualeventsession.md) – A webinar created via Microsoft Graph APIs only has one session that inherits the properties of online meetings. +- [meetingAttendanceReport](../api-reference/v1.0/resources/meetingattendancereport.md) – Each time a webinar ends, an attendance report is generated for the session but doesn’t include attendee data. +- [attendanceRecord](../api-reference/v1.0/resources/attendancerecord.md) – Provides webinar attendee data in the attendance report. +- [virtual event webhooks](/concepts/changenotifications-for-virtualevent.md) – Can receive notifications for changes to a webinar, webinar registration, session, attendance report, and so on. + + +## Solutions you can build +The following table lists some solutions you can build by using the Teams client and Microsoft Graph webinar APIs and webhooks. +| **Solutions** | **Description** | +| ------------- | ------------- | +| [Create/update/delete](#createupdatedelete) | Programmatically create, update, and delete Teams webinars.| +| [Data Sync](#data-sync) | Pull Teams webinar data in a custom application (i.e. attendees, registration questions, attendance report, and more). | +| [Registration](#registration) | Host your own registration portal experience for a Teams webinar and sync the registration data to the Teams client. | +| [Email communication](#email-communication)| Use your own email infrastructure to send out webinar-related notification emails. | + +> [!NOTE] +>To build any Graph solutions, follow this guide on [how to register and give the right permissions to your application](/concepts/auth/auth-concepts.md). + +### Create/update/delete + +1. Use the Create webinar API to create a draft of the event, followed by the Publish webinar API to complete the creation and make it visible to its audience. + + The webinar created via Microsoft Graph APIs will be a Teams webinar that’s visible and editable in the Teams client + + Just like in Teams, organizers can only create webinar events. The Create webinar API can only be called with delegated permissions on behalf of the organizer. + +3. Only organizers and co-organizers can update and delete webinars. + +4. Subscribe to change notifications to get updates about any changes made to the webinar.  + +### Data Sync + + +### Registration + +### Email communication From 0ede93d6ad4431d103c20ffea58987a97c5c0c95 Mon Sep 17 00:00:00 2001 From: Annie Wang <107498920+awang119@users.noreply.github.com> Date: Mon, 11 Nov 2024 03:44:26 -0800 Subject: [PATCH 004/130] Create cloud-communications-virtual-events-townhall-usecases.md --- .../cloud-communications-virtual-events-townhall-usecases.md | 1 + 1 file changed, 1 insertion(+) create mode 100644 concepts/cloud-communications-virtual-events-townhall-usecases.md diff --git a/concepts/cloud-communications-virtual-events-townhall-usecases.md b/concepts/cloud-communications-virtual-events-townhall-usecases.md new file mode 100644 index 00000000000..8b137891791 --- /dev/null +++ b/concepts/cloud-communications-virtual-events-townhall-usecases.md @@ -0,0 +1 @@ + From 56be7dfc358d7671fe6ff4d3dc3dee5654c12ab2 Mon Sep 17 00:00:00 2001 From: Annie Wang <107498920+awang119@users.noreply.github.com> Date: Mon, 11 Nov 2024 03:51:58 -0800 Subject: [PATCH 005/130] Updated next steps in cloud-communications-virtual-events-overview.md --- concepts/cloud-communications-virtual-events-overview.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/concepts/cloud-communications-virtual-events-overview.md b/concepts/cloud-communications-virtual-events-overview.md index 9a196339150..fd27fec8a5b 100644 --- a/concepts/cloud-communications-virtual-events-overview.md +++ b/concepts/cloud-communications-virtual-events-overview.md @@ -22,6 +22,7 @@ To learn more about the differences between each meeting type to help you choose ## Next Steps -- [Create or join online meetings](cloud-communications-online-meetings.md) - Learn about how to use online meetings APIs. -- [Webinar use cases](cloud-communications-virtual-events-webinar-usecases.md) - Learn how to create solutions with webinar APIs. -- [Town hall use cases](cloud-communications-virtual-events-townhall-usecases.md) - Learn how to create solutions with town hall APIs. +- [Create or join online meetings](cloud-communications-online-meetings.md) - Learn to use online meetings APIs. +- [Webinar use cases](cloud-communications-virtual-events-webinar-usecases.md) - Learn to create solutions with webinar APIs. +- [Town hall use cases](cloud-communications-virtual-events-townhall-usecases.md) - Learn to create solutions with town hall APIs. +- [Virtual event webhooks](/concepts/changenotifications-for-virtualevent.md)- Learn to use virtual event webhooks. From 5f7a8e714de74eeca58a0c79e868bfe31e928c15 Mon Sep 17 00:00:00 2001 From: Annie Wang <107498920+awang119@users.noreply.github.com> Date: Mon, 11 Nov 2024 04:19:12 -0800 Subject: [PATCH 006/130] Update CUD section of cloud-communications-virtual-events-webinar-usecases.md --- ...unications-virtual-events-webinar-usecases.md | 16 +++++++--------- 1 file changed, 7 insertions(+), 9 deletions(-) diff --git a/concepts/cloud-communications-virtual-events-webinar-usecases.md b/concepts/cloud-communications-virtual-events-webinar-usecases.md index 069de29f3c5..e3feac6e6cd 100644 --- a/concepts/cloud-communications-virtual-events-webinar-usecases.md +++ b/concepts/cloud-communications-virtual-events-webinar-usecases.md @@ -16,8 +16,6 @@ To make the best use of the Graph virtual events webinar APIs, it’s helpful to - **Attendees** are registrants who join the webinar. They need to have registered through a portal and answered registration questions. - **Teams tenant administrator** must authorize custom applications with appropriate permissions. -**[INSERT TABLE OF DIFF PERSONAS AND PERMISSIONS]** - The following resource types can be used to build your webinar solution - [virtualEventWebinar](../api-reference/v1.0/resources/virtualeventwebinar.md) – Used to create, get, update, publish, cancel, and list Teams webinars. - [virtualEventRegistration](../api-reference/v1.0/resources/virtualeventregistration.md) – Used to create, get, cancel, and list registration records of registrants of a webinar. Provides the unique Teams webinar join URL for the registered registrant. @@ -34,7 +32,7 @@ The following resource types can be used to build your webinar solution The following table lists some solutions you can build by using the Teams client and Microsoft Graph webinar APIs and webhooks. | **Solutions** | **Description** | | ------------- | ------------- | -| [Create/update/delete](#createupdatedelete) | Programmatically create, update, and delete Teams webinars.| +| [Create/update/cancel](#createupdatecancel) | Programmatically create, update, and delete Teams webinars.| | [Data Sync](#data-sync) | Pull Teams webinar data in a custom application (i.e. attendees, registration questions, attendance report, and more). | | [Registration](#registration) | Host your own registration portal experience for a Teams webinar and sync the registration data to the Teams client. | | [Email communication](#email-communication)| Use your own email infrastructure to send out webinar-related notification emails. | @@ -42,17 +40,17 @@ The following table lists some solutions you can build by using the Teams client > [!NOTE] >To build any Graph solutions, follow this guide on [how to register and give the right permissions to your application](/concepts/auth/auth-concepts.md). -### Create/update/delete +### Create/update/cancel -1. Use the Create webinar API to create a draft of the event, followed by the Publish webinar API to complete the creation and make it visible to its audience. +1. Use the [Create webinar API](../api-reference/v1.0/resources/virtualeventsroot-post-webinars.md) to create a draft of the event, followed by the [Publish webinar API](../api-reference/v1.0/resources/virtualeventwebinar-publish.md) to complete the creation and make it visible to its audience. - The webinar created via Microsoft Graph APIs will be a Teams webinar that’s visible and editable in the Teams client + - The webinar created via Microsoft Graph APIs will be a Teams webinar that’s visible and editable in the Teams client. - Just like in Teams, organizers can only create webinar events. The Create webinar API can only be called with delegated permissions on behalf of the organizer. + - Just like in Teams, only the organizer can create, publish and cancel webinar events. That is why Create webinar API can only be called with delegated permissions on behalf of the organizer. -3. Only organizers and co-organizers can update and delete webinars. +2. Like in Teams, co-organizers can update webinars. Use the [Update webinar API](../api-reference/v1.0/resources/virtualeventwebinar-update.md) with delegated permissions on behalf of the co-organizer to do so. -4. Subscribe to change notifications to get updates about any changes made to the webinar.  +3. Subscribe to [change notifications](/concepts/changenotifications-for-virtualevent#subscribable-virtual-events.md) to get updates about any changes made to the webinar.  ### Data Sync From 1c1bfca209710c04f6e16d0cc5156d51200d52f0 Mon Sep 17 00:00:00 2001 From: Annie Wang <107498920+awang119@users.noreply.github.com> Date: Mon, 11 Nov 2024 04:46:15 -0800 Subject: [PATCH 007/130] added data sync section to cloud-communications-virtual-events-webinar-usecases.md --- ...nications-virtual-events-webinar-usecases.md | 17 ++++++++++------- 1 file changed, 10 insertions(+), 7 deletions(-) diff --git a/concepts/cloud-communications-virtual-events-webinar-usecases.md b/concepts/cloud-communications-virtual-events-webinar-usecases.md index e3feac6e6cd..d13d2089926 100644 --- a/concepts/cloud-communications-virtual-events-webinar-usecases.md +++ b/concepts/cloud-communications-virtual-events-webinar-usecases.md @@ -20,7 +20,7 @@ The following resource types can be used to build your webinar solution - [virtualEventWebinar](../api-reference/v1.0/resources/virtualeventwebinar.md) – Used to create, get, update, publish, cancel, and list Teams webinars. - [virtualEventRegistration](../api-reference/v1.0/resources/virtualeventregistration.md) – Used to create, get, cancel, and list registration records of registrants of a webinar. Provides the unique Teams webinar join URL for the registered registrant. - [virtualEventRegistrationQuestion](../api-reference/v1.0/resources/virtualeventregistrationquestionbase.md) – Used to create, list, and delete either custom registration questions or predefined registration questions for registrants to answer when they register for a webinar. -- [virtualEventRegistrationConfiguration](../api-reference/v1.0/resources/virtualeventregistrationconfiguration.md) – Contains information about a webinar registration configuration that stores the registration portal URL of the webinar. +- [virtualEventRegistrationConfiguration](../api-reference/v1.0/resources/virtualeventwebinarregistrationconfiguration.md) – Contains information about a webinar registration configuration that stores the registration portal URL of the webinar. - [virtualEventPresenter](../api-reference/v1.0/resources/virtualeventpresenter.md) – Used to create, get, list, update and delete a presenter for a Teams webinar. - [virtualEventSession](../api-reference/v1.0/resources/virtualeventsession.md) – A webinar created via Microsoft Graph APIs only has one session that inherits the properties of online meetings. - [meetingAttendanceReport](../api-reference/v1.0/resources/meetingattendancereport.md) – Each time a webinar ends, an attendance report is generated for the session but doesn’t include attendee data. @@ -32,7 +32,7 @@ The following resource types can be used to build your webinar solution The following table lists some solutions you can build by using the Teams client and Microsoft Graph webinar APIs and webhooks. | **Solutions** | **Description** | | ------------- | ------------- | -| [Create/update/cancel](#createupdatecancel) | Programmatically create, update, and delete Teams webinars.| +| [Create/update/cancel](#createupdatecancel) | Programmatically create, update, and cancel Teams webinars.| | [Data Sync](#data-sync) | Pull Teams webinar data in a custom application (i.e. attendees, registration questions, attendance report, and more). | | [Registration](#registration) | Host your own registration portal experience for a Teams webinar and sync the registration data to the Teams client. | | [Email communication](#email-communication)| Use your own email infrastructure to send out webinar-related notification emails. | @@ -42,18 +42,21 @@ The following table lists some solutions you can build by using the Teams client ### Create/update/cancel -1. Use the [Create webinar API](../api-reference/v1.0/resources/virtualeventsroot-post-webinars.md) to create a draft of the event, followed by the [Publish webinar API](../api-reference/v1.0/resources/virtualeventwebinar-publish.md) to complete the creation and make it visible to its audience. +- Use the [Create webinar API](../api-reference/v1.0/resources/virtualeventsroot-post-webinars.md) to create a draft of the event, followed by the [Publish webinar API](../api-reference/v1.0/resources/virtualeventwebinar-publish.md) to complete the creation and make it visible to its audience. - The webinar created via Microsoft Graph APIs will be a Teams webinar that’s visible and editable in the Teams client. - Just like in Teams, only the organizer can create, publish and cancel webinar events. That is why Create webinar API can only be called with delegated permissions on behalf of the organizer. -2. Like in Teams, co-organizers can update webinars. Use the [Update webinar API](../api-reference/v1.0/resources/virtualeventwebinar-update.md) with delegated permissions on behalf of the co-organizer to do so. - -3. Subscribe to [change notifications](/concepts/changenotifications-for-virtualevent#subscribable-virtual-events.md) to get updates about any changes made to the webinar.  +- Like in Teams, co-organizers can update webinars. Use the [Update webinar API](../api-reference/v1.0/resources/virtualeventwebinar-update.md) with delegated permissions on behalf of the co-organizer to do so. +- Subscribe to [change notifications](/concepts/changenotifications-for-virtualevent#subscribable-virtual-events.md) to get updates about any changes made to the webinar.  ### Data Sync - +- Subscribe to [change notifications](/concepts/changenotifications-for-virtualevent#subscribable-virtual-events.md) to get updates about any changes made to the webinar. +- To get attendance report data for a webinar, use [list attendance records](../api-reference/v1.0/resources/attendancerecord-list.md) or [get attendance record with a query option](../api-reference/v1.0/resources/meetingattendancereport-get#example-2-get-the-attendance-report-for-a-webinar-session-by-id.md). +- To get attendance information of a webinar attendee, map the `Id` property in [virtual event registration](../api-reference/v1.0/resources/virtualeventregistration.md) to the `registrationId` property in [attendance record](../api-reference/beta/resources/attendancerecord.md) (currently only available in Beta). +- Get data for a specific webinar, list all the webinar in a tenant, list webinars where the user is an organizer or co-organizer, list webinars where the specified user is either the organizer or co-organizer. +- To get the Teams webinar registration portal URL for your webinar, use [Get webinar registration configuration](../api-reference/v1.0/resources/virtualeventwebinarregistrationconfiguration-get.md). ### Registration From 713776e898d18bfa6bd250c8479a65615ba5e432 Mon Sep 17 00:00:00 2001 From: Annie Wang <107498920+awang119@users.noreply.github.com> Date: Mon, 11 Nov 2024 04:48:08 -0800 Subject: [PATCH 008/130] updated virtualeventwebinarregistrationconfiguration in cloud-communications-virtual-events-overview.md --- concepts/cloud-communications-virtual-events-overview.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/concepts/cloud-communications-virtual-events-overview.md b/concepts/cloud-communications-virtual-events-overview.md index fd27fec8a5b..e56f11ca697 100644 --- a/concepts/cloud-communications-virtual-events-overview.md +++ b/concepts/cloud-communications-virtual-events-overview.md @@ -14,7 +14,7 @@ Use the following table to choose the right meeting type for your use case. | **Teams Meeting type** |**Microsoft Graph** | **Use cases** | | ------------- | ------------- | ------------- | | [Online meeting](https://support.microsoft.com/en-us/office/meetings-in-microsoft-teams-e0b0ae21-53ee-4462-a50d-ca9b9e217b67) |[onlineMeeting](../api-reference/v1.0/resources/onlinemeeting.md)
[attendanceReport](../api-reference/v1.0/resources/meetingattendancereport.md)
[attendanceRecord](../api-reference/v1.0/resources/attendancerecord.md)
[online meeting webhooks](/concepts/changenotifications-for-onlinemeeting.md) | | -| [Webinar](https://support.microsoft.com/en-us/office/get-started-with-microsoft-teams-webinars-42f3f874-22dc-4289-b53f-bbc1a69013e3) |[virtualEventWebinar](../api-reference/v1.0/resources/virtualeventwebinar.md)
[virtualEventRegistration](../api-reference/v1.0/resources/virtualeventregistration.md)
[virtualEventRegistrationConfiguration](../api-reference/v1.0/resources/virtualeventregistrationconfiguration.md)
[virtualEventRegistrationQuestion](../api-reference/v1.0/resources/virtualeventregistrationquestionbase.md)
[meetingAttendanceReport](../api-reference/v1.0/resources/meetingattendancereport.md)
[attendanceRecord](../api-reference/v1.0/resources/attendancerecord.md)
[virtualEventSession](../api-reference/v1.0/resources/virtualeventsession.md)
[virtualEventPresenter](../api-reference/v1.0/resources/virtualeventpresenter.md)
[virtual event webhooks](/concepts/changenotifications-for-virtualevent.md)| | +| [Webinar](https://support.microsoft.com/en-us/office/get-started-with-microsoft-teams-webinars-42f3f874-22dc-4289-b53f-bbc1a69013e3) |[virtualEventWebinar](../api-reference/v1.0/resources/virtualeventwebinar.md)
[virtualEventRegistration](../api-reference/v1.0/resources/virtualeventregistration.md)
[virtualEventRegistrationConfiguration](../api-reference/v1.0/resources/virtualeventwebinarregistrationconfiguration.md)
[virtualEventRegistrationQuestion](../api-reference/v1.0/resources/virtualeventregistrationquestionbase.md)
[meetingAttendanceReport](../api-reference/v1.0/resources/meetingattendancereport.md)
[attendanceRecord](../api-reference/v1.0/resources/attendancerecord.md)
[virtualEventSession](../api-reference/v1.0/resources/virtualeventsession.md)
[virtualEventPresenter](../api-reference/v1.0/resources/virtualeventpresenter.md)
[virtual event webhooks](/concepts/changenotifications-for-virtualevent.md)| | | [Town hall](https://support.microsoft.com/en-us/office/get-started-with-town-hall-in-microsoft-teams-33baf0c6-0283-4c15-9617-3013e8d4804f) | [virtualEventTownhall](../api-reference/v1.0/resources/virtualeventtownhall.md)
[virtualEventSession](../api-reference/v1.0/resources/virtualeventsession.md)
[virtualEventPresenter](../api-reference/v1.0/resources/virtualeventpresenter.md) | From 63ed34548b0bd2114501003ccd7c7aaf9312c384 Mon Sep 17 00:00:00 2001 From: Annie Wang <107498920+awang119@users.noreply.github.com> Date: Mon, 11 Nov 2024 05:03:10 -0800 Subject: [PATCH 009/130] Fixed hyperlinks cloud-communications-virtual-events-webinar-usecases.md --- ...d-communications-virtual-events-webinar-usecases.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/concepts/cloud-communications-virtual-events-webinar-usecases.md b/concepts/cloud-communications-virtual-events-webinar-usecases.md index d13d2089926..511dc40029b 100644 --- a/concepts/cloud-communications-virtual-events-webinar-usecases.md +++ b/concepts/cloud-communications-virtual-events-webinar-usecases.md @@ -42,21 +42,21 @@ The following table lists some solutions you can build by using the Teams client ### Create/update/cancel -- Use the [Create webinar API](../api-reference/v1.0/resources/virtualeventsroot-post-webinars.md) to create a draft of the event, followed by the [Publish webinar API](../api-reference/v1.0/resources/virtualeventwebinar-publish.md) to complete the creation and make it visible to its audience. +- Use the [Create webinar API](../api-reference/v1.0/api/virtualeventsroot-post-webinars.md) to create a draft of the event, followed by the [Publish webinar API](../api-reference/v1.0/api/virtualeventwebinar-publish.md) to complete the creation and make it visible to its audience. - The webinar created via Microsoft Graph APIs will be a Teams webinar that’s visible and editable in the Teams client. - Just like in Teams, only the organizer can create, publish and cancel webinar events. That is why Create webinar API can only be called with delegated permissions on behalf of the organizer. -- Like in Teams, co-organizers can update webinars. Use the [Update webinar API](../api-reference/v1.0/resources/virtualeventwebinar-update.md) with delegated permissions on behalf of the co-organizer to do so. -- Subscribe to [change notifications](/concepts/changenotifications-for-virtualevent#subscribable-virtual-events.md) to get updates about any changes made to the webinar.  +- Like in Teams, co-organizers can update webinars. Use the [Update webinar API](../api-reference/v1.0/api/virtualeventwebinar-update.md) with delegated permissions on behalf of the co-organizer to do so. +- Subscribe to [change notifications](/concepts/changenotifications-for-virtualevent.md#subscribable-virtual-events) to get updates about any changes made to the webinar.  ### Data Sync - Subscribe to [change notifications](/concepts/changenotifications-for-virtualevent#subscribable-virtual-events.md) to get updates about any changes made to the webinar. -- To get attendance report data for a webinar, use [list attendance records](../api-reference/v1.0/resources/attendancerecord-list.md) or [get attendance record with a query option](../api-reference/v1.0/resources/meetingattendancereport-get#example-2-get-the-attendance-report-for-a-webinar-session-by-id.md). +- To get attendance report data for a webinar, use [list attendance records](../api-reference/v1.0/api/attendancerecord-list.md) or [get attendance record with a query option](../api-reference/v1.0/api/meetingattendancereport-get.md#example-2-get-the-attendance-report-for-a-webinar-session-by-id). - To get attendance information of a webinar attendee, map the `Id` property in [virtual event registration](../api-reference/v1.0/resources/virtualeventregistration.md) to the `registrationId` property in [attendance record](../api-reference/beta/resources/attendancerecord.md) (currently only available in Beta). - Get data for a specific webinar, list all the webinar in a tenant, list webinars where the user is an organizer or co-organizer, list webinars where the specified user is either the organizer or co-organizer. -- To get the Teams webinar registration portal URL for your webinar, use [Get webinar registration configuration](../api-reference/v1.0/resources/virtualeventwebinarregistrationconfiguration-get.md). +- To get the Teams webinar registration portal URL for your webinar, use [Get webinar registration configuration](../api-reference/v1.0/api/virtualeventwebinarregistrationconfiguration-get.md). ### Registration From 0483900974e09ed1a6a25c929963377e01910041 Mon Sep 17 00:00:00 2001 From: Annie Wang <107498920+awang119@users.noreply.github.com> Date: Mon, 11 Nov 2024 05:09:58 -0800 Subject: [PATCH 010/130] Finished data sync section of cloud-communications-virtual-events-webinar-usecases.md --- .../cloud-communications-virtual-events-webinar-usecases.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/concepts/cloud-communications-virtual-events-webinar-usecases.md b/concepts/cloud-communications-virtual-events-webinar-usecases.md index 511dc40029b..9746332de7c 100644 --- a/concepts/cloud-communications-virtual-events-webinar-usecases.md +++ b/concepts/cloud-communications-virtual-events-webinar-usecases.md @@ -54,8 +54,8 @@ The following table lists some solutions you can build by using the Teams client ### Data Sync - Subscribe to [change notifications](/concepts/changenotifications-for-virtualevent#subscribable-virtual-events.md) to get updates about any changes made to the webinar. - To get attendance report data for a webinar, use [list attendance records](../api-reference/v1.0/api/attendancerecord-list.md) or [get attendance record with a query option](../api-reference/v1.0/api/meetingattendancereport-get.md#example-2-get-the-attendance-report-for-a-webinar-session-by-id). -- To get attendance information of a webinar attendee, map the `Id` property in [virtual event registration](../api-reference/v1.0/resources/virtualeventregistration.md) to the `registrationId` property in [attendance record](../api-reference/beta/resources/attendancerecord.md) (currently only available in Beta). -- Get data for a specific webinar, list all the webinar in a tenant, list webinars where the user is an organizer or co-organizer, list webinars where the specified user is either the organizer or co-organizer. + - To get attendance information of a webinar attendee, after doing the above, map the `Id` property in [virtual event registration](../api-reference/v1.0/resources/virtualeventregistration.md) to the `registrationId` property in [attendance record](../api-reference/beta/resources/attendancerecord.md) (currently only available in Beta). +- Get data for [a specific webinar](../api-reference/v1.0/api/virtualeventwebinar-get.md), [list all the webinar in a tenant](../api-reference/v1.0/api/virtualeventsroot-list-webinars.md), list webinars where the [user is an organizer or co-organizer](../api-reference/v1.0/api/virtualeventwebinar-getbyuserrole.md), list webinars where the [specified user is either the organizer or co-organizer](../api-reference/v1.0/api/virtualeventwebinar-getbyuseridandrole.md). - To get the Teams webinar registration portal URL for your webinar, use [Get webinar registration configuration](../api-reference/v1.0/api/virtualeventwebinarregistrationconfiguration-get.md). ### Registration From 874d940345df16a8eb07254569b09d3ebd8f20c4 Mon Sep 17 00:00:00 2001 From: Annie Wang <107498920+awang119@users.noreply.github.com> Date: Mon, 11 Nov 2024 05:21:58 -0800 Subject: [PATCH 011/130] email and registration section of cloud-communications-virtual-events-webinar-usecases.md --- ...oud-communications-virtual-events-webinar-usecases.md | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/concepts/cloud-communications-virtual-events-webinar-usecases.md b/concepts/cloud-communications-virtual-events-webinar-usecases.md index 9746332de7c..f163dad5cdd 100644 --- a/concepts/cloud-communications-virtual-events-webinar-usecases.md +++ b/concepts/cloud-communications-virtual-events-webinar-usecases.md @@ -41,13 +41,9 @@ The following table lists some solutions you can build by using the Teams client >To build any Graph solutions, follow this guide on [how to register and give the right permissions to your application](/concepts/auth/auth-concepts.md). ### Create/update/cancel - - Use the [Create webinar API](../api-reference/v1.0/api/virtualeventsroot-post-webinars.md) to create a draft of the event, followed by the [Publish webinar API](../api-reference/v1.0/api/virtualeventwebinar-publish.md) to complete the creation and make it visible to its audience. - - The webinar created via Microsoft Graph APIs will be a Teams webinar that’s visible and editable in the Teams client. - - Just like in Teams, only the organizer can create, publish and cancel webinar events. That is why Create webinar API can only be called with delegated permissions on behalf of the organizer. - - Like in Teams, co-organizers can update webinars. Use the [Update webinar API](../api-reference/v1.0/api/virtualeventwebinar-update.md) with delegated permissions on behalf of the co-organizer to do so. - Subscribe to [change notifications](/concepts/changenotifications-for-virtualevent.md#subscribable-virtual-events) to get updates about any changes made to the webinar.  @@ -59,5 +55,10 @@ The following table lists some solutions you can build by using the Teams client - To get the Teams webinar registration portal URL for your webinar, use [Get webinar registration configuration](../api-reference/v1.0/api/virtualeventwebinarregistrationconfiguration-get.md). ### Registration +- Use [Create registration](../api-reference/v1.0/api/virtualeventwebinar-post-registrations.md) to programmatically register users to your webinar. Organizers, co-organizers, and presenters don’t need to register. Whether or not registrants have Microsoft Entra accounts affects the permissions you need to call the API. +- [Create registration questions](../api-reference/v1.0/api/virtualeventregistrationconfiguration-post-questions.md) (predefined or custom) attendees have to answer during registration. +- After the registrant registers for the webinar, use [List sessions](../api-reference/v1.0/api/virtualeventregistration-list-sessions.md) to get the unique `joinWebURL` for the webinar. ### Email communication +- To turn off email communications to attendees, it needs to be done when [creating the webinar]((../api-reference/v1.0/api/virtualeventsroot-post-webinars.md)). In the `settings` property, set `isAttendeeEmailNotificationEnabled` to `false`. However, email will still be sent to organizers, co-organizers, and presenters (internal and external). +- Can subscribe to [change notifications](/concepts/changenotifications-for-virtualevent.md#subscribable-virtual-events) to build your own customized email communication system. From 46b343feb588b78ffcdfc7d9e38990e977e727dc Mon Sep 17 00:00:00 2001 From: Annie Wang <107498920+awang119@users.noreply.github.com> Date: Mon, 11 Nov 2024 05:23:01 -0800 Subject: [PATCH 012/130] fixed link cloud-communications-virtual-events-webinar-usecases.md --- .../cloud-communications-virtual-events-webinar-usecases.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/concepts/cloud-communications-virtual-events-webinar-usecases.md b/concepts/cloud-communications-virtual-events-webinar-usecases.md index f163dad5cdd..ca5582bac95 100644 --- a/concepts/cloud-communications-virtual-events-webinar-usecases.md +++ b/concepts/cloud-communications-virtual-events-webinar-usecases.md @@ -60,5 +60,5 @@ The following table lists some solutions you can build by using the Teams client - After the registrant registers for the webinar, use [List sessions](../api-reference/v1.0/api/virtualeventregistration-list-sessions.md) to get the unique `joinWebURL` for the webinar. ### Email communication -- To turn off email communications to attendees, it needs to be done when [creating the webinar]((../api-reference/v1.0/api/virtualeventsroot-post-webinars.md)). In the `settings` property, set `isAttendeeEmailNotificationEnabled` to `false`. However, email will still be sent to organizers, co-organizers, and presenters (internal and external). +- To turn off email communications to attendees, it needs to be done when [creating the webinar](../api-reference/v1.0/api/virtualeventsroot-post-webinars.md). In the `settings` property, set `isAttendeeEmailNotificationEnabled` to `false`. However, email will still be sent to organizers, co-organizers, and presenters (internal and external). - Can subscribe to [change notifications](/concepts/changenotifications-for-virtualevent.md#subscribable-virtual-events) to build your own customized email communication system. From a8f56f5a59af01a72373f11ce68226bbb9c0b64d Mon Sep 17 00:00:00 2001 From: Annie Wang <107498920+awang119@users.noreply.github.com> Date: Mon, 11 Nov 2024 05:30:21 -0800 Subject: [PATCH 013/130] Update cloud-communications-virtual-events-townhall-usecases.md --- ...ations-virtual-events-townhall-usecases.md | 50 +++++++++++++++++++ 1 file changed, 50 insertions(+) diff --git a/concepts/cloud-communications-virtual-events-townhall-usecases.md b/concepts/cloud-communications-virtual-events-townhall-usecases.md index 8b137891791..8e07c8d40a2 100644 --- a/concepts/cloud-communications-virtual-events-townhall-usecases.md +++ b/concepts/cloud-communications-virtual-events-townhall-usecases.md @@ -1 +1,51 @@ +--- +title: "Virtual events town hall use cases" +description: "List of use cases that can be enabled using virtual events town hall APIs" +author: "awang119" +ms.localizationpriority: medium +ms.subservice: "cloud-communications" +--- +# Virtual events town hall API overview +Microsoft Graph virtual events town hall APIs allows you to get Teams town hall data and programmatically create, update and cancel a Teams town hall. +To make the best use of the Graph virtual events town hall APIs, it’s helpful to understand the personas for the users who access the Teams town hall experience: + +- **Organizers** are employees (in your organization) who manage the town hall. They are the authority on when town halls take place and who participates. They configure town hall details such as title, theme, attendee experience, and email rules. +- **Presenters** are employees (in your organization)or external participants who lead the town hall. +- **Attendees** are either employees (in your organization) or external users who join the town hall and are either invited via email or the link to the town hall event is shared with them.   +- **Teams tenant administrator** must authorize custom applications with appropriate permissions. + +The following resource types can be used to build your webinar solution +- [virtualEventTownhall](../api-reference/v1.0/resources/virtualeventtownhall.md) – Used to create, get, update, publish, and cancel a Teams town hall. +- [virtualEventPresenter](../api-reference/v1.0/resources/virtualeventpresenter.md) – Used to create, get, list, update, and delete a presenter for a Teams town hall. +- [virtualEventSession](../api-reference/v1.0/resources/virtualeventsession.md) – A town hall created via Microsoft Graph APIs has one session that inherits the properties of online meetings. + +## Solutions you can build +The following table lists some solutions you can build by using the Teams client and Microsoft Graph town hall APIs and webhooks. +| **Solutions** | **Description** | +| ------------- | ------------- | +| [Create/update/cancel](#createupdatecancel) | Programmatically create, update, and cancel Teams town hall.| +| [Data Sync](#data-sync) | Pull Teams town hall data in a custom application. | +| [Email communication](#email-communication)| Use your own email infrastructure to send out town hall-related notification emails. | + +> [!NOTE] +>To build any Graph solutions, follow this guide on [how to register and give the right permissions to your application](/concepts/auth/auth-concepts.md). + +### Create/update/cancel +- Use the [Create webinar API](../api-reference/v1.0/api/virtualeventsroot-post-webinars.md) to create a draft of the event, followed by the [Publish webinar API](../api-reference/v1.0/api/virtualeventwebinar-publish.md) to complete the creation and make it visible to its audience. + - The webinar created via Microsoft Graph APIs will be a Teams webinar that’s visible and editable in the Teams client. + - Just like in Teams, only the organizer can create, publish and cancel webinar events. That is why Create webinar API can only be called with delegated permissions on behalf of the organizer. +- Like in Teams, co-organizers can update webinars. Use the [Update webinar API](../api-reference/v1.0/api/virtualeventwebinar-update.md) with delegated permissions on behalf of the co-organizer to do so. +- Subscribe to [change notifications](/concepts/changenotifications-for-virtualevent.md#subscribable-virtual-events) to get updates about any changes made to the webinar.  + +### Data Sync +- Subscribe to [change notifications](/concepts/changenotifications-for-virtualevent#subscribable-virtual-events.md) to get updates about any changes made to the webinar. +- To get attendance report data for a webinar, use [list attendance records](../api-reference/v1.0/api/attendancerecord-list.md) or [get attendance record with a query option](../api-reference/v1.0/api/meetingattendancereport-get.md#example-2-get-the-attendance-report-for-a-webinar-session-by-id). + - To get attendance information of a webinar attendee, after doing the above, map the `Id` property in [virtual event registration](../api-reference/v1.0/resources/virtualeventregistration.md) to the `registrationId` property in [attendance record](../api-reference/beta/resources/attendancerecord.md) (currently only available in Beta). +- Get data for [a specific webinar](../api-reference/v1.0/api/virtualeventwebinar-get.md), [list all the webinar in a tenant](../api-reference/v1.0/api/virtualeventsroot-list-webinars.md), list webinars where the [user is an organizer or co-organizer](../api-reference/v1.0/api/virtualeventwebinar-getbyuserrole.md), list webinars where the [specified user is either the organizer or co-organizer](../api-reference/v1.0/api/virtualeventwebinar-getbyuseridandrole.md). +- To get the Teams webinar registration portal URL for your webinar, use [Get webinar registration configuration](../api-reference/v1.0/api/virtualeventwebinarregistrationconfiguration-get.md). + + +### Email communication +- To turn off email communications to attendees, it needs to be done when [creating the town hall](../api-reference/v1.0/api/virtualeventsroot-post-webinars.md). In the `settings` property, set `isAttendeeEmailNotificationEnabled` to `false`. However, email will still be sent to organizers, co-organizers, and presenters (internal and external). +- Can subscribe to [change notifications](/concepts/changenotifications-for-virtualevent.md#subscribable-virtual-events) to build your own customized email communication system. From 54c0d1e18bcab1fa434a2834c1df4f6097602c42 Mon Sep 17 00:00:00 2001 From: Annie Wang <107498920+awang119@users.noreply.github.com> Date: Mon, 11 Nov 2024 05:30:52 -0800 Subject: [PATCH 014/130] Update cloud-communications-virtual-events-webinar-usecases.md --- .../cloud-communications-virtual-events-webinar-usecases.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/concepts/cloud-communications-virtual-events-webinar-usecases.md b/concepts/cloud-communications-virtual-events-webinar-usecases.md index ca5582bac95..3d2cf697e44 100644 --- a/concepts/cloud-communications-virtual-events-webinar-usecases.md +++ b/concepts/cloud-communications-virtual-events-webinar-usecases.md @@ -6,7 +6,7 @@ ms.localizationpriority: medium ms.subservice: "cloud-communications" --- # Virtual events webinar API overview -Microsoft Graph virtual events webinar APIs allows you to get Teams webinar data and programmatically create, update and delete a Teams webinar. +Microsoft Graph virtual events webinar APIs allows you to get Teams webinar data and programmatically create, update and cancel a Teams webinar. To make the best use of the Graph virtual events webinar APIs, it’s helpful to understand the personas for the users who access the Teams webinar experience: From 22d16693edda1e92a2d59a20b9e0122418ddf083 Mon Sep 17 00:00:00 2001 From: Annie Wang <107498920+awang119@users.noreply.github.com> Date: Mon, 11 Nov 2024 05:42:11 -0800 Subject: [PATCH 015/130] Update cloud-communications-virtual-events-townhall-usecases.md --- ...ations-virtual-events-townhall-usecases.md | 22 +++++++------------ 1 file changed, 8 insertions(+), 14 deletions(-) diff --git a/concepts/cloud-communications-virtual-events-townhall-usecases.md b/concepts/cloud-communications-virtual-events-townhall-usecases.md index 8e07c8d40a2..9d0852dc3a8 100644 --- a/concepts/cloud-communications-virtual-events-townhall-usecases.md +++ b/concepts/cloud-communications-virtual-events-townhall-usecases.md @@ -15,7 +15,7 @@ To make the best use of the Graph virtual events town hall APIs, it’s helpful - **Attendees** are either employees (in your organization) or external users who join the town hall and are either invited via email or the link to the town hall event is shared with them.   - **Teams tenant administrator** must authorize custom applications with appropriate permissions. -The following resource types can be used to build your webinar solution +The following resource types can be used to build your town hall solution - [virtualEventTownhall](../api-reference/v1.0/resources/virtualeventtownhall.md) – Used to create, get, update, publish, and cancel a Teams town hall. - [virtualEventPresenter](../api-reference/v1.0/resources/virtualeventpresenter.md) – Used to create, get, list, update, and delete a presenter for a Teams town hall. - [virtualEventSession](../api-reference/v1.0/resources/virtualeventsession.md) – A town hall created via Microsoft Graph APIs has one session that inherits the properties of online meetings. @@ -32,20 +32,14 @@ The following table lists some solutions you can build by using the Teams client >To build any Graph solutions, follow this guide on [how to register and give the right permissions to your application](/concepts/auth/auth-concepts.md). ### Create/update/cancel -- Use the [Create webinar API](../api-reference/v1.0/api/virtualeventsroot-post-webinars.md) to create a draft of the event, followed by the [Publish webinar API](../api-reference/v1.0/api/virtualeventwebinar-publish.md) to complete the creation and make it visible to its audience. - - The webinar created via Microsoft Graph APIs will be a Teams webinar that’s visible and editable in the Teams client. - - Just like in Teams, only the organizer can create, publish and cancel webinar events. That is why Create webinar API can only be called with delegated permissions on behalf of the organizer. -- Like in Teams, co-organizers can update webinars. Use the [Update webinar API](../api-reference/v1.0/api/virtualeventwebinar-update.md) with delegated permissions on behalf of the co-organizer to do so. -- Subscribe to [change notifications](/concepts/changenotifications-for-virtualevent.md#subscribable-virtual-events) to get updates about any changes made to the webinar.  +- Use the [Create townhall API](../api-reference/v1.0/api/virtualeventsroot-post-townhalls.md) to create a draft of the event, followed by the [Publish townhall API](../api-reference/v1.0/api/virtualeventtownhall-publish.md) to complete the creation and make it visible to its audience. + - The town hall created via Microsoft Graph APIs will be a Teams town hall that’s visible and editable in the Teams client. + - Just like in Teams, only the organizer can create, publish and cancel town hall events. That is why Create townhall API can only be called with delegated permissions on behalf of the organizer. +- Like in Teams, co-organizers can update town halls. Use the [Update townhall API](../api-reference/v1.0/api/virtualeventtownhall-update.md) with delegated permissions on behalf of the co-organizer to do so. ### Data Sync -- Subscribe to [change notifications](/concepts/changenotifications-for-virtualevent#subscribable-virtual-events.md) to get updates about any changes made to the webinar. -- To get attendance report data for a webinar, use [list attendance records](../api-reference/v1.0/api/attendancerecord-list.md) or [get attendance record with a query option](../api-reference/v1.0/api/meetingattendancereport-get.md#example-2-get-the-attendance-report-for-a-webinar-session-by-id). - - To get attendance information of a webinar attendee, after doing the above, map the `Id` property in [virtual event registration](../api-reference/v1.0/resources/virtualeventregistration.md) to the `registrationId` property in [attendance record](../api-reference/beta/resources/attendancerecord.md) (currently only available in Beta). -- Get data for [a specific webinar](../api-reference/v1.0/api/virtualeventwebinar-get.md), [list all the webinar in a tenant](../api-reference/v1.0/api/virtualeventsroot-list-webinars.md), list webinars where the [user is an organizer or co-organizer](../api-reference/v1.0/api/virtualeventwebinar-getbyuserrole.md), list webinars where the [specified user is either the organizer or co-organizer](../api-reference/v1.0/api/virtualeventwebinar-getbyuseridandrole.md). -- To get the Teams webinar registration portal URL for your webinar, use [Get webinar registration configuration](../api-reference/v1.0/api/virtualeventwebinarregistrationconfiguration-get.md). - +- Use the [Get townhall API](../api-reference/v1.0/api/virtualeventtownhall-get.md) to pull data regarding a specific town hall. such as who is invited, who created the town hall, and who are the co-organizers. +- [List all the town hall in a tenant](../api-reference/beta/api/virtualeventsroot-list-townhalls.md), list town hall where the [user is an organizer or co-organizer](../api-reference/beta/api/virtualeventtownhall-getbyuserrole.md), and list town halls where the [specified user is either the organizer or co-organizer](../api-reference/beta/api/virtualeventtownhall-getbyuseridandrole.md) are only available in Beta currently. ### Email communication -- To turn off email communications to attendees, it needs to be done when [creating the town hall](../api-reference/v1.0/api/virtualeventsroot-post-webinars.md). In the `settings` property, set `isAttendeeEmailNotificationEnabled` to `false`. However, email will still be sent to organizers, co-organizers, and presenters (internal and external). -- Can subscribe to [change notifications](/concepts/changenotifications-for-virtualevent.md#subscribable-virtual-events) to build your own customized email communication system. +- To turn off email communications to attendees, it needs to be done when [creating the town hall](../api-reference/v1.0/api/virtualeventsroot-post-townhalls.md). In the `settings` property, set `isAttendeeEmailNotificationEnabled` to `false`. However, email will still be sent to organizers, co-organizers, and presenters (internal and external). From 76c96c6fee1e6f2da2cc66ca8ca98590290c45cd Mon Sep 17 00:00:00 2001 From: Annie Wang <107498920+awang119@users.noreply.github.com> Date: Mon, 11 Nov 2024 10:37:05 -0800 Subject: [PATCH 016/130] Update cloud-communications-virtual-events-overview.md --- concepts/cloud-communications-virtual-events-overview.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/concepts/cloud-communications-virtual-events-overview.md b/concepts/cloud-communications-virtual-events-overview.md index e56f11ca697..a9f5a852dfd 100644 --- a/concepts/cloud-communications-virtual-events-overview.md +++ b/concepts/cloud-communications-virtual-events-overview.md @@ -14,7 +14,7 @@ Use the following table to choose the right meeting type for your use case. | **Teams Meeting type** |**Microsoft Graph** | **Use cases** | | ------------- | ------------- | ------------- | | [Online meeting](https://support.microsoft.com/en-us/office/meetings-in-microsoft-teams-e0b0ae21-53ee-4462-a50d-ca9b9e217b67) |[onlineMeeting](../api-reference/v1.0/resources/onlinemeeting.md)
[attendanceReport](../api-reference/v1.0/resources/meetingattendancereport.md)
[attendanceRecord](../api-reference/v1.0/resources/attendancerecord.md)
[online meeting webhooks](/concepts/changenotifications-for-onlinemeeting.md) | | -| [Webinar](https://support.microsoft.com/en-us/office/get-started-with-microsoft-teams-webinars-42f3f874-22dc-4289-b53f-bbc1a69013e3) |[virtualEventWebinar](../api-reference/v1.0/resources/virtualeventwebinar.md)
[virtualEventRegistration](../api-reference/v1.0/resources/virtualeventregistration.md)
[virtualEventRegistrationConfiguration](../api-reference/v1.0/resources/virtualeventwebinarregistrationconfiguration.md)
[virtualEventRegistrationQuestion](../api-reference/v1.0/resources/virtualeventregistrationquestionbase.md)
[meetingAttendanceReport](../api-reference/v1.0/resources/meetingattendancereport.md)
[attendanceRecord](../api-reference/v1.0/resources/attendancerecord.md)
[virtualEventSession](../api-reference/v1.0/resources/virtualeventsession.md)
[virtualEventPresenter](../api-reference/v1.0/resources/virtualeventpresenter.md)
[virtual event webhooks](/concepts/changenotifications-for-virtualevent.md)| | +| [Webinar](https://support.microsoft.com/en-us/office/get-started-with-microsoft-teams-webinars-42f3f874-22dc-4289-b53f-bbc1a69013e3) |[virtualEventWebinar](../api-reference/v1.0/resources/virtualeventwebinar.md)
[virtualEventRegistration](../api-reference/v1.0/resources/virtualeventregistration.md)
[virtualEventWebinarRegistrationConfiguration](../api-reference/v1.0/resources/virtualeventwebinarregistrationconfiguration.md)
[virtualEventRegistrationQuestion](../api-reference/v1.0/resources/virtualeventregistrationquestionbase.md)
[meetingAttendanceReport](../api-reference/v1.0/resources/meetingattendancereport.md)
[attendanceRecord](../api-reference/v1.0/resources/attendancerecord.md)
[virtualEventSession](../api-reference/v1.0/resources/virtualeventsession.md)
[virtualEventPresenter](../api-reference/v1.0/resources/virtualeventpresenter.md)
[virtual event webhooks](/concepts/changenotifications-for-virtualevent.md)| | | [Town hall](https://support.microsoft.com/en-us/office/get-started-with-town-hall-in-microsoft-teams-33baf0c6-0283-4c15-9617-3013e8d4804f) | [virtualEventTownhall](../api-reference/v1.0/resources/virtualeventtownhall.md)
[virtualEventSession](../api-reference/v1.0/resources/virtualeventsession.md)
[virtualEventPresenter](../api-reference/v1.0/resources/virtualeventpresenter.md) | From 514c231da84d8e7675d1c24f24fea6eebaf96a7e Mon Sep 17 00:00:00 2001 From: Annie Wang <107498920+awang119@users.noreply.github.com> Date: Mon, 11 Nov 2024 11:06:05 -0800 Subject: [PATCH 017/130] To increase acrolinx score for cloud-communications-virtual-events-overview.md --- ...cloud-communications-virtual-events-overview.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/concepts/cloud-communications-virtual-events-overview.md b/concepts/cloud-communications-virtual-events-overview.md index a9f5a852dfd..da883c9715e 100644 --- a/concepts/cloud-communications-virtual-events-overview.md +++ b/concepts/cloud-communications-virtual-events-overview.md @@ -1,6 +1,6 @@ --- title: "Choose the right meeting type" -description: "Consider when to use online meetings API, webinar API or town hall API for Teams meetings." +description: "Consider when to use online meetings API, webinar API, or town hall API for Teams meetings." author: "awang119" ms.localizationpriority: medium ms.subservice: "cloud-communications" @@ -8,21 +8,21 @@ ms.subservice: "cloud-communications" # Choose the right meeting type -Microsoft Teams and Microsoft Graph supports multiple types of scheduled real-time voice and video experiences. These range from ad hoc meetings suitable for a small number of participants to large structured virtual events like webinars and town halls with thousands of attendees. +Microsoft Teams and Microsoft Graph supports multiple types of scheduled real-time voice and video experiences ranging from ad hoc meetings suitable for a few participants to large structured virtual events like webinars and town halls with thousands of attendees. Use the following table to choose the right meeting type for your use case. | **Teams Meeting type** |**Microsoft Graph** | **Use cases** | | ------------- | ------------- | ------------- | | [Online meeting](https://support.microsoft.com/en-us/office/meetings-in-microsoft-teams-e0b0ae21-53ee-4462-a50d-ca9b9e217b67) |[onlineMeeting](../api-reference/v1.0/resources/onlinemeeting.md)
[attendanceReport](../api-reference/v1.0/resources/meetingattendancereport.md)
[attendanceRecord](../api-reference/v1.0/resources/attendancerecord.md)
[online meeting webhooks](/concepts/changenotifications-for-onlinemeeting.md) | | | [Webinar](https://support.microsoft.com/en-us/office/get-started-with-microsoft-teams-webinars-42f3f874-22dc-4289-b53f-bbc1a69013e3) |[virtualEventWebinar](../api-reference/v1.0/resources/virtualeventwebinar.md)
[virtualEventRegistration](../api-reference/v1.0/resources/virtualeventregistration.md)
[virtualEventWebinarRegistrationConfiguration](../api-reference/v1.0/resources/virtualeventwebinarregistrationconfiguration.md)
[virtualEventRegistrationQuestion](../api-reference/v1.0/resources/virtualeventregistrationquestionbase.md)
[meetingAttendanceReport](../api-reference/v1.0/resources/meetingattendancereport.md)
[attendanceRecord](../api-reference/v1.0/resources/attendancerecord.md)
[virtualEventSession](../api-reference/v1.0/resources/virtualeventsession.md)
[virtualEventPresenter](../api-reference/v1.0/resources/virtualeventpresenter.md)
[virtual event webhooks](/concepts/changenotifications-for-virtualevent.md)| | -| [Town hall](https://support.microsoft.com/en-us/office/get-started-with-town-hall-in-microsoft-teams-33baf0c6-0283-4c15-9617-3013e8d4804f) | [virtualEventTownhall](../api-reference/v1.0/resources/virtualeventtownhall.md)
[virtualEventSession](../api-reference/v1.0/resources/virtualeventsession.md)
[virtualEventPresenter](../api-reference/v1.0/resources/virtualeventpresenter.md) |