Conecta-seEntrar na plataforma

Google Calendar

Criar, consultar e atualizar eventos, disponibilidade e convites no Google Agenda.

Integrações e ferramentasProdutividade e controle do fluxoConexão: OAuth

O que faz

Integra o Google Calendar ao fluxo. Cria, lê, atualiza e lista eventos da agenda.

Quando usar: Use quando o seu fluxo precisar criar, consultar e atualizar eventos, disponibilidade e convites no Google Agenda.

Exemplo de situação: Organizar o processo e encaminhar cada caso para a etapa certa.

Antes de começar

Conexão necessária: OAuth.

Conecte a conta pelo botão de autorização do campo de credencial e confira qual usuário ou organização foi escolhido.

Passo a passo

  1. Adicione Google Calendar ao desenho a partir da aba Blocos e ligue a entrada dele à etapa anterior.
  2. Conecte a conta pelo botão de autorização do campo de credencial e confira qual usuário ou organização foi escolhido.
  3. Escolha a operação. O painel mostra só os campos que essa operação usa.
  4. Preencha os campos obrigatórios. Para usar um dado de uma etapa anterior, digite < e escolha o bloco e o campo.
  5. Clique em Executar com dados de teste e confira, no terminal, o que entrou e o que saiu do bloco.
  6. Só publique depois de conferir o resultado da execução de teste.

Para configurar o gatilho

  1. Conecte a sua conta do Google com uma credencial OAuth
  2. Selecione a agenda a monitorar (por padrão, a sua agenda principal)
  3. O sistema detecta automaticamente eventos novos, atualizados e cancelados

Operações

OperaçãoO que faz
Criar eventoCria evento com o bloco Google Calendar.
Listar eventosLista eventos com o bloco Google Calendar.
Obter eventoObtém evento com o bloco Google Calendar.
Atualizar eventoAtualiza evento com o bloco Google Calendar.
Excluir eventoExclui evento com o bloco Google Calendar.
Mover eventoMove evento com o bloco Google Calendar.
Obter ocorrências de evento recorrenteObtém ocorrências de evento recorrente com o bloco Google Calendar.
Listar agendasLista agendas com o bloco Google Calendar.
Criar evento rápido (linguagem natural)Cria evento rápido (linguagem natural) com o bloco Google Calendar.
Convidar participantesConvida participantes com o bloco Google Calendar.
Verificar disponibilidadeVerifica disponibilidade com o bloco Google Calendar.
Criar agendaCria agenda com o bloco Google Calendar.
Compartilhar agendaCompartilha agenda com o bloco Google Calendar.
Listar compartilhamentosLista compartilhamentos com o bloco Google Calendar.
Remover compartilhamentoRemove compartilhamento com o bloco Google Calendar.

Campos

