Beamery utilizará Cronofy para gestionar sus funciones de Meeting Scheduler. Este artículo contiene una descripción general de cómo se configura y gestiona esta integración.

Arquitectura de la API

Beamery utiliza Cronofy como servicio para permitir a los usuarios gestionar sus conexiones con los calendarios de los usuarios finales. Esta integración admite la sincronización de los calendarios de los usuarios de varios proveedores de calendarios, incluidos Gmail, Outlook y Exchange.

Autenticación del usuario final

Para permitir que Beamery acceda al calendario de un usuario a través de Cronofy, el usuario primero debe autorizar la conexión mediante un flujo OAuth2 gestionado por Cronofy. El usuario se autenticará con el servicio de calendario que haya elegido (p. ej., Google o Microsoft). Beamery nunca gestiona directamente las credenciales del usuario; únicamente recibe los tokens OAuth2 proporcionados por Cronofy para utilizarlos posteriormente en la gestión de las interacciones con el calendario.

Permisos y privacidad de los datos

La privacidad y la seguridad de los datos son fundamentales en la integración de Beamery con Cronofy. Nos adherimos al principio de privilegio mínimo, garantizando que solo se concedan los permisos necesarios para realizar acciones específicas. Comprender cómo se gestionan los permisos y cómo se tratan los datos de los usuarios es crucial al interactuar con la API de Cronofy.

Tipos de eventos: Partner Events frente a External Events

Cronofy distingue entre dos tipos de eventos para ofrecer un control más granular de los permisos:

• Partner Events: son eventos creados o gestionados por Beamery en nombre del usuario. Por ejemplo, cuando un usuario programa una reunión a través de Beamery, este evento se creará en el calendario conectado del usuario y se categorizará como Partner Event.
• External Events: estos eventos son creados directamente por el usuario en su propio calendario. Pueden incluir reuniones personales, recordatorios o cualquier evento añadido manualmente al calendario por el usuario.

Al tratar Partner Events y External Events por separado, Cronofy permite a Beamery solicitar únicamente los permisos necesarios para facilitar la experiencia del usuario. Esto garantiza que Beamery acceda solo a los datos del calendario necesarios para funcionar, sin exponer ni modificar innecesariamente eventos privados.

Para obtener información más detallada sobre los permisos, consulte la documentación de Cronofy sobre permisos.

¿Qué ámbitos de Graph utiliza Cronofy?

Al integrarse con servicios de Microsoft (Exchange, Office 365), Cronofy utiliza la API de Graph de Microsoft para acceder a los datos de los usuarios, incluidos los eventos del calendario.

Cronofy solicita los siguientes ámbitos cuando los usuarios conectan sus calendarios:

• User.Read: concede acceso a información básica del perfil, como el nombre y la dirección de correo electrónico del usuario. Esto es necesario para que Cronofy actúe en nombre del usuario.
• Calendars.ReadWrite: permite a Cronofy crear, leer, actualizar y eliminar eventos en el calendario del usuario.

Estos permisos permiten a Beamery ofrecer funciones completas de sincronización del calendario y programación de reuniones, al tiempo que garantizan que el acceso se limite únicamente a los datos pertinentes.

'Se necesita la aprobación del administrador' durante la autorización del calendario

Cuando los usuarios de Office 365 intentan conectar su calendario a través de Beamery, pueden encontrarse con el mensaje «Se necesita la aprobación del administrador». Esto ocurre cuando el administrador de TI del usuario ha habilitado la «Configuración del consentimiento del usuario» en Microsoft 365, bloqueando el acceso de aplicaciones que no son de Microsoft a los datos de los usuarios.

Por qué ocurre

Cronofy requiere que se instale una aplicación en el inquilino de Office 365 para funcionar correctamente. Esta aplicación facilita la integración entre Cronofy y los servicios de Microsoft 365, pero cuando el «Consentimiento del usuario» está restringido, los usuarios finales verán un aviso para obtener la aprobación del administrador para la aplicación de Cronofy.

Qué hacer a continuación

Si esto ocurre, envíe una solicitud de soporte de Beamery. Proporcionaremos el enlace necesario para que el administrador apruebe la aplicación de Cronofy. Hasta que el administrador instale la aplicación, la función Meeting Scheduler no funcionará para los usuarios de Office 365.

Una vez instalada la aplicación, los administradores pueden restringir el acceso adicionalmente a funciones específicas según sea necesario, garantizando que solo se concedan los permisos necesarios.