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.

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.

🔍 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

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.

🕓 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

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.

🔀 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.