Compartir a través de


Microsoft Bookings (versión preliminar)

Microsoft Bookings es una herramienta de programación y forma parte de la familia de productos de Microsoft Office. Permite a los usuarios y organizaciones crear páginas de reserva y ayudar a sus clientes a reservar citas fácilmente.

Este conector está disponible en los siguientes productos y regiones:

Service Class Regions
Copilot Studio Estándar Todas las regiones de Power Automate excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Aplicaciones lógicas Estándar Todas las regiones de Logic Apps excepto las siguientes:
     - Regiones de Azure Government
     - Regiones de Azure China
     - Departamento de Defensa de EE. UU. (DoD)
Power Apps Estándar Todas las regiones de Power Apps excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Power Automate Estándar Todas las regiones de Power Automate excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Contacto
Nombre Soporte técnico de Microsoft 365
URL https://support.microsoft.com/en-us/contactus#
Metadatos del conector
Publicador Microsoft Corporation
Sitio web https://book.ms
Directiva de privacidad https://docs.microsoft.com/en-us/microsoft-365/bookings/bookings-faq?view=o365-worldwide#privacy
Categorías Gestión empresarial; Colaboración

El conector de Microsoft Bookings se crea con el fin de ampliar las citas de Booking con otras funcionalidades que la plataforma de energía tiene que ofrecer. ¿Alguna vez ha buscado flujos de trabajo personalizados que ha querido crear para sus clientes cuando hacen un nombramiento con su empresa, como, Reservar una reunión de Zoom junto con una cita, Integrar un método de pago mediante Sripe, Cargar datos de cliente en un sistema CRM, enviar correos electrónicos de bienvenida? El conector de Booking es una solución para estas preguntas. Con este conector estamos exponiendo todas las acciones de reserva de citas, como Create/Update/Delete of Bookings.

Prerrequisitos

Los clientes que intentan usar el conector de Bookings deben tener una licencia empresarial de Bookings para usar este conector. Microsoft Bookings estará disponible con estas licencias.

Obtención de credenciales

Microsoft Bookings usa la autenticación de Id. de Microsoft Entra. Tener una cuenta válida de O365 garantizará que esté autenticado para usar el conector de Bookings. Debe ser un usuario que haya iniciado sesión para crear flujos basados en citas.

Introducción al conector

Para crear un flujo personalizado con puntos de aplicación de Bookings como desencadenadores, deberá conocer la dirección SMTP de Booking busineess. Puede crear flujos con citas de reservas que se crean, actualizan o cancelan como desencadenadores. Estos son algunos de los flujos comunes que puede compilar:

Integración con Stripe

Stripe permite a particulares y empresas aceptar pagos a través de Internet. Puede realizar un seguimiento de clientes, pedidos, facturas y mucho más; Para obtener más información , Stripe | Microsoft Power Automate

Integración con Zoom

Este conector le ayudará a automatizar las operaciones de reunión de Zoom; Para obtener más información acerca de las reuniones de Zoom (publicador independiente) | Microsoft Power Automate

Integración con Dynamic 365

Dynamics 365 Sales Insights ayuda a aumentar las ventas con la ayuda de información controlada por ia que promueve la interacción personalizada y la toma de decisiones proactivas para ayudar a crear relaciones. ; Para obtener más información sobre Dynamics 365 Sales Insights | Microsoft Power Automate

Esta es toda la lista de conectores: Lista de conectores admitidos | Microsoft Power Automate

