MENU
    Conector del calendario de Microsoft
    • 13 Jan 2025
    • 7 Minutos para leer
    • Colaboradores

    Conector del calendario de Microsoft


    Resumen del artículo

    To download the app, visit: Library

    Integración con Graph API de Microsoft para Calendar

    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:

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

    Detalles de la conexión a 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 puede ser utilizada 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


    ¿Te ha sido útil este artículo?