> For the complete documentation index, see [llms.txt](https://help.hyperflow.global/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.hyperflow.global/docs/builder-hyperflow/gerenciamento-de-aplicativos/fluxos/integracao/google-calendar.md).

# Google calendar

O módulo **Google Calendar** permite inserir um evento na sua agenda do Google, ou verificar quais horários estão disponíveis em um período, sem sair do fluxo. É útil para agendar reuniões automaticamente ou oferecer horários livres para o cliente escolher.

## 🧭 Como acessar

1. No menu lateral, clique em **Gerenciamento de aplicativos**.
2. Em seguida, clique em **Fluxos**.
3. Abra ou crie um fluxo e acesse a área de trabalho do fluxo.
4. No painel de módulos, localize a categoria **Integração** (identificada pela cor azul).
5. Arraste o módulo **Google Calendar** para a área de trabalho do fluxo.

{% hint style="warning" %}
Diferente de outros módulos de integração, o Google Calendar não usa uma credencial cadastrada previamente em **Integrações** — cada módulo Google Calendar tem seu próprio login com uma conta Google.
{% endhint %}

## 🔍 Conhecendo o módulo

Ao clicar duas vezes no módulo na área de trabalho do fluxo, um painel de configuração é aberto na lateral da tela.

### 🔑 Fazer login com o Google

Ao adicionar o módulo, você verá um botão para entrar com sua conta Google. Faça login e autorize o acesso à sua agenda.

### 📆 Selecionar o calendário

Depois de fazer login, selecione qual calendário da sua conta Google será usado.

### 🧩 Método

Escolha o que o módulo vai fazer:

* **Inserir evento** — cria um novo evento no calendário selecionado.
* **Listar eventos** — na verdade, verifica a disponibilidade do calendário em um período, indicando quais horários estão livres ou ocupados (não retorna a lista de eventos cadastrados).

### ➕ Inserir evento

| Campo                              | O que preencher                                            |
| ---------------------------------- | ---------------------------------------------------------- |
| **Título do evento**               | Nome do evento na agenda                                   |
| **Descrição**                      | Detalhes adicionais do evento (opcional)                   |
| **Data/hora de início**            | Quando o evento começa                                     |
| **Data/hora de término**           | Quando o evento termina                                    |
| **Participantes**                  | E-mails que devem ser convidados                           |
| **Enviar notificações por e-mail** | Envia convite/aviso por e-mail aos participantes           |
| **Criar link do Google Meet**      | Gera automaticamente um link de videochamada para o evento |

{% hint style="warning" %}
Preencha sempre o **Título do evento** e os **Participantes**, mesmo que a tela não impeça salvar sem eles — um evento sem título ou sem convidados pode ser criado sem aviso.
{% endhint %}

### 🕓 Verificar disponibilidade (Listar eventos)

Esta opção calcula os horários livres e ocupados do calendário dentro de um período, em vez de retornar a lista de eventos cadastrados.

| Campo                                | O que preencher                                                                                                                        |
| ------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------- |
| **Data de início / Data de término** | Período a ser analisado (recomendado no máximo uma semana)                                                                             |
| **Considerar**                       | Quais tipos de compromisso contam como ocupado: cancelados, agendados, não agendados ou todos                                          |
| **Horários específicos**             | Dias da semana e faixas de horário (de/até) a considerar na verificação — se não configurado, o módulo usa um horário comercial padrão |

{% hint style="warning" %}
Se você não configurar **Horários específicos**, o módulo usa um horário padrão fixo (aproximadamente 09h às 18h, horário de Brasília) para calcular a disponibilidade, independentemente do fuso horário configurado no seu calendário. Configure sempre os horários específicos se sua operação usa outro fuso horário ou outro horário comercial.
{% endhint %}

### 🔀 Saídas do módulo

O módulo tem duas saídas:

* **Sucesso** — o evento foi criado, ou a verificação de disponibilidade foi concluída.
* **Erro** — não foi possível concluir a operação (por exemplo, sessão do Google expirada, calendário não encontrado, ou dados inválidos).

## 💡 Caso de uso

**Cenário:** uma empresa quer que o chatbot agende automaticamente uma reunião assim que o cliente confirmar um horário.

**Configuração:**

1. Adicione o módulo **Google Calendar** ao fluxo, no ponto em que o horário já foi confirmado pelo cliente.
2. Faça login com a conta Google da empresa e selecione o calendário correspondente.
3. Escolha o método **Inserir evento**.
4. Preencha **Título do evento** com `Reunião com {{user.name}}`, e as datas de início e término com o horário confirmado.
5. Em **Participantes**, adicione o e-mail do cliente, se disponível.
6. Conecte a saída **Sucesso** para confirmar o agendamento ao cliente.

**Resultado:** a reunião é criada automaticamente na agenda da empresa, com o cliente convidado por e-mail.

## 📌 Dicas úteis

* Se a conexão com o Google parar de funcionar (por exemplo, após revogar o acesso ou trocar a senha da conta), será necessário refazer o login no módulo.
* No método **Listar eventos**, lembre-se de que o resultado é sobre disponibilidade (livre/ocupado), não uma lista dos eventos já cadastrados na agenda.
* Configure sempre os **Horários específicos** ao verificar disponibilidade, para não depender do horário padrão fixo do módulo.
* Mantenha o período de verificação de disponibilidade curto (até uma semana) para obter um resultado mais rápido e organizado.

## 📝 Resumo

* O módulo **Google Calendar** insere eventos ou verifica disponibilidade de horários na sua agenda do Google.
* Cada módulo tem seu próprio login com uma conta Google — não usa a tela central de Integrações.
* O método **Listar eventos** calcula disponibilidade (livre/ocupado), não retorna a lista de eventos cadastrados.
* Sem configurar horários específicos, a verificação de disponibilidade usa um horário comercial padrão fixo.
* O módulo tem uma saída de **Sucesso** e uma de **Erro**.