Conector del calendario de Microsoft

::: (info) () Para descargar la aplicación, visite: Biblioteca:::

Integración con Graph API de Microsoft para Calendario

Introducción

Microsoft Calendar API permite a los usuarios crear, leer y editar eventos del calendario de Microsoft con el acceso adecuado a sus cuentas M365. El objetivo de este conector es integrar Tulip con Microsoft utilizando Graph API de Microsoft (v1.0) utilizando conectores HTTP y proporcionar a nuestros clientes un conector listo para usar que se puede importar en su instancia.

Propósito

Vamos a destacar diferentes funciones de conectores que se pueden construir haciendo llamadas HTTP a Graph Api(v1.0) de Microsoft para interactuar con los eventos de Microsoft Calendar para mostrar varias acciones de lectura y escritura en el calendario que podrían ser aprovechadas para diversos casos de uso.

Documentación API

Documentación de la API Graph de Microsoft

Requisitos previos

1. Crear una cuenta en Microsoft 365 y configurar las credenciales OAuth 2.0 en Microsoft Entra ID.
2. Registrar la API con los alcances requeridos en el portal de Microsoft. Azure - Entra ID

Video de configuración del conector para excel:

Puedes seguir los mismos pasos para configurar también el conector de calendario.

Detalles de la conexión de Tulip

La siguiente información necesitaría ser configurada en Tulip's

Conectores.

1. Running On: Cloud Connector Host
2. Host: graph.microsoft.com
3. Puerto:443
4. TLS: Sí

OAuth 2: La autenticación se transmitirá a todas las funciones del conector.

Funciones del conector

1) Obtener todos los eventos del calendario

Propósito

Este conector obtendrá todos los eventos de calendario del Calendario M365.

Punto final

Llamada HTTP GET al punto final: https://graph.micrsoft.com:443/v1.0/me/events

Entrada requerida

No se requieren entradas

Extractor de salida

1. eventID: Identificador único del evento que se utilizará para realizar las demás tareas.
2. eventSubject: Asunto del evento.
3. eventContent: Contenido del evento.
4. eventStartDate: Fecha y hora de inicio del evento.
5. eventEndDate: Fecha y hora de finalización del evento.
6. eventLocation: Lugar del evento.
7. eventAttendees: Asistentes al evento.
8. eventOrganizer: Organizador del evento.
9. Los parámetros adicionales que se devuelven con la respuesta se incluyen como parte de los parámetros de salida.

2) Obtener programa de reuniones de usuarios

Propósito

Este conector obtendrá la información de disponibilidad libre/ocupada de un conjunto de usuarios, listas de distribución o recursos (salas o equipos) para un periodo de tiempo especificado.

Punto final

Llamada HTTP GET al punto final -https://graph.microsoft.com:443/v1.0/me/calendar/getSchedule

Entrada requerida

Los siguientes son los parámetros que deben introducirse en el cuerpo de la solicitud

1. Dirección de correo electrónico: Una colección de direcciones SMTP de usuarios, listas de distribución o recursos de los que obtener información de disponibilidad.
2. Schedule Start Date Time: Fecha, hora y zona horaria de inicio del periodo.
3. Fecha de finalización del horario Hora: Fecha, hora y zona horaria en la que finaliza el periodo.
4. Zona horaria: Zona horaria del evento.

Extractor de salida

1. scheduleUserId: Dirección de correo electrónico del usuario del horario.
2. startTime: Fecha, hora y zona horaria de inicio del periodo.
3. endTime: Fecha, hora y zona horaria en la que finaliza el periodo.
4. timeZone: Zona horaria.
5. scheduleStatus: Estado de respuesta de los horarios del usuario.
6. scheduleSubject: Asunto del evento programado.
7. scheduleLocation: Ubicación del evento programado.
8. scheduleStartDateTime: Hora de inicio del evento programado.
9. scheduleEndDateTime: Hora de finalización del evento programado.

3) Crear un Evento

Propósito

1. Los usuarios pueden pasar un Asunto de Evento, Contenido, Fecha-Hora de Inicio, Fecha-Hora de Fin, y otros parámetros como entrada & Tulip creará un nuevo evento de calendario con las entradas proporcionadas. La respuesta de la API serán los metadatos y varias propiedades del evento de calendario. Esto se puede utilizar para recuperar y actualizar eventos.
2. Este conector puede crear un evento en el calendario por defecto del usuario o en el calendario especificado para un usuario específico o un grupo de usuarios o múltiples usuarios.
3. La información se extrae de la API de Microsoft Graph V1.0 y se puede utilizar en aplicaciones Tulip, tablas Tulip o variables Tulip que se canalizarán a otras funciones del conector.

Punto final

Llamada HTTP POST al punto final: https://graph.microsoft.com:443/v1.0/me/events

Entrada requerida

Los siguientes son los parámetros que deben introducirse en el cuerpo de la solicitud

1. Asunto del evento: Asunto del evento
2. Contenido del evento: Contenido del evento
3. Fecha y hora de inicio del evento: Fecha y hora de inicio del evento
4. Zona horaria del incidente: Zona horaria del incidente
5. Fecha y hora de finalización del incidente: Fecha y hora de finalización del incidente
6. Lugar del incidente: Lugar del acto
7. Dirección de correo electrónico del asistente: Dirección de correo electrónico del asistente