Problemas y limitaciones conocidos

  1. Solo los administradores de Bookings pueden crear flujos mediante desencadenadores de citas. Descripción: ahora solo los administradores de Bookings (diferentes de los administradores de inquilinos) pueden crear desencadenadores de citas. Si es un usuario que no es administrador (miembro del equipo, programador, visor, invitado), debe pedir al administrador que cree un flujo. Como alternativa, también puede solicitar acceso de administrador.

  2. Solo se pueden crear 5 flujos por buzón de Bookings. Descripción: para un buzón de reserva, solo se pueden crear 5 flujos. Se trata de un límite de nivel de buzón de Bookings y no un límite por administrador. Si busca más de una acción para un desencadenador de cita, puede agregarla en uno de los flujos existentes mediante el botón Agregar acción. Puede ponerse en contacto con otros administradores de Booking para obtener soporte técnico.

  3. Errores que indican "Personal que no forma parte de Bookings Business", "Autoridad no válida" al crear un flujo. Descripción: asegúrese de que forma parte de dicho buzón de Bookings y que es administrador del mismo. Puede ir a la pestaña personal y comprobar lo mismo.

  4. Algunos de los parámetros de Bookings- Cancel Reason for 1:1 Bookings no se rellenan. Descripción: los dicho paramters no aparecen ahora y estamos trabajando para corregir esto pronto.

  5. Error de puerta de enlace incorrecta: si hay problemas en la API de back-end para crear flujos. Se ven errores de puerta de enlace incorrecta 502. Notifique lo mismo al soporte técnico de Microsoft 365.

Errores y soluciones comunes

Códigos de error HTTP al crear flujos:

  1. '401': compruebe si hay problemas relacionados con la autenticación en la conexión.
  2. '403': Solo los administradores de Bookings pueden crear flujos de citas. Consulte (1) en la sección Problemas conocidos y limitaciones.
  3. '403': dominio de dirección URL de notificación no forma parte de la lista de permitidos.
  4. '429': más del número esperado de flujos de citas creados para una empresa. Consulte (2) en la sección Problemas conocidos y limitaciones.
  5. '502': se trata de un error interno del servidor. Notifique esto al ingeniero de soporte técnico con todos los detalles de error en la respuesta de creación del flujo.

Preguntas más frecuentes

  1. ¿Qué hago si mi calendario de Booking no forma parte de la lista desplegable de los desencadenadores? Respuesta: Esta lista desplegable se basa en calendarios de reservas a los que se ha accedido recientemente para el usuario. Puede visitarla una vez desde la página web de Bookings y debe asegurarse de que aparezca el calendario de Bookings. Es posible que tampoco tenga acceso de administrador si no ve un buzón específico solo.

  2. Si (1) no funciona, ¿cómo puedo crear un flujo para un calendario del que soy administrador? Respuesta: Puede escribir un valor personalizado. El valor aquí será la dirección SMTP de la empresa/ Puede ir a su página bookings. Busque la pestaña Integraciones y seleccione la opción Power Automate. Puede copiar la dirección SMTP que se muestra aquí y pegarla en el cuadro de texto del flujo.

  3. ¿Cómo obtener datos del cliente de las respuestas del desencadenador de citas? Respuesta: Si se trata de una reserva de 1:1, se pueden usar los campos de nivel superior, como CustomerName, CustomerEmail, etc. Si es una reserva de grupo, la matriz de clientes se puede usar para obtener campos como displayName (clientes email, customers displayName, etc.) se puede usar con una opción "Foreach" de Power Automate.

  4. ¿Por qué staffMembers es una matriz? Respuesta: Podrá asignar más de un miembro del personal como anfitrión. Si el servicio solo tiene un personal como anfitrión, los detalles del personal se verán en la matriz de miembros del personal.

  5. ¿Existe un identificador común que se puede usar entre desencadenadores para una misma cita? Respuesta: Sí, puede usar selfServiceAppointmentId. Este campo se rellenará para todo tipo de citas, ya sea En línea o In-Person o El personal reservado o el cliente reservado. El campo "Id" es un identificador de intercambio y no es único entre desencadenadores.

  6. ¿Hay alguna manera de obtener lo que ha cambiado en la notificación del desencadenador de citas de actualización? Respuesta: No, esto no es posible hoy.

  7. ¿Cómo funcionan las notificaciones para la cita de varios asistentes? Respuesta: En caso de citas con varios asistentes, la adición de nuevos clientes (después del primero) se desencadena como una cita de actualización y no como una cita de creación. Esto se debe al hecho de que agregar un nuevo cliente a una reserva creada básicamente significa agregar un asistente a una entidad de cita de reservas existente. El primer cliente que se agregó a la ranura siempre desencadena el desencadenador de creación de citas, ya que es el punto en el que se crea la entidad de cita de reserva.

Creación de una conexión

El conector admite los siguientes tipos de autenticación:

