Microsoft Bookings (preview)
Microsoft Bookings is een planningsprogramma en maakt deel uit van de Microsoft Office-productenfamilie. Hiermee kunnen gebruikers en organisaties boekingspagina's maken en kunnen hun klanten eenvoudig afspraken boeken.
Deze connector is beschikbaar in de volgende producten en regio's:
| Dienst | Class | Regions |
|---|---|---|
| Copilot Studio | Standaard | Alle Power Automate-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Logic-apps | Standaard | Alle Logic Apps-regio's , met uitzondering van het volgende: - Azure Government-regio's - Azure China-regio's - Us Department of Defense (DoD) |
| Power Apps | Standaard | Alle Power Apps-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Standaard | Alle Power Automate-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Contactpersoon | |
|---|---|
| Naam | Microsoft 365-ondersteuning |
| URL | https://support.microsoft.com/en-us/contactus# |
| Connectormetagegevens | |
|---|---|
| Uitgever | Microsoft Corporation |
| Webpagina | https://book.ms |
| Privacybeleid | https://docs.microsoft.com/en-us/microsoft-365/bookings/bookings-faq?view=o365-worldwide#privacy |
| Categorieën | Bedrijfsbeheer; Samenwerking |
De Microsoft Bookings-connector is gebouwd om Booking-afspraken uit te breiden met andere functies die power platform te bieden heeft. Hebt u ooit gezocht naar aangepaste werkstromen die u voor uw klanten wilde bouwen wanneer ze een afspraak maken met uw bedrijf, zoals Het boeken van een Zoom-vergadering samen met een afspraak, het integreren van een betalingswijze met Behulp van Sripe, het uploaden van klantgegevens naar een CRM-systeem, het verzenden van welkomstmails? Reserveringsconnector is een oplossing voor deze vragen. Met deze connector worden alle afspraakreserveringsacties weergegeven, zoals Maken/Bijwerken/Verwijderen van Bookings.
Vereiste voorwaarden
Klanten die de Bookings Connector willen gebruiken, moeten beschikken over een Bookings Business-licentie om deze connector mee te gebruiken. Microsoft Bookings is beschikbaar met deze licenties.
Referenties ophalen
Microsoft Bookings maakt gebruik van Microsoft Entra ID-verificatie. Als u een geldig O365-account hebt, zorgt u ervoor dat u bent geverifieerd voor het gebruik van de Bookings-connector. U moet een aangemelde gebruiker zijn om op afspraken gebaseerde stromen te maken.
Aan de slag met uw connector
Als u een aangepaste stroom wilt maken met Bookings-apppointments als triggers, moet u het SMTP-adres van Booking Busineess kennen. U kunt stromen maken met boekingen die worden gemaakt/bijgewerkt/geannuleerd als triggers. Hier volgen enkele algemene stromen die u kunt bouwen:
Integratie met Stripe
Met Stripe kunnen particulieren en bedrijven betalingen via internet accepteren. U kunt klanten, bestellingen, facturen en meer volgen; Voor meer informatie Stripe | Microsoft Power Automate
Integratie met Zoom
Deze connector helpt bij het automatiseren van Zoom Meeting Operations; Voor meer informatie zoomvergaderingen (onafhankelijke uitgever) | Microsoft Power Automate
Integratie met Dynamic 365
Dynamics 365 Sales Insights helpt uw verkoop te verhogen met behulp van AI-gestuurde inzichten die gepersonaliseerde betrokkenheid en proactieve besluitvorming bevorderen om relaties te bouwen. ; Voor meer informatie over Dynamics 365 Sales Insights | Microsoft Power Automate
Hier volgt een lijst met connectors: lijst met ondersteunde connectors | Microsoft Power Automate
Bekende problemen en beperkingen
Alleen Bookings-beheerders kunnen stromen maken met behulp van afspraaktriggers. Beschrijving: Op dit moment kunnen alleen Bookings-beheerders (anders dan tenantbeheerders) afspraaktriggers maken. Als u een gebruiker bent die geen beheerder is (Teamlid, Scheduler, Viewer, Gast), moet u uw beheerder vragen een stroom te maken. U kunt ook beheerderstoegang aanvragen.
Er kunnen slechts 5 stromen per Boekingspostvak worden gemaakt. Beschrijving: Voor een boekingspostvak kunnen slechts 5 stromen worden gemaakt. Dit is een limiet op bookings-postvakniveau en niet per beheerderslimiet. Als u meer dan één actie zoekt voor een afspraaktrigger, kunt u deze toevoegen in een van de bestaande stromen met behulp van de knop Actie toevoegen. U kunt contact opnemen met andere Booking-beheerders voor ondersteuning.
Fouten met de tekst 'Personeel dat geen deel uitmaakt van Bookings Business', 'Ongeldige instantie' tijdens het maken van een stroom. Beschrijving: Zorg ervoor dat u deel uitmaakt van de genoemde Bookings Mailbox en u bent een beheerder voor hetzelfde. U kunt naar het tabblad Personeel gaan en hetzelfde controleren.
Sommige van de parameters Bookings - Reden annuleren voor 1:1 Bookings worden niet ingevuld. Beschrijving: De genoemde paramters verschijnen nu niet en we werken eraan om dit binnenkort op te lossen.
Fout met ongeldige gateway: als er problemen zijn in de back-end-API voor het maken van stromen. Er worden 502 ongeldige gatewayfouten weergegeven. Meld hetzelfde aan de ondersteuning van Microsoft 365.
Veelvoorkomende fouten en oplossingen
HTTP-foutcodes tijdens het maken van stromen:
- '401': Controleer op problemen met betrekking tot verificatie in uw verbinding.
- '403': Alleen bookingsbeheerders kunnen afspraakstromen maken. Controleer (1) in de sectie Bekende problemen en beperkingen.
- '403': Meldings-URL-domein maakt geen deel uit van de lijst met toegestane adressen.
- '429': Meer dan verwacht aantal afspraakstromen gemaakt voor een bedrijf. Controleer (2) in de sectie Bekende problemen en beperkingen.
- '502': dit is een interne serverfout. Meld dit aan uw ondersteuningstechnicus met alle foutdetails in het antwoord op het maken van stromen.
Veelgestelde vragen
Wat moet ik doen als mijn boekingsagenda geen deel uitmaakt van de vervolgkeuzelijst in de triggers? Antwoord: Deze vervolgkeuzelijst is gebaseerd op onlangs geopende boekingsagenda's waarvoor de gebruiker een beheerder is. U kunt deze eenmaal bezoeken vanaf de webpagina van Bookings en dit moet ervoor zorgen dat de boekingsagenda wordt weergegeven. Mogelijk hebt u ook geen beheerderstoegang als u alleen een specifiek postvak niet ziet.
Als (1) niet werkt, hoe maak ik een stroom voor een agenda waarvan ik beheerder ben? Antwoord: U kunt een aangepaste waarde invoeren. De waarde hier is het SMTP-adres van het bedrijf/ U kunt naar de pagina Boekingen gaan. Zoek naar het tabblad Integraties en selecteer de optie Power Automate. U kunt het HIER weergegeven SMTP-adres kopiëren en plakken in het tekstvak van de stroom.
Hoe kunt u klantgegevens ophalen uit de antwoorden van de afspraaktrigger? Antwoord: Als dit een reservering van 1:1 is, kunnen de velden op het hoogste niveau zoals CustomerName, CustomerEmail enzovoort worden gebruikt. Als het een groepsboeking is, kan de matrix klanten worden gebruikt om velden zoals displayName (klanten-e-mail, klanten displayName enzovoort) op te halen met de optie 'Foreach' voor power automate.
Waarom is staffmembers een matrix? Antwoord: U kunt meer dan één personeelslid toewijzen als host. Als uw service slechts één personeel als host heeft, worden de personeelsgegevens weergegeven in de matrix met personeelsleden.
Is er een gemeenschappelijke id die kan worden gebruikt voor triggers voor dezelfde afspraak? Antwoord: Ja, u kunt de selfServiceAppointmentId gebruiken. Dit veld wordt ingevuld voor alle soorten afspraken: online of In-Person of personeel geboekt of klant geboekt. Het veld Id is een exchange-id en is niet uniek voor triggers.
Is er een manier om te zien wat er is gewijzigd in de melding van de update-afspraaktrigger? Antwoord: Nee, dit is vandaag niet mogelijk.
Hoe werken meldingen voor afspraken met meerdere deelnemers? Antwoord: In het geval van afspraken met meerdere deelnemers wordt het toevoegen van nieuwe klanten (na de eerste) geactiveerd als een update-afspraak en niet als een afspraak maken. Dit komt doordat het toevoegen van een nieuwe klant aan een gemaakte reservering in feite betekent dat een deelnemer wordt toegevoegd aan de afspraakentiteit van een bestaande boeking. De eerste klant die aan de site is toegevoegd, activeert altijd de aanmaaktrigger van de afspraak, omdat dit het punt is waarop de entiteit reserveringsafspraken wordt gemaakt.
Een verbinding maken
De connector ondersteunt de volgende verificatietypen:
| standaard | Parameters voor het maken van verbinding. | Alle regio's | Niet deelbaar |
Verstek
Van toepassing: Alle regio's
Parameters voor het maken van verbinding.
Dit is geen deelbare verbinding. Als de power-app wordt gedeeld met een andere gebruiker, wordt een andere gebruiker gevraagd om expliciet een nieuwe verbinding te maken.
Beperkingslimieten
| Name | Aanroepen | Verlengingsperiode |
|---|---|---|
| API-aanroepen per verbinding | 100 | 60 seconden |
Acties
| Lijst met boekingsbedrijven waar de gebruiker een beheerder is |
Bewerking die wordt gebruikt om alle postvakken weer te geven waarvoor de toegangsgebruiker een beheerder is. |
Lijst met boekingsbedrijven waar de gebruiker een beheerder is
Bewerking die wordt gebruikt om alle postvakken weer te geven waarvoor de toegangsgebruiker een beheerder is.
Retouren
- Body
- ListMailboxResponse
Triggers
| Wanneer een afspraak wordt bijgewerkt |
Deze trigger wordt gebruikt om te luisteren naar het bijwerken van afspraken voor boekingen. Selecteer een boekingspagina of voer het SMTP-adres in van de boekingspagina waarop u wilt luisteren naar update-afspraakevenementen. |
| Wanneer een afspraak wordt geannuleerd |
Deze trigger wordt gebruikt om te luisteren naar het annuleren van reserveringen. Selecteer een boekingspagina of voer het SMTP-adres in van de boekingspagina waarnaar u wilt luisteren om afspraken te annuleren. |
| Wanneer een afspraak wordt gemaakt |
Deze trigger wordt gebruikt om te luisteren naar het maken van afspraken voor boekingen. Selecteer een boekingspagina of voer het SMTP-adres in van de boekingspagina waarnaar u wilt luisteren om afspraken te maken |
Wanneer een afspraak wordt bijgewerkt
Deze trigger wordt gebruikt om te luisteren naar het bijwerken van afspraken voor boekingen. Selecteer een boekingspagina of voer het SMTP-adres in van de boekingspagina waarop u wilt luisteren naar update-afspraakevenementen.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Boekingspagina.
|
SMTPAddress | True | string |
Selecteer een reserveringspagina |
|
change_type
|
change_type | True | array of string |
Wijzigingen om op te luisteren |
Retouren
- Body
- AppointmentData
Wanneer een afspraak wordt geannuleerd
Deze trigger wordt gebruikt om te luisteren naar het annuleren van reserveringen. Selecteer een boekingspagina of voer het SMTP-adres in van de boekingspagina waarnaar u wilt luisteren om afspraken te annuleren.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Boekingspagina.
|
SMTPAddress | True | string |
Selecteer een reserveringspagina |
|
change_type
|
change_type | True | array of string |
Wijzigingen om op te luisteren |
Retouren
- Body
- AppointmentData
Wanneer een afspraak wordt gemaakt
Deze trigger wordt gebruikt om te luisteren naar het maken van afspraken voor boekingen. Selecteer een boekingspagina of voer het SMTP-adres in van de boekingspagina waarnaar u wilt luisteren om afspraken te maken
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Boekingspagina.
|
SMTPAddress | True | string |
Selecteer een reserveringspagina |
|
change_type
|
change_type | True | array of string |
Wijzigingen om op te luisteren |
Retouren
- Body
- AppointmentData
Definities
ListMailboxResponse
| Name | Pad | Type | Description |
|---|---|---|---|
|
Postvakken
|
mailboxes | array of MailboxEntity |
Alle postvakentiteiten. |
MailboxEntity
| Name | Pad | Type | Description |
|---|---|---|---|
|
Weergavenaam
|
displayName | string |
Weergavenaam van postvak. |
|
Smtp-postvak
|
string |
SMTP van het boekingspostvak. |
AppointmentData
| Name | Pad | Type | Description |
|---|---|---|---|
|
Aanvullende info
|
AdditionalInfo | string |
Aanvullende informatie over de boeking. |
|
E-mail van klant
|
CustomerEmail | string |
E-mailadres van de klant in geval van 1:1 boekingen. |
|
KlantId
|
CustomerId | string |
Klant-id in geval van 1:1 boekingen. |
|
Weergavenaam van locatie
|
CustomerLocation.DisplayName | string |
Weergavenaam van klantlocatie. Locatie gevuld vanaf de C2-pagina voor 1:1 Reservering. |
|
City
|
CustomerLocation.PhysicalAddress.City | string |
Plaats waar de klant deel uitmaakt van een reservering van 1:1. |
|
CountryOrRegion
|
CustomerLocation.PhysicalAddress.CountryOrRegion | string |
Land of regio van de klant voor reservering van 1:1. |
|
Postcode
|
CustomerLocation.PhysicalAddress.PostalCode | string |
Postcode van de klant voor boeking van 1:1. |
|
Staat
|
CustomerLocation.PhysicalAddress.State | string |
Staat waar de klant deel uitmaakt van de reservering van 1:1. |
|
Adres
|
CustomerLocation.PhysicalAddress.Street | string |
Straat waartoe de klant behoort in de reservering van 1:1. |
|
Klantnaam
|
CustomerName | string |
Klantnaam voor reservering van 1:1. |
|
CustomerNotes
|
CustomerNotes | string |
Klantnotities voor reservering van 1:1. |
|
CustomQuestionAnswers
|
CustomQuestionAnswers | array of CustomQuestion |
Alle aangepaste vragen en antwoorden voor 1:1 boeking. |
|
CustomerPhone
|
CustomerPhone | string |
Telefoon klant voor reservering van 1:1. |
|
CustomerTimeZone
|
CustomerTimeZone | string |
Klanttijdzone voor reservering van 1:1. |
|
Klanten
|
Customers | array of CustomerData |
Lijst met klanten in de reservering van 1:N |
|
Duur
|
Duration | integer |
Duur van de afspraak |
|
EndTime
|
EndTime | string |
Eindtijd van de afspraak. |
|
FilledAttendeesCount
|
FilledAttendeesCount | integer |
Het aantal deelnemers dat deze appoinmentsite heeft geboekt. |
|
Identiteitsbewijs
|
Id | string |
[Afgeschaft] - gebruik selfServiceAppointmentId als unieke id voor de afspraak met boekingen. |
|
IsSMSNotificationsEnabled
|
IsSMSNotificationsEnabled | boolean |
Veld om te controleren of sms-melding is ingeschakeld voor de afspraak. |
|
JoinWebURL
|
JoinWebURL | string |
URL voor deelname aan deze online afspraak. |
|
MaxAttendeesCount
|
MaxAttendeesCount | integer |
Maximum aantal deelnemers dat is toegestaan in deze appoinment. |
|
SelfServiceAppointmentId
|
SelfServiceAppointmentId | string |
Afspraak-id voor de boekingsafspraken. |
|
ServiceId
|
ServiceId | string |
Unieke service-id. |
|
Dienstnaam
|
ServiceName | string |
Naam van de boekingsservice. |
|
ServiceNotes
|
ServiceNotes | string |
Notities op serviceniveau voor het personeel en de beheerder. |
|
StaffMembers
|
StaffMembers | array of StaffMemberData |
Lijst met personeelsleden |
|
Begintijd
|
StartTime | string |
Begintijd van de afspraak. |
|
Traceringsgegevens
|
TrackingData | string |
Gegevens voor het bijhouden van campagnes. |
|
Reden annuleren
|
CancelReason | string |
Reden voor annulering van deze boekings afspraak |
CustomerData
| Name | Pad | Type | Description |
|---|---|---|---|
|
E-mailen
|
string |
E-mail van de klant in de groepsboeking. |
|
|
Identiteitsbewijs
|
Id | string |
Unieke id van de klant in de groepsboeking. |
|
Weergavenaam van locatie
|
Location.DisplayName | string |
Weergavenaam van klantlocatie. Locatie gevuld vanaf de C2-pagina voor groepsboeking. |
|
City
|
Location.PhysicalAddress.City | string |
Plaats waar de klant bij hoort voor groepsboeking. |
|
Land of regio
|
Location.PhysicalAddress.CountryOrRegion | string |
Land of regio van de klant voor groepsboeking. |
|
Postcode
|
Location.PhysicalAddress.PostalCode | string |
Postcode van de klant voor groepsboeking. |
|
Staat
|
Location.PhysicalAddress.State | string |
Staat waar de klant deel uitmaakt van de groepsboeking. |
|
Adres
|
Location.PhysicalAddress.Street | string |
Straat waartoe de klant behoort in de groepsboeking. |
|
Weergavenaam
|
Name | string |
Weergavenaam van de klant in de groepsboeking. |
|
Opmerkingen
|
Notes | string |
Notities van de klant in de groepsboeking. |
|
Timezone
|
TimeZone | string |
Tijdzone van de klant in de groepsboeking. |
|
Antwoorden
|
Answers | array of CustomQuestion |
Alle aangepaste vragen en antwoorden. |
StaffMemberData
| Name | Pad | Type | Description |
|---|---|---|---|
|
Schermnaam
|
DisplayName | string |
Weergavenaam van het personeel dat is toegewezen voor deze afspraak. |
|
E-mailadres
|
EmailAddress | string |
E-mailadres van het personeel dat aan deze afspraak is toegewezen. |
|
Identiteitsbewijs
|
Id | string |
Unieke personeels-id. |
CustomQuestion
| Name | Pad | Type | Description |
|---|---|---|---|
|
Antwoord
|
Answer | string |
Antwoord op deze aangepaste vraag. |
|
AnswerOptions
|
AnswerOptions | array of string |
Alle antwoordopties. |
|
IsVereist
|
IsRequired | boolean |
Geeft aan of het beantwoorden van deze vraag verplicht is. |
|
Question
|
Question | string |
Vraag die moet worden beantwoord. |
|
QuestionID
|
QuestionID | string |
Unieke id van de vraag die moet worden beantwoord. |
|
SelectedOptions
|
SelectedOptions | array of integer |
Alle geselecteerde antwoordopties. |