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
No menu lateral, clique em Gerenciamento de aplicativos.
Em seguida, clique em Fluxos.
Abra ou crie um fluxo e acesse a área de trabalho do fluxo.
No painel de módulos, localize a categoria Integração (identificada pela cor azul).
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
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.
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:
Adicione o módulo Google Calendar ao fluxo, no ponto em que o horário já foi confirmado pelo cliente.
Faça login com a conta Google da empresa e selecione o calendário correspondente.
Escolha o método Inserir evento.
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.Em Participantes, adicione o e-mail do cliente, se disponível.
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.