Predeterminado Parámetros para crear una conexión. Todas las regiones No se puede compartir

Predeterminado

Aplicable: Todas las regiones

Parámetros para crear una conexión.

Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.

Limitaciones

Nombre Llamadas Período de renovación
Llamadas API por conexión 100 60 segundos

Acciones

Enumerar las empresas de reservas en las que el usuario es administrador

Operación que se usa para enumerar todos los buzones para los que el usuario de acceso es administrador.

Enumerar las empresas de reservas en las que el usuario es administrador

Operación que se usa para enumerar todos los buzones para los que el usuario de acceso es administrador.

Devoluciones

Desencadenadores

Cuando se actualiza una cita

Este desencadenador se usa para escuchar la actualización de las citas de reservas. Seleccione una página de reserva o escriba la dirección SMTP de la página de reserva que desea escuchar para actualizar eventos de citas.

Cuando se cancela una cita

Este desencadenador se usa para escuchar la cancelación de las citas de reservas. Seleccione una página de reserva o escriba la dirección SMTP de la página de reserva que desea escuchar para cancelar eventos de citas.

Cuando se crea una cita

Este desencadenador se usa para escuchar la creación de citas de reservas. Seleccione una página de reserva o escriba la dirección SMTP de la página de reserva que desea escuchar para crear eventos de cita.

Cuando se actualiza una cita

Este desencadenador se usa para escuchar la actualización de las citas de reservas. Seleccione una página de reserva o escriba la dirección SMTP de la página de reserva que desea escuchar para actualizar eventos de citas.

Parámetros

Nombre Clave Requerido Tipo Description
Página de reserva.
SMTPAddress True string

Seleccionar una página de reserva

change_type
change_type True array of string

Cambios para escuchar

Devoluciones

Cuando se cancela una cita

Este desencadenador se usa para escuchar la cancelación de las citas de reservas. Seleccione una página de reserva o escriba la dirección SMTP de la página de reserva que desea escuchar para cancelar eventos de citas.

Parámetros

Nombre Clave Requerido Tipo Description
Página de reserva.
SMTPAddress True string

Seleccionar una página de reserva

change_type
change_type True array of string

Cambios para escuchar

Devoluciones

Cuando se crea una cita

Este desencadenador se usa para escuchar la creación de citas de reservas. Seleccione una página de reserva o escriba la dirección SMTP de la página de reserva que desea escuchar para crear eventos de cita.

Parámetros

Nombre Clave Requerido Tipo Description
Página de reserva.
SMTPAddress True string

Seleccionar una página de reserva

change_type
change_type True array of string

Cambios para escuchar

Devoluciones

Definiciones

ListMailboxResponse

Nombre Ruta de acceso Tipo Description
Buzones
mailboxes array of MailboxEntity

Todas las entidades de buzón.

MailboxEntity

Nombre Ruta de acceso Tipo Description
Nombre para mostrar
displayName string

Nombre para mostrar del buzón.

SMTP de buzón
email string

SMTP del buzón de booking.

AppointmentData

Nombre Ruta de acceso Tipo Description
Información adicional
AdditionalInfo string

Información adicional sobre la reserva.

Correo electrónico del cliente
CustomerEmail string

Dirección de correo electrónico del cliente en caso de reservas de 1:1.

ID del Cliente
CustomerId string

Id. de cliente en caso de reservas de 1:1.

Nombre para mostrar de ubicación
CustomerLocation.DisplayName string

Nombre para mostrar de la ubicación del cliente. Ubicación rellenada desde la página C2 para 1:1 Booking.

City
CustomerLocation.PhysicalAddress.City string

Ciudad a la que pertenece el cliente para la reserva 1:1.

País o Región
CustomerLocation.PhysicalAddress.CountryOrRegion string

País o región del cliente para la reserva de 1:1.

Código postal
CustomerLocation.PhysicalAddress.PostalCode string

Código postal del cliente para la reserva de 1:1.

Estado
CustomerLocation.PhysicalAddress.State string

Estado al que pertenece el cliente en la reserva de 1:1.

Calle
CustomerLocation.PhysicalAddress.Street string

Calle a la que pertenece el cliente en la reserva de 1:1.

