{"id":21305,"date":"2024-05-17T08:30:09","date_gmt":"2024-05-17T15:30:09","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/?p=21305"},"modified":"2024-05-17T07:19:25","modified_gmt":"2024-05-17T14:19:25","slug":"new-capabilities-for-microsoft-graph-apis-for-teams-meetings-with-external-attendees","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/new-capabilities-for-microsoft-graph-apis-for-teams-meetings-with-external-attendees\/","title":{"rendered":"New capabilities for Microsoft Graph APIs for Teams meetings with external attendees"},"content":{"rendered":"<h2>Microsoft Graph SMS notification and reminder APIs are now generally available<\/h2>\n<p>Developers use Microsoft Teams to build solutions for cross-industry, business-to-consumer (B2C) online meeting workflows in use cases such as clinician-led consultations (healthcare), banking and lending (financial services), and apparel purchases (retail). The new Microsoft Graph SMS <a href=\"https:\/\/learn.microsoft.com\/en-us\/graph\/api\/virtualappointment-sendvirtualappointmentsms?view=graph-rest-1.0&amp;tabs=http\">notification<\/a> and <a href=\"https:\/\/learn.microsoft.com\/en-us\/graph\/api\/virtualappointment-sendvirtualappointmentremindersms?view=graph-rest-1.0&amp;tabs=http\">reminder<\/a> APIs, now generally available, reduce no shows and facilitate a seamless customer experience. External attendees receive SMS text notifications and reminders with an embedded join link that supports mobile and web browsers. These new APIs give developers access to the hosted Microsoft SMS experience within Teams, with easy configuration that enables quick speed to market.<\/p>\n<h2>Microsoft Graph SMS notification API<\/h2>\n<p>The Microsoft Graph SMS notification API allows developers to send an SMS notification to external attendees when a Teams meeting is confirmed, rescheduled, or canceled. Developers send the <strong>messageType<\/strong>, <strong>phoneNumber<\/strong>, and <strong>timeZone<\/strong> properties in the payload to configure the SMS notifications. Notifications can be sent to US, UK, and Canadian phone numbers. Note that although the API is not part of Teams Premium, using the SMS notifications requires the appointment organizer to be licensed with Teams Premium.<\/p>\n<h3>Request example<\/h3>\n<pre class=\"prettyprint language-default\"><code class=\"language-default\">POST https:\/\/graph.microsoft.com\/beta\/me\/onlineMeetings\/MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZi\/sendVirtualAppointmentSms<\/code><\/pre>\n<pre class=\"prettyprint language-json\"><code class=\"language-json\"> \r\n    \"attendees\": [ \r\n        {\r\n            \"phoneNumber\":  \"+13129224122\",\r\n            \"timeZone\": \"Pacific Standard Time\"\r\n        },\r\n        {\r\n            \"phoneNumber\":  \"+1242421412\",\r\n            \"timeZone\": \"Eastern Standard Time\"\r\n        }\r\n    ], \r\n    \"messageType\": \"confirmation\"\r\n}<\/code><\/pre>\n<h3 class=\"prettyprint language-default\">Response example<\/h3>\n<pre class=\"prettyprint language-default\"><code class=\"language-default\">HTTP\/1.1 202 Accepted\r\n<\/code><\/pre>\n<h2>Microsoft Graph reminder notification API<\/h2>\n<p>The Microsoft Graph SMS reminder API allows developers to send an SMS reminder to external attendees 15 minutes ahead of the scheduled meeting. Developers send the \u201cremind before time in minutes type\u201d, \u201cattendee phone number\u201d, and \u201ctimezone\u201d properties in the payload to configure the SMS reminders. Reminders can be sent to US, UK, and Canadian phone numbers. Note, while the API is not part of Teams Premium, for the SMS notifications to be utilized, it requires the appointment organizer to be licensed with Teams Premium.<\/p>\n<h3>Request example<\/h3>\n<pre class=\"prettyprint language-default\"><code class=\"language-default\">POST https:\/\/graph.microsoft.com\/beta\/me\/onlineMeetings\/MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZi\/sendVirtualAppointmentReminderSms<\/code><\/pre>\n<pre class=\"prettyprint language-json\"><code class=\"language-json\">{ \r\n    \"attendees\": [ \r\n        {\r\n            \"phoneNumber\":  \"+13129224122\",\r\n            \"timeZone\": \"Pacific Standard Time\"\r\n        },\r\n        {\r\n            \"phoneNumber\":  \"+1242421412\",\r\n            \"timeZone\": \"Eastern Standard Time\"\r\n        }\r\n    ], \r\n    \"messageType\": \"confirmation\"\r\n}<\/code><\/pre>\n<h3>Response example<\/h3>\n<pre><code class=\"language-default\">HTTP\/1.1 202 Accepted<\/code><\/pre>\n<h2>Example: SMS notification and reminder for external attendees<\/h2>\n<p><img decoding=\"async\" width=\"403\" height=\"840\" class=\"wp-image-21306\" src=\"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2024\/05\/a-screenshot-of-a-phone-description-automatically.png\" alt=\"A screenshot of a phone Description automatically generated\" srcset=\"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2024\/05\/a-screenshot-of-a-phone-description-automatically.png 403w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2024\/05\/a-screenshot-of-a-phone-description-automatically-144x300.png 144w\" sizes=\"(max-width: 403px) 100vw, 403px\" \/><\/p>\n<h3>Partner highlight<\/h3>\n<h4>LinkedIn Recruiter integration with Microsoft Teams uses Microsoft Graph APIs for external attendees<\/h4>\n<p>Recruiters can now schedule meetings on Microsoft Teams directly from LinkedIn Recruiter, using a new partner integration with Microsoft Graph APIs for Teams meetings. Recruiters can save time, deliver a better candidate experience, and host secure candidate engagements from anywhere. Key features include:<\/p>\n<ul>\n<li>Automatically embed Teams video conferencing and scheduling links into\u00a0LinkedIn Recruiter InMails.<\/li>\n<li>Allow candidates to choose a time that works best for their schedule based on the recruiter\u2019s availability.<\/li>\n<li>Give candidates a preview of their scheduled meeting and the option to reschedule.<\/li>\n<li>Candidates can join from anywhere with mobile browser join and waiting room support.<\/li>\n<\/ul>\n<p>Linkedin Recruiter uses the Microsoft Graph virtual appointment API to create a virtual appointment with mobile browser join and lobby room for candidates that join as external attendees.<\/p>\n<h5>Request example<\/h5>\n<pre class=\"prettyprint language-default\"><code class=\"language-default\">GET https:\/\/graph.microsoft.com\/v1.0\/me\/onlineMeetings\/MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZi\/getVirtualAppointmentJoinWebUrl<\/code><\/pre>\n<h5>Response example<\/h5>\n<pre class=\"prettyprint language-default\"><code class=\"language-default\">HTTP\/1.1 200 OK\r\n\r\n{\r\n\r\n\t\"value\": \"https:\/\/teams.microsoft.com\/meet\/296734500666?p=T5CO63RZrHdvN \"\r\n\r\n}<\/code><\/pre>\n<h2>Learn more<\/h2>\n<p>The Microsoft Graph virtual appointment API can be paired with the new Microsoft Graph SMS Notification and Reminder APIs to create an end-to-end solution for your business to consumer online meeting workflows. These APIs feature minimal developer configuration and offer an embeddable solution that is quick to deploy in your application.<\/p>\n<p>Find out more and get started today with our Microsoft Graph APIs for Teams Meetings with external attendees:<\/p>\n<ul>\n<li><a href=\"https:\/\/learn.microsoft.com\/en-us\/graph\/api\/virtualappointment-getvirtualappointmentjoinweburl?view=graph-rest-1.0&amp;tabs=http\">Create a virtual appointment<\/a><\/li>\n<li><a href=\"https:\/\/learn.microsoft.com\/en-us\/graph\/api\/virtualappointment-sendvirtualappointmentsms?view=graph-rest-1.0&amp;tabs=http\">Send a SMS notification<\/a><\/li>\n<li><a href=\"https:\/\/learn.microsoft.com\/en-us\/graph\/api\/virtualappointment-getvirtualappointmentjoinweburl?view=graph-rest-1.0&amp;tabs=http\">Send a SMS reminder<\/a><\/li>\n<li><a href=\"https:\/\/business.linkedin.com\/talent-solutions\/linkedin-hiring-integrations\/communicate-connect-integrations#video-connect\">LinkedIn Recruiter<\/a><\/li>\n<\/ul>\n<p>&nbsp;<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Learn more about Microsoft Graph SMS notification and reminder APIs, now generally available.<\/p>\n","protected":false},"author":159290,"featured_media":21311,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[3],"tags":[],"class_list":["post-21305","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-microsoft-graph"],"acf":[],"blog_post_summary":"<p>Learn more about Microsoft Graph SMS notification and reminder APIs, now generally available.<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/21305","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/users\/159290"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/comments?post=21305"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/21305\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media\/21311"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media?parent=21305"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/categories?post=21305"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/tags?post=21305"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}