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
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.
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.
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.
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.
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:
- '401': compruebe si hay problemas relacionados con la autenticación en la conexión.
- '403': Solo los administradores de Bookings pueden crear flujos de citas. Consulte (1) en la sección Problemas conocidos y limitaciones.
- '403': dominio de dirección URL de notificación no forma parte de la lista de permitidos.
- '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.
- '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
¿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.
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.
¿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.
¿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.
¿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.
¿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.
¿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
- Body
- ListMailboxResponse
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
- Body
- AppointmentData
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
- Body
- AppointmentData
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
- Body
- AppointmentData
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
|
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
|
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. |