Usar la API de Microsoft Bookings en Microsoft Graph

  • Artículo

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Microsoft Bookings permite a los propietarios de pequeñas empresas y organizaciones empresariales administrar información y reservas de clientes con una configuración mínima. El propietario de una empresa puede crear una o más empresas, y cada una de estas puede ofrecer un conjunto de servicios. El propietario puede configurar miembros del personal y especificar los servicios que realiza cada uno. Un cliente puede reservar una cita para un servicio específico en esa empresa con una aplicación móvil o una aplicación en línea. Bookings garantiza que la hora de la cita se mantenga actualizada para la empresa, los miembros del personal y los clientes.

Mediante programación, en un elemento bookingBusiness de la API de Bookings se incluyen los objetos siguientes:

Uso de la API de REST de Bookings

Vea los pasos siguientes antes de reservar citas de clientes para una empresa por primera vez. Asegúrese de proporcionar los tokens de acceso correspondientes para las operaciones específicas.

  1. Asegúrese de que la empresa tenga una suscripción de Microsoft 365 Empresa Premium.
  2. Permite crear un elemento bookingBusiness mediante el envío de una operación POST al conjunto de entidades. Como mínimo, necesita especificar un nombre para la nueva empresa que verán los clientes: 
POST https://graph.microsoft.com/beta/bookingBusinesses
Authorization: Bearer {access token}
Content-Type: application/json

{
    "displayName":"Contoso"
}

Use la propiedad id del nuevo elemento bookingBusiness proporcionado en la respuesta POST para seguir personalizando la configuración de la empresa y agregue servicios y miembros del personal a la empresa.

  1. Agregue miembros del personal a la empresa:
POST https://graph.microsoft.com/beta/bookingBusinesses/{id}/staffMembers
Authorization: Bearer {access token}
Content-Type: application/json

{
    "displayName":"Dana Swope",
    "emailAddress": "danas@contoso.com",
    "role": "externalGuest"
}
  1. Defina todos los servicios ofrecidos por la empresa:
POST https://graph.microsoft.com/beta/bookingBusinesses/{id}/services
Authorization: Bearer {access token}
Content-Type: application/json

{
    "displayName":"Bento"
}
  1. Publique la página de programación de la empresa para permitir que clientes y operadores empresariales empiecen a reservar citas:
POST https://graph.microsoft.com/beta/bookingBusinesses/{id}/publish
Authorization: Bearer {access token}

En general, para mostrar una lista de todas las empresas de reservas en el espacio empresarial de Microsoft 365:

GET https://graph.microsoft.com/beta/bookingBusinesses
Authorization: Bearer {access token}

Casos de uso común

En la tabla siguiente, se muestran las operaciones comunes para una empresa en la API de Bookings.

Casos de uso Recursos de REST Vea también
Crear, obtener, actualizar o eliminar una empresa bookingBusiness Métodos de bookingBusiness
Actualizar la directiva de programación bookingSchedulingPolicy Actualizar un elemento bookingBusiness
Agregar, obtener, actualizar o eliminar miembros del personal bookingStaffMember Métodos de bookingStaffMember
Agregar, obtener, actualizar o eliminar servicios bookingService Métodos de bookingService
Publicar o cancelar la publicación de la página de programación bookingBusiness publish
unpublish
Crear, obtener, actualizar, eliminar o cancelar una cita bookingAppointment Métodos de bookingAppointment
Obtener las citas de un intervalo de fechas bookingBusiness List Bookings calendarView
Obtener la moneda bookingCurrency Métodos de bookingCurrency

Contenido relacionado