Sdílet prostřednictvím

Rozšíření plánování

  • Článek

V tomto článku se dozvíte o dostupných možnostech naplánování virtuální schůzky pomocí Microsoft Teams a Microsoft Graphu. Nejprve se dozvíte, jak replikovat stávající prostředí ve virtuálních událostech Microsoft Teams. Za druhé se naučíte používat vlastní plánovací systém a zároveň poskytovat uživatelům stejné virtuální prostředí pro schůzky.

Požadavky

Čtenář tohoto článku by měl znát:

Plánovací systém Microsoft 365

Virtuální události v Microsoft Teams používají k jejich správě rozhraní Microsoft Booking API. V aplikaci Teams se zobrazí rezervace schůzek pro pracovníky rezervace a na stránce Rezervace se zákazníkům umožní vybrat si vhodný čas pro konzultaci. Postupujte podle dalších kroků a vytvořte vlastní uživatelské rozhraní pro plánování nebo integrujte plánovací systém Microsoft 365 do svého řešení.

  1. Pomocí následujícího požadavku HTTP vypíšete seznam dostupných firem pro rezervace a výběr firmy pro virtuální schůzky prostřednictvím rozhraní MICROSOFT Graph Booking business API.
GET https://graph.microsoft.com/v1.0/solutions/bookingBusinesses
Permissions: Bookings.Read.All (delegated)
Response: response.body.value[0].displayName; // ”Contoso lunch delivery”
	        response.body.value[0].id; // "Contosolunchdelivery@contoso.onmicrosoft.com"
  1. Uveďte seznam dostupných služeb booking a vyberte službu pro virtuální schůzky prostřednictvím rozhraní API služeb Microsoft Graph Booking.
GET https://graph.microsoft.com/v1.0/solutions/bookingBusinesses/ Contosolunchdelivery@contoso.onmicrosoft.com/services
Permissions: Bookings.Read.All (delegated)
Response: response.body.value[0].displayName; // ” Initial service”
	    response.body.value[0].id; // " f9b9121f-aed7-4c8c-bb3a-a1796a0b0b2d"
  1. [Volitelné] Pomocí rozhraní Microsoft Graph Booking staff member staff member vytvořte seznam dostupných pedagogů rezervace a vyberte pedagogy pro virtuální schůzky. Pokud není vybrán žádný pedagog, je vytvořená událost označena jako Nepřiřazeno.
GET https://graph.microsoft.com/v1.0/solutions/bookingBusinesses/ Contosolunchdelivery@contoso.onmicrosoft.com/staffMembers
Permissions: Bookings.Read.All (delegated)
Response: response.body.value[0].displayName; // ”Dana Swope”
	    response.body.value[0].id; // "8ee1c803-a1fa-406d-8259-7ab53233f148"
  1. [Volitelné] Prostřednictvím rozhraní MICROSOFT Graph Booking customer API vyberte nebo vytvořte zákazníka Booking pro virtuální schůzku. Pokud neexistují žádní zákazníci, nebudou se odesílat žádná připomenutí.
GET https://graph.microsoft.com/v1.0/solutions/bookingBusinesses/ Contosolunchdelivery@contoso.onmicrosoft.com/customers
Permissions: Bookings.Read.All (delegated)
Response: response.body.value[0].displayName; // ”Adele Vance”
	    response.body.value[0].id; // "80b5ddda-1e3b-4c9d-abe2-d606cc075e2e"
  1. Vytváření událostí rezervace pro vybrané firmy, služby a volitelně pedagogy a hosty prostřednictvím rozhraní MICROSOFT Graph Booking API V následujícím příkladu vytvoříme online schůzku, která je přidružená k rezervaci. Kromě toho můžete zadat poznámky a připomenutí.
POST https://graph.microsoft.com/v1.0/solutions/bookingBusinesses/ Contosolunchdelivery@contoso.onmicrosoft.com/appointments
Body: {
    "endDateTime": {
        "@odata.type": "#microsoft.graph.dateTimeTimeZone",
        "dateTime": "2023-05-20T10:00:00.0000000+00:00",
        "timeZone": "UTC"
    },
    "isLocationOnline": true,
    "staffMemberIds": [
       {
          "8ee1c803-a1fa-406d-8259-7ab53233f148"
       }
    ],
    "serviceId": "f9b9121f-aed7-4c8c-bb3a-a1796a0b0b2d",
    "startDateTime": {
        "dateTime": "2023-05-20T09:00:00.0000000+00:00",
        "timeZone": "UTC"
    },
    "customers": [
        {
            "customerId": "80b5ddda-1e3b-4c9d-abe2-d606cc075e2e"
        }
    ]
}
Permissions: BookingsAppointment.ReadWrite.All (delegated)
Response: response.body.value.id; // "AAMkADc7zF4J0AAA8v_KnAAA="
          response.body.value.serviceId; // "f9b9121f-aed7-4c8c-bb3a-a1796a0b0b2d"
          response.body.value.joinWebUrl; // "https://teams.microsoft.com/l/meetup-join/..."
          response.body.value.anonymousJoinWebUrl; // "https://visit.teams.microsoft.com/webrtc-svc/..."
          response.body.value.staffMemberIds; // "8ee1c803-a1fa-406d-8259-7ab53233f148"
          response.body.value.customers[0].name; // "Adele Vance"

V odpovědi uvidíte, že se vytvořila nová událost Booking. Virtuální událost se také zobrazuje v aplikaci Microsoft Booking a v aplikaci Microsoft Teams Virtual appointment.

Poznámka

Jediným způsobem, jak získat informace o zákazníci, je použít rozhraní GET Microsoft Graph Booking appointment API.

Používání vlastního plánovacího systému

Pokud máte existující systém plánování a chcete ho rozšířit o virtuální prostředí schůzek poskytované microsoft teams, postupujte následovně:

  1. Vytvořte online schůzku pro virtuální událost prostřednictvím rozhraní MICROSOFT Graph Online Meeting API.

Poznámka

Tato operace nevytvoří událost kalendáře v Microsoft Booking, Outlooku nebo Microsoft Teams. Pokud chcete vytvořit událost kalendáře, použijte rozhraní MICROSOFT Graph Calendar API.

POST https://graph.microsoft.com/v1.0/ me/onlineMeetings
Body: {
  "startDateTime":"2023-05-20T09:00:00.0000000+00:00",
  "endDateTime":"2023-05-20T10:00:00.0000000+00:00",
  "subject":"Virtual appointment in Microsoft Teams"
}
Permissions: OnlineMeetings.ReadWrite (delegated)
Response: response.body.value.id; // "MSpkYzE3NjctYmZiMi04ZdFpHRTNaR1F6WGhyZWFkLnYy"
          response.body.value.joinWebUrl; // "https://teams.microsoft.com/l/meetup-join/..."
  1. Vytvoření prostředí virtuální události pro prostředek onlinemeeting vytvořený v předchozím kroku prostřednictvím
GET https://graph.microsoft.com/v1.0/ me/onlineMeetings/ MSpkYzE3NjctYmZiMi04ZdFpHRTNaR1F6WGhyZWFkLnYy/getVirtualAppointmentJoinWebUrl
Permissions: OnlineMeetings.ReadWrite (delegated)
Response: response.body.value; //"https://visit.teams.microsoft.com/webrtc-svc/..."

Vygenerovanou adresu URL můžete uložit do svého plánovacího systému nebo můžete vytvořit vyhrazené úložiště páru klíč-hodnota, které by propojilo jedinečné ID události kalendáře ve vašem plánovacím systému s adresou URL pro prostředí virtuálních událostí v Microsoft Teams.

Další kroky