Introducción

Este artículo trata sobre la API de sincronización de salas de Exchange y el servicio de sincronización de salas de Exchange. Se incluyen instrucciones para configurar los ajustes relacionados con la sincronización de salas de Exchange en Korbyt Booking, una tabla de compatibilidad de aplicaciones y el proceso completo de implementación. Mediante este servicio de sincronización de salas de Exchange, las reservas creadas desde cualquier interfaz se pueden sincronizar automáticamente con cualquier otro sistema conectado. La integración también permitirá la importación masiva de citas existentes desde Exchange hKorbyt.

Este artículo también está disponible como documento PDF adjunto

Configuración de la aplicación con usuarios y recursos

Puntos a tener en cuenta:

• Si tienes Exchange local, solo puedes utilizar EWS (autenticación básica), y la versión de Exchange debe ser 2012 o superior

• Si utiliza Exchange Online, debe utilizar Graph.

• Si utiliza tanto la versión local como la en línea, se recomienda utilizar EWS

• Si utiliza un sistema híbrido, deberá configurar cada una de las conexiones de Exchange. Las salas y los usuarios de cada Exchange deberán asignarse individualmente a su Exchange correspondiente. Tenga en cuenta las siguientes combinaciones. Las tres primeras son compatibles, pero la última no lo es.

  • Compatible: usuario local (EWS) y buzón de recursos local (EWS)

  • Compatible: usuario local (EWS) y buzón de recursos en línea (Graph)

  • Compatible: buzón de usuario en línea (Graph) y buzón de recursos en línea (Graph)

  • No compatible: buzón de usuario en línea (Graph) y buzón de recursos local (EWS)

Tipos de opciones de configuración/autenticación de Exchange compatibles

1. EWS local (solo autenticación básica)

2. API de Graph (solo en línea)

Nota: EWS OAuth NO es compatible cuando se utiliza Exchange Rooms Sync

Proceso de implementación

En esta sección se describen todas las configuraciones necesarias en las interfaces de Korbyt Booking para habilitar la integración con Exchange Sync.

Toda la información que figura a continuación da por supuesto que ya existe un sistema de Korbyt Booking. Hay una lista de verificación independiente sobre lo que también se requiere y que no es exclusivo de Exchange Room Sync.

Consulte la ista de verificación de configuración de Exchange si no está seguro de lo que se considera un «sistema de reservas de Korbyt en funcionamiento».

Requisitos previos

• URL de Exchange EWS y cuenta de servicio (cuando se utiliza la autenticación básica)

• Registro de la aplicación en Azure para la API de Graph

• El usuario que cree el registro de la aplicación necesita derechos de administrador global en Azure.

• HTTPS debe estar habilitado.

• Debe permitirse el tráfico de Internet entrante y saliente. Los clientes locales deben consultar las siguientes URL para obtener detalles sobre las direcciones IP que deben incluirse en la lista blanca al acceder a Exchange Online (Graph).

  • Este artículo de soporte técnico de Microsoft enumera todos los puntos de conexión de Microsoft en un archivo de formato JSON:

    URL e intervalos de direcciones IP de Microsoft 365

  • En este artículo de soporte técnico de Microsoft se puede encontrar una lista adicional de las direcciones IP necesarias:

    Otros puntos finales no incluidos en el servicio web de direcciones IP y URL de Microsoft 365

• Versión mínima de Korbyt Booking V8.4.2.1

• Otras interfaces como Bookit, Outlook y Mobile, según sea necesario

• Se realiza la sincronización de empleados para importar todos los usuarios

• Sincronización de recursos para importar todos los alias de buzones de correo de los recursos

• Korbyt API del servicio web de Booking

• Korbyt Conector EWS de Booking

• Korbyt Servicio ExchCal de reservas (configuración descrita a continuación)

• Korbyt API de sincronización de reservas ExchCal (configuración descrita a continuación)

• Los buzones de recursos de Exchange están configurados correctamente (véase más abajo)

• Si procede, importe las citas de recursos existentes al espacio de trabajo de reservas de Korbyt

Información del buzón de sala de Exchange

La configuración de los recursos variará en función de cómo se hayan creado, es decir, si se ha utilizado PowerShell o el UAC (Control de cuentas de usuario) del navegador.

El comando de PowerShell utilizado para obtener detalles del procesamiento del calendario:
Get-CalendarProcessing "Nombre de la sala" |fl

