Delen via


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

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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:

  1. '401': Controleer op problemen met betrekking tot verificatie in uw verbinding.
  2. '403': Alleen bookingsbeheerders kunnen afspraakstromen maken. Controleer (1) in de sectie Bekende problemen en beperkingen.
  3. '403': Meldings-URL-domein maakt geen deel uit van de lijst met toegestane adressen.
  4. '429': Meer dan verwacht aantal afspraakstromen gemaakt voor een bedrijf. Controleer (2) in de sectie Bekende problemen en beperkingen.
  5. '502': dit is een interne serverfout. Meld dit aan uw ondersteuningstechnicus met alle foutdetails in het antwoord op het maken van stromen.

Veelgestelde vragen

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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.

  6. 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.

  7. 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

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

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

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

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
email 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
Email 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.