Extractor de salida

1. eventId: ID del evento creado
2. eventTimezone: Zona horaria del evento
3. eventSubject: Asunto del evento
4. eventBody: Contenido del evento
5. eventStartDateTime: Fecha y hora de inicio del evento
6. eventEndDateTime: Fecha y hora de finalización del evento
7. eventLocation: Lugar del evento
8. Los parámetros adicionales que se devuelven con la respuesta se incluyen como parte de los parámetros de salida.

4) Crear eventos recurrentes

Propósito

1. Los usuarios pueden pasar un Asunto de Evento, Contenido, Fecha-Hora de Inicio, Fecha-Hora de Fin, y otros parámetros como entrada & Tulip creará un nuevo evento de calendario recurrente con las entradas proporcionadas. La respuesta de la API serán los metadatos y varias propiedades del evento de calendario. Esto se puede utilizar para recuperar y actualizar eventos.
2. Este conector creará un evento recurrente en el calendario predeterminado del usuario y en el calendario especificado para un usuario o un grupo de usuarios.
3. La información se extrae de la API de Microsoft Graph V1.0 y se puede utilizar en aplicaciones Tulip, tablas Tulip o variables Tulip que se canalizarán a otras funciones del conector.

Punto final

Llamada HTTP POST al punto final https://graph.microsoft.com:443/v1.0/me/events

Entrada requerida

Los siguientes son los parámetros que deben introducirse en el cuerpo de la solicitud

1. Asunto del evento: Asunto del evento
2. Contenido del evento: Contenido del evento
3. Fecha y hora de inicio del evento: Fecha y hora de inicio del evento
4. Zona horaria del incidente: Zona horaria del incidente
5. Fecha y hora de finalización del incidente: Fecha y hora de finalización del incidente
6. Lugar del incidente: Lugar del acto
7. Dirección de correo electrónico del asistente: Dirección de correo electrónico del asistente
8. Recurrencia Tipo de evento: Tipo de evento de recurrencia
9. Recurrencia Días de la semana: Día del evento de recurrencia
10. Fecha de inicio de la repetición: Recurrence event Start Date
11. Recurrence End Date: Fecha de finalización del evento de recurrencia

Extractor de salida

1. eventId: ID del evento creado
2. eventTimezone: TimeZone del evento
3. eventSubject: Asunto del evento
4. eventBody: Contenido del evento
5. eventStartDateTime: Fecha y hora de inicio del evento
6. eventEndDateTime: Fecha y hora de finalización del evento
7. eventLocation: Lugar del evento
8. eventRecurrenceRangeStartDate: Fecha de inicio del evento de recurrencia.
9. eventRecurrenceRangeEndDate: Fecha de finalización del evento.
10. eventAttendees: Asistentes al evento.
11. eventOrganizer: Organizador del evento.
12. Los parámetros adicionales que se devuelven con la respuesta se incluyen como parte de los parámetros de salida.

5) Actualizar un evento

Propósito

1. Los usuarios pueden pasar un ID de evento, asunto, contenido y otros parámetros como entrada y Tulip actualizará los eventos en el calendario. La respuesta de la API serán los metadatos y varias propiedades de los eventos del calendario.
2. La información se extrae de la API de Microsoft Graph V1.0 y se puede utilizar en aplicaciones Tulip, tablas Tulip o variables Tulip que se canalizarán en otras funciones del conector.

Punto final

Llamada HTTP PATCH al punto final https://graph.microsoft.com:443/v1.0/me/events/{eventID}

Entrada requerida

Los siguientes son los parámetros que se envían como el cuerpo de la solicitud

1. Asunto del evento: Asunto del evento
2. Contenido del evento: Contenido del evento
3. Event Start Date Time: Fecha y hora de inicio del evento
4. Zona horaria del incidente: Zona horaria del incidente
5. Event End Date Time: Fecha y hora de finalización del evento
6. Lugar del incidente: Lugar del evento
7. Dirección de correo electrónico del asistente: Dirección de correo electrónico del asistente

Extractor de salida

1. eventId: ID del evento creado
2. eventTimezone: Zona horaria del evento
3. eventSubject: Asunto del evento
4. eventBody: Contenido del evento
5. eventStartDateTime: Fecha y hora de inicio del evento
6. eventEndDateTime: Fecha y hora de finalización del evento
7. eventLocation: Lugar del evento
8. Los parámetros adicionales que se devuelven con la respuesta se incluyen como parte de los parámetros de salida.

6) Eliminar un incidente

Finalidad

1. Los usuarios pueden pasar un ID de evento como entrada y Tulip borrará el evento en el calendario.

Punto final

Llamada HTTP DELETE al punto final - https://graph.microsoft.com:443/v1.0/me/events/{eventID}

Entrada requerida

Los siguientes son los parámetros que se envían como cuerpo de la solicitud

1. Event ID - El ID del evento

Más información

Más información sobre Microsoft Connectors

• Microsoft Outlook Connector
• Microsoft Teams Connector
• Microsoft Excel Connector