Utilizando Exchange Server PowerShell (Exchange Management Shell), utilice el cmdlet Set-CalendarProcessing para modificar las opciones de procesamiento del calendario de los buzones de recursos individuales, tal y como se muestra a continuación:
Set-CalendarProcessing -Identity "Nombre de la sala" -AutomateProcessing AutoAccept -DeleteComments $false -DeleteSubject $false

Las reglas y restricciones establecidas en Korbyt Booking deben, siempre que sea posible, reflejarse en Exchange. Considere comentarlas para evitar situaciones de desincronización. Por ejemplo, Korbyt Booking no admite reservas recurrentes sin fecha de finalización. En Korbyt Booking se impondrá un límite al número máximo de ocurrencias permitidas. Si esto no se respeta en Exchange para futuras reservas, los sistemas pueden quedar desincronizados.

Documentación de Microsoft que explica el procesamiento del calendario de recursos de salas:
Artículo de soporte de Microsoft - Set-CalendarProcessing

Configuración del archivo de configuración de sincronización de salas de Exchange

Independientemente de cómo se establezca la conexión con Exchange, es necesario completar esta sección.

Esto lo realizará un técnico de Korbyt.

Korbyt API de sincronización de reservas ExchCal

Configuración de Exchange Room Sync en Azure

En esta sección se describen todas las configuraciones necesarias en el Portal de Azure.

Registrar la aplicación en Azure

Los siguientes pasos describen cómo configurar el registro de la aplicación en Azure, necesario al utilizar la API de Graph (sección siguiente) o al utilizar EWS OAuth (detallado en la sección posterior a la API de Graph).

Configuración de la API de Graph

1. Inicie sesión en el portal de Azure con una cuenta de administrador.

2. En la pantalla de inicio, seleccione la opción Registros de aplicaciones.

   

3. En la página Registros de aplicaciones, seleccione Nuevo registro

   

4. Cuando aparezca la página «Registrar una aplicación», introduzca la información de registro de su aplicación:

   • En la sección Nombre, introduzca un nombre para la aplicación como se muestra a continuación.

     

   • En la sección Tipos de cuenta admitidos, seleccione Solo cuentas del directorio de la organización (Solo dominio de cliente – Un único inquilino)

     

   • Selecciona Registrar para crear la aplicación

5. En la página «Descripción general» de la aplicación, busca los valores «ID de la aplicación (cliente)» y «ID del directorio (inquilino)» y anótalos para más adelante. Los necesitarás para configurar los campos correspondientes durante la configuración de la reserva de Korbyt; facilítalos al equipo de TI de Korbyt
   

   

6. Haga clic en la opción «Certificados y secretos» a la izquierda. Cree un nuevo secreto de cliente con las especificaciones deseadas y guarde el valor de la clave; es necesario introducirlo en el sistema de reservas de Korbyt, por lo que también deberá facilitarlo a Korbyt junto con el ID de cliente y el ID de inquilino.

   

   
   Nota: Para la autenticación basada en certificados en lugar de utilizar un secreto de cliente, consulte el documento «Autenticación basada en certificados para acceder a la API de MS Graph» que se proporciona por separado.
   Tenga en cuenta que si configura el secreto para que caduque en poco tiempo y no recuerda establecer el nuevo secreto a tiempo, sus reservas no se sincronizarán como se espera.
   

7. Haga clic en la opción «Permisos de API» a la izquierda. Haga clic en Añadir un permiso => «Graph API» y asigne el siguiente conjunto de permisos. Configure los seis permisos de tipo «Delegado» según la lista que figura a continuación y el permiso de tipo «Aplicación».

   

8. Haga clic en la opción Conceder consentimiento de administrador; esto solo funcionará si dispone de derechos de administrador global.

9. El registro de la aplicación de Azure ya está completo. Ve a la sección siguiente, titulada «Configuración de Exchange Room Sync - Administración»

EWS OAuth

No es compatible con Exchange Rooms Sync.

Configuración de Exchange Room Sync - Administración

Esta sección describe todos los ajustes necesarios en la interfaz web de reservas de Korbyt. Existen muchas opciones diferentes dependiendo de qué versión de Exchange se utilice y de cómo se establezca la conexión con Exchange. Asegúrese de utilizar el conjunto de configuración correcto en función del entorno que esté utilizando.

1. Vaya a Administración => Ajustes => Ajustes globales. Si el sistema se configuró con ajustes de Exchange en la página principal de ajustes globales, esta opción debe desactivarse ahora si tiene previsto utilizar la opción Exchange Rooms Sync.
   

   

2. Seleccione «Sí» en el botón de opción junto a «Habilitar sincronización de salas de Exchange».