Mostrar campos de

  • Operação

    Escolhe qual ação este bloco executará.

    Opções:
    Criar evento · Listar eventos · Obter evento · Atualizar evento · Excluir evento · Mover evento · Obter ocorrências de evento recorrente · Listar agendas · Criar evento rápido (linguagem natural) · Convidar participantes · Verificar disponibilidade · Criar agenda · Compartilhar agenda · Listar compartilhamentos · Remover compartilhamento
    Padrão:
    Criar evento

  • Conta do Google Calendar

    Obrigatório

    Seleciona a conta já conectada que autoriza o acesso ao serviço.

    Exemplo:
    (escolha a conta conectada)

  • Conta do Google Calendar

    ObrigatórioEm campos adicionais

    Informa manualmente a credencial usada pela integração no modo avançado.

  • Conta representada

    E-mail do usuário a representar (para contas de serviço).

    Exemplo:
    cliente@exemplo.com

  • Agenda

    Selecione a agenda.

    Quando aparece:
    Quando o campo “Operação” for diferente de “Listar agendas” ou “Criar agenda” ou “Verificar disponibilidade”
    Exemplo:
    primary

  • ID da agenda

    Em campos adicionais

    Informe o ID da agenda (ex.: primary ou agenda@gmail.com).

    Quando aparece:
    Quando o campo “Operação” for diferente de “Listar agendas” ou “Criar agenda” ou “Verificar disponibilidade”
    Exemplo:
    id-do-recurso

  • Título do evento

    Obrigatório conforme a operação

    Reunião com a equipe.

    Aparece em:
    Criar evento
    Exemplo:
    Reunião com a equipe

  • Descrição

    Descrição do evento.

    Aparece em:
    Criar evento
    Exemplo:
    Descrição do evento

  • Local

    Sala de reunião A.

    Aparece em:
    Criar evento
    Exemplo:
    Sala de reunião A

  • Data e hora de início

    Obrigatório conforme a operação

    Define a data, o horário ou a programação usada pela operação.

    Aparece em:
    Criar evento
    Exemplo:
    2026-09-15

  • Data e hora de término

    Obrigatório conforme a operação

    Define a data, o horário ou a programação usada pela operação.

    Aparece em:
    Criar evento
    Exemplo:
    2026-09-15

  • Participantes (e-mails separados por vírgula)

    E-mails das pessoas que serão convidadas para o evento, separados por vírgula (ex.: joao@minhaempresa.com.br, maria@minhaempresa.com.br).

    Aparece em:
    Criar evento
    Exemplo:
    .com, maria@exemplo.com

  • Regra de recorrência

    Em campos adicionais

    Regra de repetição do evento no padrão RRULE (ex.: RRULE:FREQ=WEEKLY;BYDAY=MO,WE,FR repete toda segunda, quarta e sexta); deixe vazio para um evento único.

    Aparece em:
    Criar evento, Atualizar evento
    Exemplo:
    RRULE:FREQ=WEEKLY;BYDAY=MO,WE,FR

  • Fuso horário

    Em campos adicionais

    Define a data, o horário ou a programação usada pela operação.

    Aparece em:
    Criar evento, Atualizar evento
    Exemplo:
    09:00

  • Início do período

    Define a data, o horário ou a programação usada pela operação.

    Aparece em:
    Listar eventos
    Exemplo:
    09:00

  • Fim do período

    Define a data, o horário ou a programação usada pela operação.

    Aparece em:
    Listar eventos
    Exemplo:
    09:00

  • Consulta de busca

    Texto livre para filtrar os eventos da agenda, procurado no título, na descrição, no local e nos participantes (ex.: reunião diária).

    Aparece em:
    Listar eventos
    Exemplo:
    reunião diária

  • Ordenar por

    Em campos adicionais

    Escolhe uma das opções aceitas por este campo.

    Aparece em:
    Listar eventos
    Opções:
    Horário de início · Última atualização
    Padrão:
    Horário de início

  • Token da página

    Em campos adicionais

    Token de uma resposta anterior (nextPageToken).

    Aparece em:
    Listar eventos, Obter ocorrências de evento recorrente, Listar agendas, Listar compartilhamentos
    Exemplo:
    Token de uma resposta anterior (nextPageToken)

  • ID do evento

    Obrigatório conforme a operação

    ID do evento.

    Aparece em:
    Obter evento, Atualizar evento, Excluir evento, Mover evento, Obter ocorrências de evento recorrente, Convidar participantes
    Exemplo:
    id-do-recurso

  • Agenda de destino

    Obrigatório conforme a operação

    Selecione a agenda de destino.

    Aparece em:
    Mover evento
    Exemplo:
    (escolha na lista do campo)

  • ID da agenda de destino

    Obrigatório conforme a operaçãoEm campos adicionais

    Informa o identificador exato do recurso na plataforma conectada.

    Aparece em:
    Mover evento
    Exemplo:
    id-do-recurso

  • Máximo de resultados

    Define um valor numérico, quantidade ou limite da operação.

    Aparece em:
    Listar eventos, Obter ocorrências de evento recorrente, Listar agendas, Listar compartilhamentos
    Exemplo:
    10

  • Nível mínimo de acesso

    Escolhe uma das opções aceitas por este campo.

    Aparece em:
    Listar agendas
    Opções:
    Qualquer nível · Ver disponibilidade · Leitor · Editor · Proprietário
    Exemplo:
    Qualquer nível

  • Substituir participantes atuais

    Define se este comportamento fica ativado ou desativado.

    Aparece em:
    Convidar participantes
    Opções:
    Adicionar aos participantes atuais · Substituir todos os participantes
    Exemplo:
    Adicionar aos participantes atuais

  • Evento em linguagem natural

    Obrigatório conforme a operação

    Informa o texto que será processado pelo bloco.

    Aparece em:
    Criar evento rápido (linguagem natural)
    Exemplo:
    Olá! Sua solicitação foi processada com sucesso.

  • Agendas (IDs separados por vírgula)

    Obrigatório conforme a operação

    Agendas cuja disponibilidade será verificada, separadas por vírgula: use primary para a agenda principal da conta e o e-mail de um colega para a agenda dele (ex.: primary, maria@minhaempresa.com.br).

    Aparece em:
    Verificar disponibilidade
    Exemplo:
    .com

  • Nível de acesso

    Obrigatório conforme a operação

    Escolhe uma das opções aceitas por este campo.

    Aparece em:
    Compartilhar agenda
    Opções:
    Ver só a disponibilidade · Ver todos os detalhes dos eventos (Leitor) · Fazer alterações (Editor) · Fazer alterações e gerenciar o compartilhamento (Proprietário)
    Padrão:
    Ver todos os detalhes dos eventos (Leitor)
    Exemplo:
    Ver só a disponibilidade

  • Compartilhar com

    Obrigatório conforme a operação

    Escolhe uma das opções aceitas por este campo.

    Aparece em:
    Compartilhar agenda
    Opções:
    Usuário · Grupo · Domínio · Público (qualquer pessoa)
    Padrão:
    Usuário

  • Quem recebe o acesso (e-mail ou domínio)

    Obrigatório conforme a operação

    E-mail da pessoa, ou domínio da empresa, que vai receber acesso à agenda compartilhada (ex.: maria@minhaempresa.com.br ou minhaempresa.com.br).

    Aparece em:
    Compartilhar agenda
    Exemplo:
    150.00

  • Enviar e-mail de notificação

    Em campos adicionais

    Define se este comportamento fica ativado ou desativado.

    Aparece em:
    Compartilhar agenda
    Opções:
    Sim · Não
    Padrão:
    Sim

  • ID da regra de acesso (ACL)

    Obrigatório conforme a operação

    Informa o identificador exato do recurso na plataforma conectada.

    Aparece em:
    Remover compartilhamento
    Exemplo:
    id-do-recurso

  • Enviar notificações por e-mail

    Define a data, o horário ou a programação usada pela operação.

    Aparece em:
    Criar evento, Atualizar evento, Excluir evento, Mover evento, Criar evento rápido (linguagem natural), Convidar participantes
    Opções:
    Todos os participantes · Só participantes externos · Nenhum (não envia e-mails)
    Exemplo:
    Todos os participantes

