Conector do Microsoft Calendar

::: (info) () Para fazer o download do aplicativo, visite: Biblioteca::::

Integração com a API Graph da Microsoft para Calendário

Introdução

A API do Microsoft Calendar permite que os usuários criem, leiam e editem eventos do calendário da Microsoft com o acesso correto definido para suas contas M365. O objetivo desse conector é integrar a Tulip com a Microsoft usando a API Graph da Microsoft (v1.0) usando conectores HTTP e fornecer aos nossos clientes um conector pronto para uso que pode ser importado para sua instância.

Objetivo

Destacaremos diferentes funções de conector que podem ser criadas por meio de chamadas HTTP para a Graph Api (v1.0) da Microsoft para interagir com os eventos do Microsoft Calendar e mostrar várias ações de leitura e gravação no calendário que podem ser aproveitadas para vários casos de uso.

Documento da API

Documentação da API do Microsoft Graph

Pré-requisitos

1. Criar uma conta no Microsoft 365 e configurar as credenciais do OAuth 2.0 no Microsoft Entra ID.
2. Registre a API com os escopos necessários no portal da Microsoft. Azure - Entra ID

Vídeo de configuração do conector para o Excel:

Você pode seguir as mesmas etapas para configurar o conector de calendário também.

Detalhes da conexão Tulip

As informações a seguir precisariam ser configuradas na seção

Conectores.

1. Em execução: host do conector de nuvem
2. Host: graph.microsoft.com
3. Porta:443
4. TLS: Sim

OAuth 2: A autenticação será transferida para todas as funções do conector

Funções do conector

1) Obter todos os eventos do calendário

Objetivo

Esse conector buscará todos os eventos de calendário do M365 Calendar.

Ponto de extremidade

Chamada HTTP GET para o ponto de extremidade: https://graph.micrsoft.com:443/v1.0/me/events

Entrada necessária

Não são necessárias entradas

Extrator de saída

1. eventID: identificador exclusivo do evento que será usado para executar as outras tarefas.
2. eventSubject: Assunto do evento.
3. eventContent: Conteúdo do evento.
4. eventStartDate: Data e hora de início do evento.
5. eventEndDate: Data e hora de término do evento.
6. eventLocation: Local do evento.
7. eventAttendees: Participantes do evento.
8. eventOrganizer: Organizador do evento.
9. Os parâmetros adicionais que são retornados com a resposta são incluídos como parte dos parâmetros de saída.

2) Obter agenda de reuniões do usuário

Objetivo

Esse conector obterá as informações de disponibilidade livre/ocupado de um conjunto de usuários, listas de distribuição ou recursos (salas ou equipamentos) para um período de tempo especificado.

Ponto de extremidade

Chamada HTTP GET para o ponto de extremidade -https://graph.microsoft.com:443/v1.0/me/calendar/getSchedule

Entrada obrigatória

A seguir estão os parâmetros que devem ser passados no corpo da solicitação

1. Endereço de e-mail: Uma coleção de endereços SMTP de usuários, listas de distribuição ou recursos para os quais se deseja obter informações de disponibilidade.
2. Schedule Start Date Time: a data, a hora e o fuso horário em que o período começa.
3. Schedule End Date Time: Data, hora e fuso horário em que o período termina.
4. Fuso horário: Fuso horário do evento.

Extrator de saída

1. scheduleUserId: Endereço de e-mail do usuário da agenda.
2. startTime: a data, a hora e o fuso horário em que o período começa.
3. endTime: A data, a hora e o fuso horário em que o período termina.
4. timeZone: fuso horário.
5. scheduleStatus: Status de resposta das programações do usuário.
6. scheduleSubject: Assunto do evento programado.
7. scheduleLocation: Local do evento agendado.
8. scheduleStartDateTime: Hora da data de início do evento agendado.
9. scheduleEndDateTime: Data e hora de término do evento agendado.

3) Criar um evento

Objetivo

1. Os usuários podem passar um Event Subject (assunto do evento), Content (conteúdo), Start date-time (data de início), End date time (data de término) e outros parâmetros como entrada e a Tulip criará um novo evento de calendário com as entradas fornecidas. A resposta da API será os metadados e várias propriedades do evento de calendário. Isso pode ser usado posteriormente para buscar e atualizar eventos.
2. Esse conector pode criar um evento no calendário padrão do usuário ou no calendário especificado para um usuário específico, um usuário de grupo ou vários usuários.
3. As informações são extraídas da API do Microsoft Graph V1.0 e podem ser usadas em aplicativos Tulip, tabelas Tulip ou variáveis Tulip que seriam canalizadas para outras funções do conector.

Ponto final

Chamada HTTP POST para o endpoint: https://graph.microsoft.com:443/v1.0/me/events

Entrada obrigatória

A seguir estão os parâmetros que devem ser passados no corpo da solicitação

1. Event Subject (Assunto do evento): Assunto do evento
2. Event Content (Conteúdo do evento): Conteúdo do evento
3. Event Start Date Time (Data e hora de início do evento): Data e hora de início do evento
4. Fuso horário do evento: Fuso horário do evento
5. Event End Date Time (Data e hora de término do evento): Data e hora de término do evento
6. Local do evento: Local do evento
7. Endereço de e-mail do participante: Endereço de e-mail do participante

