Fechar reunião ainda na primeira ligação exige consultar agenda e criar evento sem sair do fluxo. No Pipevoz, dois nós nativos (Verificar disponibilidade e Criar evento na agenda) conectam o workflow à Google Agenda da sua conta. Este guia explica pré-requisitos, configuração de cada nó, ordem recomendada no canvas e erros comuns.
Pré-requisito: conectar Google Agenda
Antes de usar os nós, conecte uma conta em Integrações (menu lateral do app). O fluxo OAuth pede permissão para ler disponibilidade e criar eventos na agenda principal do Google.
No editor de workflow, ao selecionar um nó Google Agenda, o painel Conta Google lista a conta conectada. Se ainda não houver nenhuma, aparece aviso com link para Integrações e botão Verificar conexão, útil quando você conectou em outra aba do navegador.
- Uma integração Google ativa por workspace.
- E-mail conectado aparece no select do nó e no card do canvas.
- Desconectar em Integrações invalida nós que referenciavam essa conta.
Onde encontrar os nós no editor
Na paleta Adicionar nó, seção Ações, abra Google Agenda. Há duas opções: Verificar disponibilidade (consulta slots livres) e Criar evento na agenda (grava compromisso).
Os nós usam cor verde no canvas para se distinguir de Pressionar tecla (azul) e Tools (índigo). Eles não possuem toggle de nó global: são ações pontuais no fluxo, não rotas acessíveis de qualquer etapa.
Nó Verificar disponibilidade
Este nó consulta a API freeBusy do Google Calendar. Você configura a conta, a janela de horários (Das / Até) e o fuso horário. Só retorna horários dentro dessa janela, por exemplo das 9h às 18h em America/Sao_Paulo.
As datas são passadas dinamicamente pelo agente durante a ligação (ex.: lead pede "quinta ou sexta"). O agente extrai a data da conversa automaticamente e passa no formato YYYY-MM-DD — não é necessário adicionar um nó Extrair variável só para capturar a data. Use esse nó intermediário apenas se precisar guardar a data como variável para CRM, branch de lógica ou outro sistema fora do calendário. O retorno lista slots livres de uma hora dentro de cada dia consultado. Use um nó Conversa depois para oferecer opções ao lead em linguagem natural.
- Conta Google: select da integração conectada.
- Janela de horários: limite comercial da operação.
- Fuso horário: alinhe com o time que atende a agenda.
- Fala durante execução: opcional ("Consultando a agenda…").
- Não substitui Conversa: o agente ainda precisa negociar qual horário o lead prefere.
Nó Criar evento na agenda
Depois que o lead confirma data e hora, este nó cria o evento na agenda Google. Título e duração são fixos no painel (ex.: "Demo Pipevoz", 30 min). Data e horário exatos vêm da conversa: o agente extrai e passa automaticamente data no formato YYYY-MM-DD e hora no formato HH:MM (24h), sem precisar de nó intermediário de extração. Se a operação precisar registrar esses dados em CRM ou usá-los em branch, aí sim vale um nó Extrair variável antes deste.
Configure o mesmo fuso usado na verificação de disponibilidade para evitar deslocamento de horário. Após criar, encerre com Conversa ou Encerramento confirmando o combinado ("Enviei o convite para quinta às 14h").
- Nome do evento: título que aparece no Google Calendar.
- Duração: 15 min, 30 min, 1 hora, etc.
- Conta Google: mesma usada na consulta de disponibilidade, em geral.
- Confirme verbalmente antes de executar o nó. Evita evento errado.
Fluxo recomendado no canvas
Linha principal sugerida: Conversa (apresentação e interesse) → Conversa (perguntar dias preferidos) → Verificar disponibilidade → Conversa (oferecer 2–3 horários) → Divisão lógica ou Conversa (lead confirmou?) → Criar evento na agenda → Encerramento.
Ramificação importante: se o lead não quer agendar agora, desvie antes dos nós de agenda para retorno genérico, Extrair variável (data de callback) ou Encerramento, sem forçar passagem por Verificar disponibilidade.
- Colete intenção antes de consultar agenda (evita chamadas API desnecessárias).
- Ofereça no máximo três opções por vez, para menos confusão na ligação.
- Recapitule data, hora e duração antes de criar o evento.
- Teste o fluxo com chamada de preview antes de campanha em massa.
Google Agenda vs Tools HTTP
Tools HTTP servem APIs genéricas: CRM, webhook, validação de CNPJ. Google Agenda é integração nativa otimizada para calendário Google, com menos configuração, sem montar endpoint manual e extração automática de data e hora da conversa.
Se sua operação usa só Google Calendar para demos, prefira os nós nativos. Se usa Cal.com, Outlook ou agenda interna, Tools ou webhook pós-ligação podem ser mais adequados até haver integração nativa.
Erros comuns
Publicar agente com nó de agenda sem conta conectada: o card mostra "Nenhuma conta conectada" e a ligação falha na execução. Criar evento antes de confirmar horário com o lead: gera retrabalho e desconfiança. Janela 9h–18h mas lead aceita 19h: slot não existirá na consulta. Alinhe script com janela ou ajuste configuração.
- Esquecer Verificar conexão após OAuth em outra aba.
- Fuso errado entre consulta e criação de evento.
- Fluxo sem Encerramento após agendar: o lead fica sem confirmação clara.
- Usar agenda pessoal sem combinar com o time comercial.
Próximos passos
Visão geral da feature e casos de uso: Google Agenda no workflow. Mapa de todos os blocos: Guia dos nós do workflow. Agendamento como estratégia comercial: Agendamento de reuniões por voz.