Microsoft Bookings (Vorschau)
Microsoft Bookings ist ein Planungstool und gehört zur Microsoft Office-Produktfamilie. Sie ermöglicht Es Benutzern und Organisationen, Buchungsseiten zu erstellen und ihren Kunden das einfache Buchen von Terminen zu erleichtern.
Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:
| Dienstleistung | Class | Regions |
|---|---|---|
| Copilot Studio | Norm | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Logik-Apps | Norm | Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche: – Azure Government-Regionen - Azure China-Regionen - US Department of Defense (DoD) |
| Power Apps | Norm | Alle Power Apps-Regionen mit Ausnahme der folgenden: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Power Automate | Norm | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Kontakt | |
|---|---|
| Name | Microsoft 365-Support |
| URL | https://support.microsoft.com/en-us/contactus# |
| Connectormetadaten | |
|---|---|
| Herausgeber | Microsoft Corporation |
| Webseite | https://book.ms |
| Datenschutzrichtlinie | https://docs.microsoft.com/en-us/microsoft-365/bookings/bookings-faq?view=o365-worldwide#privacy |
| Kategorien | Unternehmensführung; Zusammenarbeit |
Der Microsoft Bookings-Connector wurde entwickelt, um Buchungstermine mit anderen Funktionen zu erweitern, die von der Power Platform angeboten werden müssen. Haben Sie jemals nach benutzerdefinierten Workflows gesucht, die Sie für Ihre Kunden erstellen möchten, wenn sie eine Bestellung mit Ihrem Unternehmen tätigen, z. B. "Buchen einer Zoombesprechung" zusammen mit einem Termin, Integrieren einer Zahlungsmethode mit Sripe, Hochladen von Kundendaten in ein CRM-System, Senden von Willkommens-E-Mails? Buchungsconnector ist eine Lösung für diese Fragen. Mit diesem Connector stellen wir alle Terminbuchungsaktionen bereit – z. B. Erstellen/Aktualisieren/Löschen von Bookings.
Voraussetzungen
Kunden, die versuchen, den Bookings Connector zu verwenden, sollten über eine Bookings Business-Lizenz verfügen, um diesen Connector zu verwenden. Microsoft Bookings ist mit diesen Lizenzen verfügbar.
So erhalten Sie Anmeldeinformationen
Microsoft Bookings verwendet die Microsoft Entra ID-Authentifizierung. Wenn Sie ein gültiges O365-Konto haben, stellen Sie sicher, dass Sie authentifiziert sind, um den Bookings-Connector zu verwenden. Sie sollten ein angemeldeter Benutzer sein, um terminbasierte Flüsse zu erstellen.
Erste Schritte mit Ihrem Connector
Zum Erstellen eines benutzerdefinierten Flusses mit Bookings-Apppointments als Trigger müssen Sie die SMTP-Adresse von Booking busineess kennen. Sie können Abläufe mit Buchungen erstellen, die als Trigger erstellt/aktualisiert/storniert werden. Hier sind einige der gängigen Flüsse, die Sie erstellen können:
Integration mit Stripe
Stripe ermöglicht es Privatpersonen und Unternehmen, Zahlungen über das Internet zu akzeptieren. Sie können Kunden, Bestellungen, Rechnungen und vieles mehr nachverfolgen; Weitere Informationen stripe | Microsoft Power Automate
Integration mit Zoom
Dieser Connector hilft beim Automatisieren von Zoombesprechungsvorgängen; Weitere Informationen zum Zoomen von Besprechungen (unabhängiger Herausgeber) | Microsoft Power Automate
Integration in Dynamic 365
Dynamics 365 Sales Insights hilft, Ihren Umsatz mit Hilfe von KI-gesteuerten Erkenntnissen zu steigern, die personalisiertes Engagement und proaktive Entscheidungsfindung fördern, um Beziehungen aufzubauen. ; Weitere Informationen zu Dynamics 365 Sales Insights | Microsoft Power Automate
Hier ist die liste der Connectors: Liste der unterstützten Connectors | Microsoft Power Automate
Bekannte Probleme und Einschränkungen
Nur Bookings-Administratoren können Abläufe mithilfe von Termintriggern erstellen. Beschreibung: Derzeit können nur Bookings-Administratoren (anders als Mandantenadministratoren) Terminauslöser erstellen. Wenn Sie ein Benutzer sind, der kein Administrator ist (Teammitglied, Scheduler, Viewer, Gast), sollten Sie Ihren Administrator bitten, einen Fluss zu erstellen. Alternativ können Sie auch administratorzugriff anfordern.
Pro Bookings-Postfach können nur fünf Flüsse erstellt werden. Beschreibung: Für ein Buchungspostfach können nur 5 Flüsse erstellt werden. Dies ist ein Grenzwert auf Bookings-Postfachebene und kein Grenzwert pro Administrator. Wenn Sie nach mehr als einer Aktion für einen Termintrigger suchen, können Sie dies in einem der vorhandenen Flüsse hinzufügen, indem Sie die Schaltfläche "Aktion hinzufügen" verwenden. Sie können sich an andere Buchungsadministratoren wenden, um Support zu erhalten.
Fehler mit der Meldung "Mitarbeiter nicht Teil von Bookings Business", "Ungültige Autorität" beim Erstellen eines Flusses. Beschreibung: Stellen Sie sicher, dass Sie Teil des angegebenen Bookings-Postfachs sind und Sie ein Administrator für dasselbe sind. Sie können zur Registerkarte "Mitarbeiter" wechseln und dasselbe überprüfen.
Einige der Bookings-Parameter - "Cancel Reason for 1:1 Bookings" werden nicht aufgefüllt. Beschreibung: Die genannten Paramters werden jetzt nicht angezeigt, und wir arbeiten daran, dies bald zu beheben.
Ungültiger Gatewayfehler – Wenn probleme in der Back-End-API zum Erstellen von Flüssen auftreten. 502 Fehlerhafte Gatewayfehler werden erkannt. Melden Sie sich bitte an den Microsoft 365-Support.
Häufige Fehler und Abhilfemaßnahmen
HTTP-Fehlercodes beim Erstellen von Flüssen:
- '401': Überprüfen Sie in Ihrer Verbindung auf Authentifizierungsprobleme.
- '403': Nur Bookings-Administratoren können Terminflüsse erstellen. Überprüfen (1) im Abschnitt "Bekannte Probleme und Einschränkungen".
- '403': Benachrichtigungs-URL-Domäne nicht Teil der zulässigen Liste.
- '429': Mehr als erwartet anzahl von Terminflüssen, die für ein Unternehmen erstellt wurden. Check (2) im Abschnitt "Bekannte Probleme und Einschränkungen".
- '502': Dies ist ein interner Serverfehler. Melden Sie dies ihrem Supporttechniker mit allen Fehlerdetails in der Ablauferstellungsantwort.
Häufig gestellte Fragen
Was mache ich, wenn mein Buchungskalender nicht Teil der Dropdownliste in den Triggern ist? Antwort: Diese Dropdownliste basiert auf kürzlich aufgerufenen Bookings-Kalendern, für die der Benutzer ein Administrator ist. Sie können es einmal auf der Bookings-Webseite besuchen, und dies sollte sicherstellen, dass Bookings-Kalender angezeigt wird. Möglicherweise haben Sie auch keinen Administratorzugriff, wenn ein bestimmtes Postfach nicht allein angezeigt wird.
Wenn (1) nicht funktioniert, wie erstelle ich einen Fluss für einen Kalender, von dem ich administrator bin? Antwort: Sie können einen benutzerdefinierten Wert eingeben. Der Wert hier ist die SMTP-Adresse des Unternehmens/ Sie können zu Ihrer Bookings-Seite wechseln. Suchen Sie nach der Registerkarte "Integrationen", und wählen Sie die Power Automate-Option aus. Sie können die hier angezeigte SMTP-Adresse kopieren und in das Textfeld des Flusses einfügen.
Wie können Kundendaten aus den Terminauslöserantworten abgerufen werden? Antwort: Wenn dies eine Buchung von 1:1 ist, können die Felder der obersten Ebene wie CustomerName, CustomerEmail usw. verwendet werden. Wenn es sich um Gruppenbuchungen handelt, kann das Kundenarray verwendet werden, um Felder wie displayName (Kunden-E-Mail, Kunden displayName usw.) mit einer Power Automate-Option "Foreach" abzurufen.
Warum ist StaffMembers ein Array? Antwort: Sie können mehr als einen Mitarbeiter als Host zuweisen. Wenn Ihr Dienst nur einen Mitarbeiter als Host hat, werden die Mitarbeiterdetails im Mitarbeiterarray angezeigt.
Gibt es eine allgemeine ID, die für einen Termin über Trigger hinweg verwendet werden kann? Antwort: Ja, Sie können die selfServiceAppointmentId verwenden. Dieses Feld wird für alle Arten von Terminen aufgefüllt – sei es Online oder In-Person oder Gebuchte Mitarbeiter oder gebuchte Kunden. Das Feld "ID" ist eine Exchange-ID und ist nicht über Trigger hinweg eindeutig.
Gibt es eine Möglichkeit, welche Änderungen in der Aktualisierungstermintriggerbenachrichtigung zu erhalten? Antwort: Nein, das ist heute nicht möglich.
Wie funktionieren Benachrichtigungen für Mehrteilnehmertermine? Antwort: Bei Terminen mit mehreren Teilnehmern wird das Hinzufügen neuer Kunden (nach dem ersten Termin) als Aktualisierungstermin und nicht als Erstellung eines Termins ausgelöst. Dies liegt daran, dass das Hinzufügen eines neuen Kunden zu einer erstellten Buchung im Wesentlichen bedeutet, dass ein Teilnehmer zur Terminentität einer vorhandenen Buchung hinzugefügt wird. Der erste Kunde, der dem Slot hinzugefügt wurde, löst immer den Terminerstellungstrigger aus, da dies der Zeitpunkt ist, an dem die Buchungsterminentität erstellt wird.
Erstellen einer Verbindung
Der Connector unterstützt die folgenden Authentifizierungstypen:
| Vorgabe | Parameter zum Erstellen einer Verbindung. | Alle Regionen | Nicht teilbar |
Vorgabe
Anwendbar: Alle Regionen
Parameter zum Erstellen einer Verbindung.
Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.
Drosselungsgrenzwerte
| Name | Aufrufe | Verlängerungszeitraum |
|---|---|---|
| API-Aufrufe pro Verbindung | 100 | 60 Sekunden |
Aktionen
| Buchungsunternehmen auflisten, bei denen der Benutzer ein Administrator ist |
Der Vorgang, der zum Auflisten aller Postfächer verwendet wird, für die der Zugriff auf den Benutzer ein Administrator ist. |
Buchungsunternehmen auflisten, bei denen der Benutzer ein Administrator ist
Der Vorgang, der zum Auflisten aller Postfächer verwendet wird, für die der Zugriff auf den Benutzer ein Administrator ist.
Gibt zurück
- Body
- ListMailboxResponse
Auslöser
| Beim Erstellen eines Termins |
Dieser Trigger wird verwendet, um das Erstellen von Buchungen von Terminen zu überwachen. Wählen Sie eine Buchungsseite aus, oder geben Sie die SMTP-Adresse der Buchungsseite ein, die Sie auf das Erstellen von Terminereignissen überwachen möchten. |
| Wenn ein Termin abgebrochen wird |
Dieser Auslöser wird verwendet, um den Abbruch von Terminen zu überwachen. Wählen Sie eine Buchungsseite aus, oder geben Sie die SMTP-Adresse der Buchungsseite ein, auf die Sie sich freuen, auf Terminereignisse abzuhören. |
| Wenn ein Termin aktualisiert wird |
Dieser Trigger wird zum Überwachen der Aktualisierung von Buchungen von Terminen verwendet. Wählen Sie eine Buchungsseite aus, oder geben Sie die SMTP-Adresse der Buchungsseite ein, die Sie auf die Aktualisierung von Terminereignissen überwachen möchten. |
Beim Erstellen eines Termins
Dieser Trigger wird verwendet, um das Erstellen von Buchungen von Terminen zu überwachen. Wählen Sie eine Buchungsseite aus, oder geben Sie die SMTP-Adresse der Buchungsseite ein, die Sie auf das Erstellen von Terminereignissen überwachen möchten.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Buchungsseite.
|
SMTPAddress | True | string |
Buchungsseite auswählen |
|
change_type
|
change_type | True | array of string |
Änderungen an der Überwachung |
Gibt zurück
- Body
- AppointmentData
Wenn ein Termin abgebrochen wird
Dieser Auslöser wird verwendet, um den Abbruch von Terminen zu überwachen. Wählen Sie eine Buchungsseite aus, oder geben Sie die SMTP-Adresse der Buchungsseite ein, auf die Sie sich freuen, auf Terminereignisse abzuhören.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Buchungsseite.
|
SMTPAddress | True | string |
Buchungsseite auswählen |
|
change_type
|
change_type | True | array of string |
Änderungen an der Überwachung |
Gibt zurück
- Body
- AppointmentData
Wenn ein Termin aktualisiert wird
Dieser Trigger wird zum Überwachen der Aktualisierung von Buchungen von Terminen verwendet. Wählen Sie eine Buchungsseite aus, oder geben Sie die SMTP-Adresse der Buchungsseite ein, die Sie auf die Aktualisierung von Terminereignissen überwachen möchten.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Buchungsseite.
|
SMTPAddress | True | string |
Buchungsseite auswählen |
|
change_type
|
change_type | True | array of string |
Änderungen an der Überwachung |
Gibt zurück
- Body
- AppointmentData
Definitionen
ListMailboxResponse
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Briefkästen
|
mailboxes | array of MailboxEntity |
Alle Postfachentitäten. |
MailboxEntity
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Anzeigename
|
displayName | string |
Anzeigename des Postfachs. |
|
SMTP-Postfach
|
string |
SMTP des Buchungspostfachs. |
AppointmentData
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Zusätzliche Info
|
AdditionalInfo | string |
Zusätzliche Informationen zur Buchung. |
|
Kunden-E-Mail
|
CustomerEmail | string |
Kunden-E-Mail-Adresse im Fall von 1:1 Buchungen. |
|
Kunden-ID
|
CustomerId | string |
Kunden-ID im Falle von 1:1 Buchungen. |
|
Anzeigename des Speicherorts
|
CustomerLocation.DisplayName | string |
Anzeigename des Kundenstandorts. Der Ort wurde von der C2-Seite für 1:1 Buchung ausgefüllt. |
|
Stadt
|
CustomerLocation.PhysicalAddress.City | string |
Ort, zu dem der Kunde für eine Buchung von 1:1 gehört. |
|
CountryOrRegion
|
CustomerLocation.PhysicalAddress.CountryOrRegion | string |
Land oder Region des Kunden für 1:1 Buchung. |
|
Postleitzahl
|
CustomerLocation.PhysicalAddress.PostalCode | string |
Postleitzahl des Kunden für 1:1 Buchung. |
|
Staat
|
CustomerLocation.PhysicalAddress.State | string |
Bundesland, zu dem der Kunde in der Buchung von 1:1 gehört. |
|
Straße
|
CustomerLocation.PhysicalAddress.Street | string |
Straße, zu der der Kunde in der Buchung von 1:1 gehört. |
|
Kundenname
|
CustomerName | string |
Kundenname für 1:1 Buchung. |
|
CustomerNotes
|
CustomerNotes | string |
Kundennotizen für 1:1 Buchung. |
|
CustomQuestionAnswers
|
CustomQuestionAnswers | array of CustomQuestion |
Alle benutzerdefinierten Fragen und Antworten für 1:1 Buchung. |
|
CustomerPhone
|
CustomerPhone | string |
Kundentelefon für 1:1 Buchung. |
|
CustomerTimeZone
|
CustomerTimeZone | string |
Kundenzeitzone für 1:1 Buchung. |
|
Kundschaft
|
Customers | array of CustomerData |
Liste der Kunden in der 1:N-Buchung |
|
Dauer
|
Duration | integer |
Dauer des Termins |
|
EndTime
|
EndTime | string |
Endzeit des Termins. |
|
FilledAttendeesCount
|
FilledAttendeesCount | integer |
Die Anzahl der Teilnehmer, die diesen Appoinment-Slot gebucht haben. |
|
Id
|
Id | string |
[Veraltet] – Verwenden Sie selfServiceAppointmentId als eindeutigen Identifer für den Bookings-Termin. |
|
IsSMSNotificationsEnabled
|
IsSMSNotificationsEnabled | boolean |
Feld, um zu überprüfen, ob die SMS-Benachrichtigung für den Termin aktiviert ist. |
|
JoinWebURL
|
JoinWebURL | string |
URL für den Beitritt zu diesem Onlinetermin. |
|
MaxAttendeesCount
|
MaxAttendeesCount | integer |
Maximale Anzahl der in dieser App zulässigen Teilnehmer. |
|
SelfServiceAppointmentId
|
SelfServiceAppointmentId | string |
Termin-ID für den Buchungstermin. |
|
ServiceId
|
ServiceId | string |
Eindeutiger Dienstbezeichner. |
|
Dienstname
|
ServiceName | string |
Name des Bookings-Diensts. |
|
ServiceNotes
|
ServiceNotes | string |
Hinweise auf Dienstebene für die Mitarbeiter und Administratoren. |
|
StaffMembers
|
StaffMembers | array of StaffMemberData |
Liste der Mitarbeiter |
|
Startzeit
|
StartTime | string |
Startzeit des Termins. |
|
Nachverfolgen von Daten
|
TrackingData | string |
Kampagnenverfolgungsdaten. |
|
Grund für 'Abbrechen'
|
CancelReason | string |
Grund für die Stornierung dieses Buchungstermins |
CustomerData
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Email
|
string |
E-Mail des Kunden in der Gruppenbuchung. |
|
|
Id
|
Id | string |
Eindeutige ID des Kunden in der Gruppenbuchung. |
|
Anzeigename des Speicherorts
|
Location.DisplayName | string |
Anzeigename des Kundenstandorts. Ort, der von der C2-Seite für die Gruppenbuchung ausgefüllt wurde. |
|
Stadt
|
Location.PhysicalAddress.City | string |
Ort, zu dem der Kunde für die Gruppenbuchung gehört. |
|
Land oder Region
|
Location.PhysicalAddress.CountryOrRegion | string |
Land oder Region des Kunden für die Gruppenbuchung. |
|
Postleitzahl
|
Location.PhysicalAddress.PostalCode | string |
Postleitzahl des Kunden für Gruppenbuchung. |
|
Staat
|
Location.PhysicalAddress.State | string |
Bundesland, zu dem der Kunde in der Gruppenbuchung gehört. |
|
Straße
|
Location.PhysicalAddress.Street | string |
Straße, zu der der Kunde in der Gruppenbuchung gehört. |
|
Anzeigename
|
Name | string |
Anzeigename des Kunden in der Gruppenbuchung. |
|
Hinweise
|
Notes | string |
Hinweise zum Kunden in der Gruppenbuchung. |
|
Timezone
|
TimeZone | string |
Zeitzone des Kunden in der Gruppenbuchung. |
|
Antworten
|
Answers | array of CustomQuestion |
Alle benutzerdefinierten Fragen und Antworten. |
StaffMemberData
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Anzeigename
|
DisplayName | string |
Anzeigename der für diesen Termin zugewiesenen Mitarbeiter. |
|
E-Mail-Adresse
|
EmailAddress | string |
E-Mail-Adresse der mitarbeiter, die diesem Termin zugewiesen sind. |
|
Id
|
Id | string |
Eindeutiger Mitarbeiterbezeichner. |
CustomQuestion
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Antwort
|
Answer | string |
Beantworten Sie diese benutzerdefinierte Frage. |
|
AnswerOptions
|
AnswerOptions | array of string |
Alle Antwortoptionen. |
|
IsRequired
|
IsRequired | boolean |
Gibt an, ob die Beantwortung dieser Frage obligatorisch ist. |
|
Frage
|
Question | string |
Zu beantwortende Frage. |
|
QuestionID
|
QuestionID | string |
Eindeutiger Bezeichner der zu beantwortenden Frage. |
|
SelectedOptions
|
SelectedOptions | array of integer |
Alle ausgewählten Antwortoptionen. |