Utilisation de l’API Microsoft Bookings dans Microsoft Graph

Microsoft Bookings permet aux responsables d’entreprise et aux petites entreprises de gérer les livres clients et les informations avec une configuration minimale. Un dirigeant d’entreprise peut créer une ou plusieurs entreprises qui offrent chacune leurs propres services. Le dirigeant peut configurer les employés et indiquer les services que chaque employé assure. Un client peut prendre un rendez-vous pour un service proposé par cette entreprise dans une application mobile ou en ligne. Bookings permet à l’entreprise, aux employés et aux clients concernés de consulter l’heure du rendez-vous.

Côté programme, un objet bookingBusiness dans l’API Bookings implique :

Utilisation de l’API REST Bookings

Suivez la procédure suivante avant de proposer aux clients de prendre rendez-vous. Assurez-vous que vous fournissez les jetons d’accès correspondant aux opérations.

  1. Vérifiez que l’entreprise a un abonnement Microsoft 365 Business Premium.
  2. Créez un objet bookingBusiness en envoyant une opération POST au jeu d’entités. Vous devez au moins spécifier un nom pour la nouvelle entreprise, que les clients verront :
POST https://graph.microsoft.com/v1.0/solutions/bookingBusinesses
Authorization: Bearer {access token}
Content-Type: application/json

{
    "displayName":"Contoso"
}

Utilisez la propriété id du nouvel objet bookingBusiness renvoyé dans la réponse POST pour continuer à personnaliser les paramètres de l’entreprise, puis ajoutez les employés et les services de l’entreprise.

  1. Ajoutez les employés pour l’entreprise :
POST https://graph.microsoft.com/v1.0/solutions/bookingBusinesses/{id}/staffMembers
Authorization: Bearer {access token}
Content-Type: application/json

{
    "displayName":"Dana Swope",
    "emailAddress": "danas@contoso.com",
    "role": "externalGuest"
}
  1. Définissez les services proposés par l’entreprise :
POST https://graph.microsoft.com/v1.0/solutions/bookingBusinesses/{id}/services
Authorization: Bearer {access token}
Content-Type: application/json

{
    "displayName":"Bento"
}
  1. Publiez la page de planification pour l’entreprise afin de permettre aux clients et aux exploitants de commencer à prendre rendez-vous :
POST https://graph.microsoft.com/v1.0/solutions/bookingBusinesses/{id}/publish
Authorization: Bearer {access token}

En général, pour répertorier toutes les entreprises de réservation dans le client Microsoft 365 :

GET https://graph.microsoft.com/v1.0/solutions/bookingBusinesses
Authorization: Bearer {access token}

Cas d’utilisation courants

Le tableau suivant répertorie les opérations courantes réalisées par les entreprises dans l’API Bookings.

Cas d’utilisation Ressources REST Voir aussi
Créer, obtenir, mettre à jour ou supprimer une entreprise bookingBusiness Méthodes de l’objet bookingBusiness
Mettre à jour la stratégie de planification bookingSchedulingPolicy Mise à jour d’un objet bookingBusiness
Ajouter, obtenir, mettre à jour ou supprimer des employés bookingStaffMember Méthodes de l’objet bookingStaffMember
Ajouter, obtenir, mettre à jour ou supprimer des services bookingService Méthodes de l’objet bookingService
Ajouter, obtenir, mettre à jour ou supprimer des questions personnalisées bookingCustomQuestion Méthodes de bookingCustomQuestion
Ajouter, obtenir, mettre à jour ou supprimer des clients bookingCustomer Méthodes de bookingCustomer
Publier ou annuler la publication de la page de planification bookingBusiness Publication
Annuler la publication
Créer, obtenir, mettre à jour, supprimer ou annuler un rendez-vous bookingAppointment Méthodes de l’objet bookingAppointment
Obtenir les rendez-vous compris dans une plage de dates bookingBusiness Liste des objets calendarView dans Bookings
Obtenir la devise bookingCurrency Méthodes de l’objet bookingCurrency

Nouveautés

Pour en savoir plus sur le les dernières nouveautés et mises à jour pour cet ensemble d'API.

Voir aussi