3. Haga clic en el enlace «Configurar», que mostrará la ventana de configuración
   

   

4. En la sección Tipo de configuración, hay una opción «Seleccionar tipo de interfaz».

   • Hay dos opciones:

     • EWS

     • Gráfico

     • Consulte las secciones desplegables a continuación para obtener instrucciones detalladas sobre ambas opciones.

Ajustes de configuración para EWS

Ajustes de configuración para Graph

Configuración relacionada de Korbyt Booking

Habilite la integración de EWS para todos los tipos de interfaz de usuario que vayan a estar involucrados en el entorno.

1. Vaya a Administración => Configuración => Configuración de reglas de negocio globales

2. Seleccione la categoría «Gestión de estados» y, a continuación, seleccione «Estado predeterminado»

3. En la fila de configuración de «Aplicación web», marque la casilla de verificación de la columna «Habilitar actualizaciones de EWS»

4. Compruebe otros tipos de interfaz de usuario, que normalmente ya están configurados.
   

   

Configure los usuarios del sistema para que utilicen una conexión de Exchange específica. La conexión de Exchange debe estar configurada antes de este paso.

1. Vaya a Administración => Seguridad de usuarios => Usuario

2. Cree un nuevo usuario o abra uno existente

3. En la configuración «Configuración de Exchange», seleccione el nombre de la configuración de Exchange deseada.

   

O

1. Vaya a Administración => Ajustes => Ajustes globales

2. En Ajustes de Exchange, acceda a los ajustes de Sincronización de salas de Exchange haciendo clic en el enlace Configurar.

3. En la configuración de Exchange, haz clic en Aplicar bajo el encabezado Todos los
   usuarios Nota: esto aplicará el tipo de configuración a TODOS los usuarios. Si utilizas varias conexiones de Exchange, no utilices esta opción, ya que sobrescribirá la configuración de cualquier otro usuario

Configure los recursos del sistema para que utilicen una conexión de Exchange específica. La conexión de Exchange debe estar configurada antes de este paso.

1. 1. Vaya a Administración => Gestión de recursos => Recurso y abra un recurso nuevo o existente

2. Establezca el nombre de la configuración de Exchange dentro de la configuración del recurso

3. Configure la dirección de correo electrónico correspondiente del recurso de Exchange
   

   

O

1. Vaya a Administración => Ajustes => Ajustes globales

2. En Ajustes de Exchange, acceda a los ajustes de sincronización de salas de Exchange haciendo clic en el enlace Configurar

3. Frente a la configuración de Exchange, haz clic en Aplicar bajo el encabezado Todos los
   recursos Nota: esto aplicará el tipo de configuración a TODOS los recursos; si utilizas varias conexiones de Exchange, no utilices esta opción, ya que sobrescribirá la configuración de cualquier otro recurso.
   
   Nota 2: si utilizas esta opción, sigue siendo necesario establecer la dirección de correo electrónico correspondiente del recurso de Exchange. Esto deberá hacerse manualmente.
   

   

Alias de correo electrónico

Si el entorno tiene varios alias por usuario o recurso, estos se pueden añadir en la página de configuración del usuario o del recurso, en la sección de administración. Utilice la sincronización de empleados para los usuarios y la utilidad de sincronización de recursos para los alias de recursos. Las direcciones de correo electrónico principales de los buzones de los recursos deben configurarse manualmente.

Disponer de estos alias de correo electrónico agilizará la sincronización de salas de Exchange y evitará algunos problemas en los que se ha producido una migración y las direcciones de correo electrónico antiguas siguen en uso.

Configuración de la importación de reservas de Exchange

En esta sección se describe cómo habilitar y ejecutar la importación de reservas de Exchange para añadir las reservas de Exchange existentes al sistema de reservas de Korbyt. Si las reservas existentes no se están sincronizando, esta sección no es necesaria.

Nota:
Esto solo está disponible para EWS; la
API Graph no admite esta función.

1. Vaya a Administración => Configuración global => Haga clic en Configurar junto a Configuración de Exchange

2. En la columna Importar de la configuración correcta de Exchange, haga clic en el botón Importar

   

3. Introduzca los siguientes datos:

   1. Fecha de inicio: el intervalo de fechas de inicio para importar las reservas

   2. Fecha de finalización: el intervalo de fechas de finalización para importar reservas

   3. Seleccionar recursos: todos los recursos que se incluirán en la importación

4. Guarde esta configuración.

5. Tras guardar, aparecerá un mensaje indicando que la importación ha comenzado

   

6. Una vez completada, aparecerá un mensaje indicando que la importación ha finalizado