NombreDelCliente
CustomerName string

Nombre del cliente para la reserva de 1:1.

CustomerNotes
CustomerNotes string

Notas del cliente para la reserva de 1:1.

CustomQuestionAnswers
CustomQuestionAnswers array of CustomQuestion

Todas las preguntas y respuestas personalizadas para la reserva 1:1.

CustomerPhone
CustomerPhone string

Teléfono del cliente para la reserva de 1:1.

CustomerTimeZone
CustomerTimeZone string

Zona horaria del cliente para la reserva de 1:1.

Clientela
Customers array of CustomerData

Lista de clientes en la reserva 1:N

Duración
Duration integer

Duración de la cita

EndTime
EndTime string

Hora de finalización de la cita.

FilledAttendeesCount
FilledAttendeesCount integer

Número de asistentes que han reservado esta ranura de aplicación.

Id
Id string

[En desuso] - use selfServiceAppointmentId como identificador único para la cita de reservas.

IsSMSNotificationsEnabled
IsSMSNotificationsEnabled boolean

Campo para comprobar si la notificación sms está habilitada para la cita.

JoinWebURL
JoinWebURL string

Dirección URL para unirse a esta cita en línea.

MaxAttendeesCount
MaxAttendeesCount integer

Número máximo de asistentes permitidos en esta aplicación.

SelfServiceAppointmentId
SelfServiceAppointmentId string

Identificador de cita para la cita de reserva.

ServiceId
ServiceId string

Identificador de servicio único.

ServiceName
ServiceName string

Nombre del servicio de reservas.

ServiceNotes
ServiceNotes string

Notas de nivel de servicio para el personal y el administrador.

StaffMembers
StaffMembers array of StaffMemberData

Lista de miembros del personal

Hora de comienzo
StartTime string

Hora de inicio de la cita.

Datos de seguimiento
TrackingData string

Datos de seguimiento de campañas.

Motivo de cancelación
CancelReason string

Motivo de cancelación de esta cita de reserva

CustomerData

Nombre Ruta de acceso Tipo Description
Correo Electrónico
Email string

Correo electrónico del cliente en la reserva del grupo.

Id
Id string

Identificador único del cliente en la reserva de grupo.

Nombre para mostrar de ubicación
Location.DisplayName string

Nombre para mostrar de la ubicación del cliente. Ubicación rellenada desde la página C2 para la reserva de grupo.

City
Location.PhysicalAddress.City string

Ciudad a la que pertenece el cliente para la reserva de grupo.

País o región
Location.PhysicalAddress.CountryOrRegion string

País o región del cliente para la reserva de grupo.

Código postal
Location.PhysicalAddress.PostalCode string

Código postal del cliente para la reserva de grupo.

Estado
Location.PhysicalAddress.State string

Estado al que pertenece el cliente en la reserva de grupo.

Calle
Location.PhysicalAddress.Street string

Calle a la que pertenece el cliente en la reserva del grupo.

Nombre de pantalla
Name string

Nombre para mostrar del cliente en la reserva de grupo.

Notas
Notes string

Notas del cliente en la reserva del grupo.

Timezone
TimeZone string

Zona horaria del cliente en la reserva del grupo.

Answers
Answers array of CustomQuestion

Todas las preguntas y respuestas personalizadas.

StaffMemberData

Nombre Ruta de acceso Tipo Description
DisplayName (Nombre para mostrar)
DisplayName string

Nombre para mostrar del personal asignado para esta cita.

Dirección de correo electrónico
EmailAddress string

Dirección de correo electrónico del personal asignado a esta cita.

Id
Id string

Identificador de personal único.

CustomQuestion

Nombre Ruta de acceso Tipo Description
Respuesta
Answer string

Responda a esta pregunta personalizada.

AnswerOptions
AnswerOptions array of string

Todas las opciones de respuesta.

IsRequired
IsRequired boolean

Indica si la respuesta a esta pregunta es obligatoria.

Pregunta
Question string

Pregunta que se va a responder.

QuestionID
QuestionID string

Identificador único de la pregunta que se va a responder.

SelectedOptions
SelectedOptions array of integer

Todas las opciones de respuesta seleccionadas.