Extrator de saída

1. eventId: ID do evento criado
2. eventTimezone: Fuso horário do evento
3. eventSubject: Assunto do evento
4. eventBody: Conteúdo do evento
5. eventStartDateTime: data e hora de início do evento
6. eventEndDateTime: data e hora de término do evento
7. eventLocation: Local do evento
8. Os parâmetros adicionais que são retornados com a resposta são incluídos como parte dos parâmetros de saída.

4) Criar eventos recorrentes

Objetivo

1. Os usuários podem passar um Event Subject (assunto do evento), Content (conteúdo), Start date-time (data de início), End date time (data de término) e outros parâmetros como entrada e a Tulip criará um novo evento de calendário recorrente com as entradas fornecidas. A resposta da API será os metadados e várias propriedades do evento de calendário. Isso pode ser usado posteriormente para buscar e atualizar eventos.
2. Esse conector criará um evento recorrente no calendário padrão do usuário e no calendário especificado para um usuário ou um grupo de usuários.
3. As informações são extraídas da API do Microsoft Graph V1.0 e podem ser usadas em aplicativos Tulip, tabelas Tulip ou variáveis Tulip que seriam canalizadas para outras funções do conector.

Ponto final

Chamada HTTP POST para o endpoint https://graph.microsoft.com:443/v1.0/me/events

Entrada obrigatória

A seguir estão os parâmetros que devem ser passados no corpo da solicitação

1. Event Subject (Assunto do evento): Assunto do evento
2. Event Content (Conteúdo do evento): Conteúdo do evento
3. Event Start Date Time (Data e hora de início do evento): Data e hora de início do evento
4. Fuso horário do evento: Fuso horário do evento
5. Event End Date Time (Data e hora de término do evento): Data e hora de término do evento
6. Local do evento: Local do evento
7. Endereço de e-mail do participante: Endereço de e-mail do participante
8. Tipo de evento de recorrência: Tipo de evento de recorrência
9. Dias da semana da recorrência: Dia do evento de recorrência
10. Data de início da recorrência: Data de início do evento de recorrência
11. Data de término da recorrência: Data de término do evento de recorrência

Extrator de saída

1. eventId: ID do evento criado
2. eventTimezone: Fuso horário do evento
3. eventSubject: Assunto do evento
4. eventBody: Conteúdo do evento
5. eventStartDateTime: data e hora de início do evento
6. eventEndDateTime: Data e hora de término do evento
7. eventLocation: Local do evento
8. eventRecurrenceRangeStartDate: Data de início do evento de recorrência.
9. eventRecurrenceRangeEndDate: data de início do evento de recorrência: Data de término do evento de recorrência.
10. eventAttendees: Participantes do evento.
11. eventOrganizer: Organizador do evento.
12. Parâmetros adicionais que são retornados com a resposta são incluídos como parte dos parâmetros de saída.

5) Atualizar um evento

Objetivo

1. Os usuários podem passar um ID de evento, assunto, conteúdo e outros parâmetros como entrada e a Tulip atualizará os eventos no calendário. A resposta da API será os metadados e várias propriedades dos eventos do calendário.
2. As informações são extraídas da API do Microsoft Graph V1.0 e podem ser usadas em aplicativos Tulip, tabelas Tulip ou variáveis Tulip que seriam canalizadas para outras funções do conector.

Ponto de extremidade

Chamada HTTP PATCH para o endpoint https://graph.microsoft.com:443/v1.0/me/events/{eventID}

Entrada obrigatória

Os parâmetros a seguir são enviados como corpo da solicitação

1. Event Subject (Assunto do evento): Assunto do evento
2. Event Content (Conteúdo do evento): Conteúdo do evento
3. Event Start Date Time (Hora da data de início do evento): Hora da data de início do evento
4. Event TimeZone (fuso horário do evento): fuso horário do evento
5. Event End Date Time (Hora da data de término do evento): Hora da data de término do evento
6. Event Location (Localização do evento): Local do evento
7. Endereço de e-mail do participante: Endereço de e-mail do participante

Extrator de saída

1. eventId: ID do evento criado
2. eventTimezone: Fuso horário do evento
3. eventSubject: Assunto do evento
4. eventBody: Conteúdo do evento
5. eventStartDateTime: data e hora de início do evento
6. eventEndDateTime: data e hora de término do evento
7. eventLocation: Local do evento
8. Parâmetros adicionais que são retornados com a resposta são incluídos como parte dos parâmetros de saída.

6) Excluir um evento

Objetivo

1. Os usuários podem passar um ID de evento como entrada e o Tulip excluirá o evento do calendário.

Ponto final

Chamada HTTP DELETE para o ponto de extremidade - https://graph.microsoft.com:443/v1.0/me/events/{eventID}

Entrada obrigatória

A seguir estão os parâmetros que são enviados como corpo da solicitação

1. Event ID - O ID do evento

Leitura adicional

Confira mais informações sobre os conectores da Microsoft

• Conector do Microsoft Outlook
• Conector do Microsoft Teams
• Conector do Microsoft Excel