Como configurar integração com Google Calendar na Nuvia

Conecte o Google Calendar à Nuvia para que os Funis Inteligentes agendem reuniões automaticamente, com suporte a múltiplas contas e calendários compartilhados.

Disponível em
Todos os planos
Quem pode fazer
Administrador.

Nesta página6 seções

A integração com Google Calendar permite que os Funis Inteligentes (agentes de IA) criem eventos no seu calendário quando um lead qualificado confirma um horário no WhatsApp, sem intervenção manual. É o que fecha o fluxo de qualificação até o agendamento.


O que você precisa antes de começar

  • Acesso de Administrador na sua conta Nuvia

  • Uma conta ativa no Google Workspace ou Google pessoal (Gmail)

  • Permissão para conectar aplicativos de terceiros à sua conta Google

  • Clareza sobre qual calendário será usado para agendar (pessoal, de equipe, compartilhado)

  • Entendimento de como os Funis Inteligentes usam o calendário para agendar


Conectar uma conta do Google Calendar

  1. No menu lateral, clique nos 3 pontinhos do ícone de perfil e selecione Configurações

  2. No menu lateral, selecione Integrações

  3. Localize Google Calendar e clique em Integrar

  4. Clique em Adicionar conta

  5. Revise e conceda as permissões solicitadas

  6. Clique em Conectar conta

  7. Autorize a conexão no Google

  8. Você é redirecionado de volta à Nuvia, e a integração passa a mostrar o status Conectado

Permissões solicitadas

Durante a autorização, o Google mostra o que a Nuvia precisa acessar:

  • Ver, criar, editar e remover eventos dos seus calendários: Necessário para a IA agendar as reuniões

  • Ver a lista dos seus calendários: Necessário para identificar em qual calendário criar o evento

Como saber se deu certo

  • A integração mostra o status Ativo

  • O e-mail da conta Google conectada aparece (ex: seu.email@gmail.com)

  • Ficam disponíveis as ações Desconectar e Adicionar conta


Gerenciar múltiplas contas conectadas

Você pode conectar mais de uma conta Google Calendar, útil quando tem conta pessoal e corporativa, ou quando agentes diferentes precisam agendar em calendários diferentes.


Configurações de agendamento (por conta)

