Freigeben über

Erweitern der Planung

  • Artikel

In diesem Artikel erfahren Sie mehr über die verfügbaren Optionen zum Planen eines virtuellen Termins mit Microsoft Teams und Microsoft Graph. Zunächst erfahren Sie, wie Sie die vorhandene Umgebung in virtuellen Microsoft Teams-Terminen replizieren können. Zweitens erfahren Sie, wie Sie Ihr eigenes Terminplanungssystem verwenden und zugleich die gleiche virtuelle Terminumgebung für die Verbraucher bereitstellen.

Voraussetzungen

Für das Lesen dieses Artikels wird erwartet, dass man mit Folgendem vertraut ist:

Microsoft 365-Zeitplanungssystem

Virtuelle Microsoft Teams-Termine verwenden Microsoft Booking-APIs zur Verwaltung. In der Teams-Anwendung sehen Sie die Terminbuchung für buchungsberechtigte Mitarbeiter, und es wird die Seite Buchung für Kunden zur Verfügung gestellt, auf der sie geeignete Zeiten für die Beratung auswählen können. Führen Sie die nächsten Schritte aus, um eine eigene Benutzeroberfläche für die Planung zu erstellen oder das Microsoft 365-Planungssystem in Ihre Lösung zu integrieren.

  1. Verwenden Sie die folgende HTTP-Anforderung, um verfügbare Buchungsunternehmen aufzulisten und ein Unternehmen für virtuelle Termine über die Microsoft Graph-Buchungsgeschäfts-API auszuwählen.
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. Listen Sie die verfügbaren Buchungsdienste auf, und wählen Sie einen Dienst für virtuelle Termine über die Microsoft Graph Booking Services-API aus.
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. [Optional] Listen Sie die verfügbaren Mitglieder des Buchungsteams auf, und wählen Sie Teammitglieder für virtuelle Termine über die Microsoft Graph Booking-Teammitglieds-API aus. Wenn kein Mitarbeiter ausgewählt ist, wird der erstellte Termin als „Nicht zugewiesen“ bezeichnet.
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. [Optional] Wählen Sie einen Booking-Kunden aus, oder erstellen Sie einen für den virtuellen Termin über die Microsoft Graph Booking-Kunden-API. Wenn keine Kunden vorhanden sind, werden keine Erinnerungen gesendet.
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. Erstellen Sie Termine in Booking für ausgewählte Unternehmen, Dienste und optional Mitarbeiter und Gäste über die Microsoft Graph Booking-Termin-API. Im folgenden Beispiel erstellen wir eine Onlinebesprechung, die der Buchung zugeordnet ist. Darüber hinaus können Sie Anmerkungen und Erinnerungen zur Verfügung stellen.
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"

In der Antwort sehen Sie, dass ein neuer Booking-Termin erstellt wurde. Der virtuelle Termin wird auch in der Microsoft Booking-App und in der Microsoft Teams-Anwendung für virtuelle Termine angezeigt.

Hinweis

Die einzige Möglichkeit zum Abrufen von Kundeninformationen ist die Verwendung von GET für die Microsoft Graph Booking-Termin-API.

Einbeziehen des eigenen Planungssystems

Wenn Sie bereits über ein Planungssystem verfügen und es mit der von Microsoft Teams bereitgestellten virtuellen Terminumgebung erweitern möchten, führen Sie die folgenden Schritte aus:

  1. Erstellen Sie eine Onlinebesprechung für einen virtuellen Termin über die Microsoft Graph Online-Besprechungs-API.

Hinweis

Bei diesem Vorgang wird kein Kalenderereignis in Microsoft Booking, Outlook oder Microsoft Teams erstellt. Wenn Sie ein Kalenderereignis erstellen möchten, verwenden Sie die Microsoft Graph-Kalenderereignis-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. Erstellen einer virtuellen Terminumgebung für eine Onlinebesprechungsressource, die im vorherigen Schritt erstellt wurde, über
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/..."

Sie können die generierte URL in Ihrem Planungssystem speichern oder einen dedizierten Speicher für Schlüssel-Wert-Paare erstellen, der die eindeutige ID des Kalenderereignisses in Ihrem Terminplanungssystem mit der URL zur virtuellen Terminumgebung von Microsoft Teams verknüpft.

Nächste Schritte