Saídas

Para usar um resultado deste bloco em uma etapa seguinte, digite < no campo e escolha o bloco e o campo. A referência tem o formato <googlecalendar.content>: antes do ponto vai o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.

ReferênciaTipoO que contém
<googlecalendar.content>stringConteúdo da resposta da operação.
<googlecalendar.metadata>jsonMetadados do evento ou da agenda.
<googlecalendar.items>jsonLista de eventos retornada por Listar eventos (array). Uma lista vazia significa que não há eventos no período.
<googlecalendar.nextPageToken>stringPróxima página; se presente, ainda há eventos para consultar.
<googlecalendar.id>stringIdentificador do evento nas operações de criar/obter/atualizar.
<googlecalendar.htmlLink>stringLink do evento no Google Agenda.

Exemplo de uso

Objetivo: Organizar o processo e encaminhar cada caso para a etapa certa.

InícioGoogle Calendarpróxima etapa
Operação
Criar evento
Conta do Google Calendar
(escolha a conta conectada)
Conta representada
cliente@exemplo.com
Agenda
primary
Título do evento
Reunião com a equipe
Descrição
Descrição do evento

Os valores são ilustrativos. Teste primeiro com dados fictícios ou de homologação.

Erros comuns e como resolver

O bloco não executa
Confira se existe um caminho de setas que parte do gatilho (ou do Início) até este bloco. Blocos soltos no desenho são ignorados.
Aparece “Validação do fluxo” no terminal
Há campo obrigatório vazio. Clique no aviso, abra o bloco indicado e preencha o campo marcado.
Um campo chega vazio na etapa seguinte
Confira se a referência aponta para um bloco que já executou e para um campo que existe, como <googlecalendar.content>. O nome antes do ponto é o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
O campo que eu procuro não aparece
Os campos mudam conforme a operação escolhida. Escolha a operação primeiro; campos menos usados ficam em “Mostrar campos adicionais”.
Erro de autorização ou permissão (401/403)
A conta conectada perdeu o acesso ou não tem permissão para esta operação. Reconecte a conta no campo de credencial e confirme as permissões pedidas.
O serviço recusou a chamada ou devolveu erro
Leia a mensagem no terminal: ela traz o motivo informado pelo serviço. Confira IDs, limites de uso e permissões, e teste antes com um recurso de homologação.

Blocos relacionados