Cada conta de Google Calendar conectada tem suas próprias configurações de agendamento. Acesse em Configurações > Integrações > Google Calendar > Gerenciar, clique nos 3 pontinhos da conta e abra Configurações da agenda.

  • Verificar disponibilidade antes de agendar (ligado por padrão): Antes de criar o evento, a Nuvia confere na sua agenda se o horário ainda está livre. Se houver conflito, o evento não é criado e o agente oferece outro horário ao lead.

  • Intervalo entre reuniões (desligado por padrão): Adiciona uma folga, em minutos, entre um compromisso já existente e o próximo agendamento, para você não emendar uma reunião na outra. Quando ligado, informe os minutos de folga.

  • Personalizar título dos eventos (desligado por padrão): Define o título de todos os eventos criados pela IA nessa conta. Aceita variáveis de personalização (ex.: #{{var_contact_name}}), as mesmas dos templates de mensagem, incluindo campos personalizados do contato; variáveis sem valor são removidas automaticamente e o título é limitado a 100 caracteres. Deixando o campo vazio, o título segue o padrão (definido pelo prompt do agente ou “Agendamento de {nome}”). Obs.: variáveis de coluna de campanha (var_col_*) não são resolvidas aqui.

Na lista de contas, a coluna Agendamento resume a configuração de cada conta: se verifica o horário ou não, e a folga definida.


Como os Funis Inteligentes usam o calendário

A integração é usada principalmente pelos Funis Inteligentes (agentes de IA) para agendar reuniões de forma autônoma.

Fluxo de agendamento automático

  1. O lead conversa com o Funil Inteligente no WhatsApp

  2. O agente qualifica o lead com perguntas sobre necessidade, contexto e momento

  3. Quando o lead está pronto, o agente oferece o agendamento

  4. O lead confirma um horário no WhatsApp (ou por um link de agendamento, se configurado)

  5. O agente cria o evento no calendário conectado, com:

    • Título: Nome do lead e assunto (ex: “Reunião com João Silva, Demonstração Nuvia”)

    • Data e hora: O horário confirmado pelo lead

    • Descrição: Resumo da conversa e contexto da oportunidade

    • Convidado: E-mail do lead, quando disponível

  6. O evento aparece na sua agenda e sincroniza em tempo real com seus aparelhos conectados à conta Google

O fuso horário é detectado automaticamente da sua conta Google, então o horário confirmado pelo lead cai no momento certo da agenda.

Escolher qual calendário o Funil usa

  1. Vá para Funis Inteligentes (módulo de Agentes de IA)

  2. Crie um novo Funil ou edite um existente

  3. Dentro do prompt do agente use o caractere especial “@” para abrir o menu de tools, busque por agenda + email para definir a agenda.

  4. Salve as alterações


Desconectar uma conta do Google Calendar

  1. No menu lateral, clique nos 3 pontinhos do ícone de perfil e selecione Configurações

  2. No menu lateral, selecione Integrações

  3. Localize Google Calendar e clique em Gerenciar

  4. No canto direito da conta que deseja remover, clique nos 3 pontinhos e em Desconectar

  5. Leia o aviso e confirme


Perguntas frequentes

A integração funciona com qualquer tipo de conta Google?

Sim. Funciona com Google pessoal (Gmail), Google Workspace corporativo e contas educacionais do Google. A condição é ter permissão para autorizar aplicativos de terceiros na conta.

A Nuvia verifica se já tenho compromisso no horário antes de agendar?

Sim, quando a opção Verificar disponibilidade antes de agendar está ligada (o padrão) nas Configurações da agenda da conta. Se o horário já estiver ocupado, o evento não é criado e o agente oferece outro horário ao lead.

Como evito que a IA marque reuniões coladas uma na outra?

Ative Intervalo entre reuniões nas Configurações da agenda e informe os minutos de folga. A Nuvia passa a respeitar esse respiro entre um compromisso e o próximo agendamento.

Onde configuro a duração das reuniões agendadas?

A duração não fica nas Configurações da agenda. Ela é definida pelo Funil Inteligente durante a conversa. As Configurações da agenda controlam apenas a verificação de disponibilidade e o intervalo entre reuniões.

Posso personalizar o título e a descrição do evento?

Sim. O título é definido pelo campo Personalizar título dos eventos nas Configurações da agenda da conta (Configurações > Integrações > Google Calendar > Gerenciar > 3 pontinhos > Configurações da agenda). Ele vale para todos os eventos criados pela IA naquela conta e aceita variáveis de personalização (ex.: #{{var_contact_name}}), as mesmas dos templates de mensagem, incluindo campos personalizados do contato; variáveis sem valor são removidas automaticamente (o título nunca sai com #{{…}}). A precedência é: template configurado na integração > título sugerido pela IA (prompt do Funil) > padrão “Agendamento de [Nome do Lead]”. Deixando o campo vazio, o título segue o prompt do agente ou o padrão. A descrição é preenchida pela IA (até 200 caracteres); título e descrição são campos separados.

Observação: variáveis de coluna de campanha (var_col_*) não são resolvidas nesse contexto.

Se eu desconectar a conta, os eventos já criados são apagados?

Não. Os eventos já criados continuam no Google Calendar. Desconectar só impede a criação de novos. Para remover eventos antigos, apague manualmente no Google Calendar.

Se eu editar um evento manualmente no Google Calendar, a Nuvia sincroniza a mudança?

Não. A sincronização é unidirecional, da Nuvia para o Google Calendar. A integração só cria eventos e não traz de volta edições feitas no Google.

Preciso configurar webhooks ou APIs manualmente?

Não. Depois de conectar a conta, a autorização e o restante são gerenciados pela plataforma.

A criação dos eventos é em tempo real?

Sim. Quando um Funil cria um evento, ele aparece na hora no seu Google Calendar e nos dispositivos conectados à conta.

Este artigo ajudou?