---
title: MS OneCalendar
slug: ms-onecalendar
docTags: 
createdAt: 2025-07-03T03:49:29.490Z
---

## Objetivo/Resumo

Este conector foi desenvolvido para facilitar a integração e a automação de tarefas com o Microsoft Calendar (Outlook). Seu objetivo principal é proporcionar aos usuários uma maneira eficiente de criar, consultar, atualizar e excluir eventos de calendário diretamente a partir de outras aplicações e serviços. Com esse conector, é possível automatizar rotinas de agendamento, evitar conflitos de horários e integrar compromissos com fluxos de trabalho empresariais.

:::hint{type="info"}
Recomendação: Para detalhes técnicos completos sobre permissões, endpoints e payloads do Microsoft Calendar, acesse a [documentação oficial da Microsoft Calendar ](https://learn.microsoft.com/pt-br/graph/outlook-calendar-concept-overview)
:::

## Criando um fluxo utilizando o Conector Microsoft Calendar

Para criar um fluxo utilizando o conector Microsoft Calendar, é necessário criar uma conexão e, em seguida, configurar os passos desejados dentro do fluxo.

### Criando conexão com o Microsoft Calendar

1. Acesse seu aplicativo no **Microsoft Azure Portal**.
2. Adicione a URI de redirecionamento da Fluid à sua aplicação:

:::BlockQuote
[https://console.fluidapi.io](https://console.fluidapi.io)
:::

1. Para mais detalhes sobre como configurar o redirecionamento, consulte a [documentação oficial da Microsoft](https://learn.microsoft.com/en-us/entra/identity-platform/how-to-add-redirect-uri).
2. Em seguida, crie a conexão na plataforma **Fluid**, preenchendo os seguintes campos:

- **Nome**: Identificador da conexão (campo obrigatório).
- **Descrição**: Detalhe opcional sobre o propósito da conexão.
- **ID do Cliente**: `client_id` da aplicação registrada no Azure.
- **Chave Secreta do Cliente**: `client_secret` da aplicação.
- **Escopos**: Escopos de acesso recomendados:
- `Calendars.ReadWrite`
- `offline_access`
- `User.Read`

Após o preenchimento, clique em **Login OAuth2**, faça a autenticação com a conta Microsoft desejada e salve a conexão.

## Configurando fluxo com Microsoft Calendar

Crie um fluxo e adicione o conector Microsoft Calendar ao canvas.

![](https://api.archbee.com/api/optimize/d8nzUgBNtMWHFCNizsS7h/MW_auAKe24DHe-14W5Xxa_image.png)

Na aba **Parametrização**, configure os seguintes parâmetros:

- **Recurso**: Tipo de entidade a ser manipulada (ex: `Evento`).
- **Operação**: Ação a ser realizada para o recurso selecionado.

### Operações disponíveis

- **Criar evento na agenda**: Cria um novo compromisso no calendário.
  - **Data de Início do Evento** \*(obrigatório). \*Data em que o evento começa.
    **Formato esperado:** `dd-MM-yyyy`
    **Exemplo:** 30-10-2023
  - **Hora de Início do Evento** \*(obrigatório). \*Hora exata de início do evento.
    **Formato esperado:** `HH:mm:ss`
    **Exemplo:** 13:15:00
  - **Duração do Evento** \*(obrigatório). \*Duração do evento em minutos.
    **Exemplo:** 60 (representa 1 hora)
  - **TimeZone do Local do Evento** \*(obrigatório). \*Fuso horário correspondente ao local do evento. Isso garante que o horário seja interpretado corretamente no calendário.
    **Exemplo:** America/Sao\_Paulo
  - **Descrição** \*(opcional). \*Espaço para detalhar o evento. Pode conter a pauta da reunião, links úteis, orientações ou observações gerais.
  - **Sensibilidade** \*(opcional). \*Define o nível de visibilidade do evento no calendário.
    Opções comuns:
    - `Normal`: visível para todos
    - `Privado`: visível apenas para você
    - `Confidencial`: restrito a permissões específicas
    - `Personal`: Identifica o evento como pessoal, mesmo em ambiente corporativo. Pode ser usado para compromissos não relacionados ao trabalho (ex: médico, pessoal, familiar).
  - **Adicionar alerta ao evento** \*(opcional). \*Permite configurar um lembrete para o evento. Pode ser usado para enviar uma notificação (popup, e-mail, etc.) minutos antes do início.

Na aba **Propriedades**, selecione a conexão desejada, dê um nome ao passo e adicione uma descrição se necessário.

## Na prática

Vamos criar um fluxo de exemplo para gerar um evento na agenda do onecalendar:

### Passo criar-agenda

Assim ficará a `Parametrização` do nosso unico passo:

::Image[]{src="https://api.archbee.com/api/optimize/d8nzUgBNtMWHFCNizsS7h/XuRVSQYLfaxhIp-AICxWm_image.png" size="60" width="337" height="779" position="center" showCaption="false"}

Na aba `Propriedades` informamos o nome do passo e a conexão criada para o Microsoft OneCalendar:

::Image[]{src="https://api.archbee.com/api/optimize/d8nzUgBNtMWHFCNizsS7h/FwOFydrNUo96-yCaftguS_image.png" size="60" width="425" height="685" position="center" showCaption="false"}

### Disparando o Fluxo

Com o passo configurado basta disparar o fluxo. Nesse caso não precisaremos informar um payload de entrada, pois os dados que estamos usando no exemplo estão fixos no conector. Após o disparo, o resultado do fluxo será apresentado em tempo real no canvas:

![](https://api.archbee.com/api/optimize/d8nzUgBNtMWHFCNizsS7h/iSl4vrXstDqBWE_jGZurl_image.png)