A integração com Google Calendar permite que os Funis Inteligentes (agentes de IA) agendem reuniões automaticamente nas suas contas de Google Calendar. Quando um lead é qualificado e confirma disponibilidade no WhatsApp, a IA cria o evento diretamente no seu calendário — sem intervenção manual — criando um fluxo completo de qualificação até agendamento.
Disponível em: Plataforma > Integrações > Google Calendar (rota: /integrations)
Quem pode fazer: Proprietário ou Administrador
Módulo: Plataforma
O que você precisa antes de começa
Acesso de Proprietário ou Administrador na sua conta Nuvia
Uma conta ativa no Google Workspace ou Google pessoal (Gmail)
Permissão para conectar aplicações de terceiros à sua conta Google
Clareza sobre qual calendário será usado para agendar reuniões (padrão, pessoal, de equipe, etc.)
Entendimento de como os Funis Inteligentes usam calendários para qualificação
💡 Dica: Se você é Gestor ou Atendente, você não conseguirá conectar integrações. Solicite a um Proprietário ou Administrador que faça essa configuração. Porém, você poderá usar o calendário para agendar reuniões no dia a dia.
Conceitos fundamentais
Antes de começar, é importante entender como a integração funciona:
Conceito
| O que é
| Exemplo
|
Autorização OAuth
| Sistema de segurança que permite à Nuvia acessar seu Google Calendar sem precisar da sua senha
| Você clica em "Conectar Google Calendar" e autoriza no login do Google
|
Agendamento automático
| O Funil Inteligente cria eventos no seu calendário quando um lead confirma disponibilidade
| Lead confirma "Terça às 14h" no WhatsApp → evento criado no seu Google Calendar
|
Identificador de calendário
| ID único que identifica qual calendário receberá os eventos
|
|
Fuso horário
| O sistema detecta automaticamente o fuso horário da sua conta Google para evitar conflitos
| Se seu calendário está em São Paulo (GMT-3) e você cria evento para "14h", o agente respeita o fuso
|
Múltiplas contas
| Você consegue conectar mais de uma conta Google Calendar (sua conta pessoal + conta corporativa)
| Funis diferentes podem usar calendários diferentes
|
Conectar uma conta do Google Calendar
Passo a passo
Acesse a página de Integrações
Vá para Plataforma > Integrações (rota:
/integrations)Você verá uma lista de integrações disponíveis
Localize Google Calendar
Procure por Google Calendar na lista de integrações
Clique no painel do Google Calendar para abrir as opções
Clique em "Conectar Google Calendar"
Um botão de autorização aparecerá
Clique em "Conectar Conta Google" ou "Autorizar Acesso"
Você será redirecionado para o Google
Uma nova aba se abrirá com a tela de login do Google
Faça login com a conta Google cujo calendário você quer conectar
Se já estiver logado, você verá a tela de permissões diretamente
Revise e conceda permissões
Uma tela mostrará as permissões solicitadas pela Nuvia:
"Ver, editar, criar e deletar eventos do seu calendário" — necessário para agendar reuniões
"Consultar informações sobre seus calendários" — necessário para identificar qual calendário usar
Clique em "Permitir" ou "Continuar" para autorizar
Retorno automático à Nuvia
Você será automaticamente redirecionado de volta à página de Integrações
A integração agora mostra Status: Conectado
O e-mail da conta Google e o identificador do calendário principal aparecem
⚠️ Importante: A autorização é concedida apenas para a Nuvia — sua senha não é compartilhada. Você consegue revogar o acesso a qualquer momento nas configurações de segurança da sua conta Google (em Configurações > Segurança > Apps com acesso à sua conta).
Como saber se deu certo
Na página de Integrações, Google Calendar mostra Status: CONECTADO
O e-mail da conta Google conectada é exibido (ex:
[email protected])O identificador do calendário principal é mostrado (ex:
[email protected]ou ID customizado)Um botão de "Desconectar" fica visível
Um botão de "Adicionar outra conta" está disponível se você quiser conectar mais calendários
Gerenciar múltiplas contas conectadas
Você consegue conectar mais de uma conta Google Calendar — útil se você tem conta pessoal e corporativa, ou se múltiplos agentes precisam agendar em calendários diferentes.
Adicionar uma segunda conta Google Calendar
Na página de Google Calendar (Integrações)
Você verá a primeira conta conectada listada
Clique em "Adicionar outra conta Google Calendar"
Um novo painel aparecerá para adicionar uma conta adicional
Siga o fluxo de autorização
Clique em "Conectar Google Calendar"
Será redirecionado para o Google
Faça login com a segunda conta Google (diferente da primeira)
Conceda as permissões novamente
A nova conta será adicionada à lista
Agora você verá duas contas conectadas
Cada uma com seu próprio e-mail e identificador de calendário
Visualizar todas as contas conectadas
Na página de Google Calendar
Você verá uma lista com todas as contas Google conectadas
Cada conta mostra:
E-mail da conta (ex:
[email protected])Identificador do calendário (ex:
[email protected]ou ID da API)Status (Conectado)
Ações (Detalhes, Desconectar)
Qual conta usar em cada Funil Inteligente
Ao configurar um Funil Inteligente, você escolhe qual calendário (qual conta Google) será usado para agendar reuniões. Veja Como a integração funciona com os Funis Inteligentes para detalhes.
💡 Dica: Organize assim:
Calendário 1 (Gmail pessoal) — para reuniões de prospecção diretas
Calendário 2 (Google Workspace corporativo) — para reuniões com a equipe de vendas
Calendário 3 (calendário compartilhado) — para agendar em um calendário público da empresa
Verificar detalhes de uma conta conectada
Acessar informações da conta
Na página de Google Calendar (Integrações)
Localize a conta que quer consultar
Clique em "Detalhes" ou "Ver Mais"
Um painel mostrará as informações completas:
Informação
| O que é
| Exemplo
|
E-mail da conta Google
| Endereço de e-mail da conta autorizada
|
|
Calendário ID
| Identificador único do calendário principal
|
|
Nome do calendário
| Nome exibido no Google Calendar
| "Calendário Principal" ou "Reuniões de Vendas"
|
Status da autorização
| Indica se a integração está ativa
| Ativo / Expirado / Revogado
|
Data de conexão
| Quando a integração foi conectada
| "31 de março de 2026"
|
Última sincronização
| Última vez que a Nuvia verificou/criou eventos
| "Hoje às 14:32"
|
Entendendo o Calendar ID
O Calendar ID pode aparecer em dois formatos:
Calendário pessoal / principal: exibido como um e-mail (ex:
[email protected])Calendário customizado / compartilhado: exibido como um ID longo (ex:
c_abc123xyz456#[email protected])
Você consegue criar calendários adicionais no Google Calendar (ex: "Calendário de Reuniões com Clientes") e cada um terá seu próprio Calendar ID. Se quiser usar um calendário customizado em um Funil, o sistema automaticamente detecta e lista todos os calendários da sua conta Google.
Desconectar uma conta do Google Calendar
Se precisar remover a integração com uma conta Google Calendar, o processo é simples — mas importante entender as consequências.
Desconectar a integração
Acesse a página de Integrações
Vá para Plataforma > Integrações
Localize Google Calendar
Encontre o painel Google Calendar com as contas conectadas
Clique em "Desconectar"
Ao lado da conta que deseja remover, clique em "Desconectar"
Um aviso aparecerá explicando as consequências
Confirme a desconexão
Clique em "Confirmar Desconexão" ou "Desconectar Agora"
Conclusão
A conta é removida da lista
Se você tinha múltiplas contas conectadas, as outras permanecem ativas
O que acontece quando você desconecta
O que acontece
| Detalhe
|
Agendamentos futuros param
| Novos eventos não serão criados no Google Calendar quando leads confirmar disponibilidade
|
Eventos passados permanecem
| Reuniões já criadas continuam no seu Google Calendar (não são deletadas)
|
Funis que usavam esse calendário
| Entrarão em erro se tentarem agendar (você precisa reatribuir para outro calendário conectado)
|
Reconexão
| Você consegue reconectar a mesma conta a qualquer momento; a sincronização retoma
|
Revogar acesso no Google
| Se quiser garantir que a Nuvia não consegue mais acessar seu calendário, vá em Google > Configurações de Segurança > Apps com acesso à sua conta e revogue "Nuvia"
|
⚠️ Importante: Desconectar não deleta eventos já criados no Google Calendar. Apenas para a criação de novos agendamentos. Se precisar retomar, a integração pode ser reconectada e eventos continuarão sincronizados.
Como a integração funciona com os Funis Inteligentes
A integração com Google Calendar é usada principalmente pelos Funis Inteligentes (agentes de IA) para agendar reuniões de forma autônoma.
Fluxo de agendamento automático
Lead entra em conversa com o Funil Inteligente no WhatsApp
Exemplo: "Oi, gostaria de conhecer mais sobre a Nuvia"
O agente qualifica o lead
Faz perguntas sobre necessidade, orçamento, timeline
Acumula informações que qualificam o lead como SQL (Sales Qualified Lead)
Quando o lead está pronto, o agente oferece agendamento
Exemplo: "Perfeito! Vamos agendar uma reunião com nosso time de vendas?"
Lead confirma disponibilidade
Escolhe data e hora no WhatsApp (ex: "Terça à tarde")
Ou usa um link de calendário (se configurado, através do Calendly ou similar)
O agente cria o evento no Google Calendar
Automaticamente cria um evento no calendário conectado
Adiciona:
Título: Nome do lead e assunto (ex: "Reunião com João Silva - Demonstração Nuvia")
Data e hora: Horário confirmado pelo lead
Descrição: Resumo da conversa e contexto da oportunidade
Convidado: E-mail do lead (se disponível)
Notificação enviada ao calendário
Você recebe uma notificação no Google Calendar
O evento aparece automaticamente na sua agenda
Sincroniza em tempo real com outros aparelhos conectados à conta Google
Configurar qual calendário o Funil usa
Ao criar ou editar um Funil Inteligente, você escolhe qual calendário será usado para agendar:
Vá para Funis Inteligentes (módulo de Agentes de IA)
Menu lateral > Funis Inteligentes ou AI Agents
Crie um novo Funil ou edite um existente
Procure pela seção "Agendamento" ou "Calendário"
Selecione a conta Google Calendar
Um dropdown mostrará todas as contas conectadas
Escolha a conta (ex:
[email protected])
Salve o Funil
O agente agora usará esse calendário para agendar
⚠️ VERIFICAR COM PRODUTO: Como o Funil sabe qual calendário específico usar se a conta Google tem múltiplos calendários conectados? Há um dropdown para "Calendário principal" vs. "Calendário customizado"?
Configurar permissões para múltiplos calendários
Se você tem calendários compartilhados (ex: calendário de equipe, calendário de sala de reunião), você consegue usá-los nos Funis Inteligentes.
Adicionar um calendário compartilhado à sua conta Google
No Google Calendar
Vá para a conta Google conectada à Nuvia
Procure um calendário compartilhado que alguém criou para você (ex: "Reuniões com Clientes")
Aceite ou inscreva-se no calendário
A Nuvia detectará automaticamente
Quando você conecta uma conta Google à Nuvia, a integração acessa todos os calendários aos quais você tem permissão
Calendários compartilhados aparecerão automaticamente como opções ao configurar um Funil
Use o calendário nos Funis
Ao configurar um Funil Inteligente, selecione o calendário compartilhado ao invés do calendário pessoal
💡 Dica: Se você trabalha em equipe e quer que leads agendem em um calendário centralizado (não no calendário pessoal de um SDR), crie um calendário compartilhado no Google Calendar, compartilhe com todos os SDRs, e configure os Funis para usar esse calendário.
Limites e regras
Limite
| Detalhe
| Impacto
|
Número de contas Google conectadas
| Você consegue conectar ⚠️ VERIFICAR COM PRODUTO: (5? 10? ilimitado?) contas Google diferentes
| Se precisa de mais contas, podem estar no limite
|
Número de eventos por dia
| ⚠️ VERIFICAR COM PRODUTO: Existe limite de quantos eventos o Funil consegue criar por dia?
| Pode gerar throttling em campanhas com alto volume
|
Tipos de calendário suportados
| Google Calendar pessoal, Google Workspace, calendários compartilhados
| Calendários de terceiros (Outlook, Calendly, etc.) não estão suportados nativamente
|
Fuso horário
| A integração respeita o fuso horário da conta Google (não é configurável globalmente)
| Se sua conta Google está em São Paulo e você cria "14h", será "14h São Paulo"
|
Duração do evento
| ⚠️ VERIFICAR COM PRODUTO: Qual é a duração padrão de um evento criado? (30 min, 1 hora, customizável?)
| Pode precisar ser ajustado manualmente após criação
|
Convidados automáticos
| ⚠️ VERIFICAR COM PRODUTO: O lead é automaticamente adicionado como convidado ao evento?
| Se sim, ele recebe notificação; se não, você precisa adicioná-lo manualmente
|
Papéis com acesso
| Apenas Proprietário e Administrador conseguem conectar/desconectar integrações
| Atendentes e Gestores não conseguem gerenciar a integração
|
Acesso às contas autorizadas
| Todos os Funis Inteligentes do workspace conseguem ver e usar qualquer conta Google conectada
| Não há isolamento por equipe ou por perfil de usuário
|
Erros comuns e soluções
Erro
| Causa
| Solução
|
"Autorização expirou"
| Token de acesso Google expirou (válido por ~3-6 meses de inatividade)
| Vá para Integrações > Google Calendar e clique em "Reconectar" para renovar a autorização
|
"Falha ao criar evento no calendário"
| A conta Google pode estar com acesso revogado ou cota de API excedida
| Verifique em Google > Configurações de Segurança > Apps com acesso e garanta que "Nuvia" está autorizado
|
"Lead não é adicionado como convidado ao evento"
| Talvez o lead não tenha e-mail válido ou a Nuvia não consiga acessá-lo
| Verifique se o lead tem e-mail preenchido no contato
|
"Não consigo conectar minha conta Google Workspace corporativa"
| Pode haver restrição de acesso da políticas de segurança da empresa
| Peça a um administrador Google Workspace que autorize apps de terceiros
|
"Horário do evento criado está errado"
| Possível conflito de fuso horário entre a conta Google e a Nuvia
| Verifique se o fuso horário da sua conta Google está correto (Google > Configurações > Geral > Fuso Horário)
|
"Erro: 'Permissão negada' ao conectar"
| Sua conta Google pode estar com 2FA ativado ou em modo seguro
| Verifique suas configurações de segurança Google; tente conectar em um dispositivo confiável
|
"Não consigo ver a aba Google Calendar"
| Você pode não ter permissão (apenas Proprietário/Admin)
| Solicite a um Proprietário ou Administrador que configure
|
"Evento foi criado, mas sem descrição ou contexto"
| ⚠️ VERIFICAR COM PRODUTO: O Funil precisar estar configurado para enviar contexto?
| Verifique a configuração do Funil Inteligente; pode estar sem "Enviar contexto para evento" ativado
|
Perguntas frequentes
P: A integração com Google Calendar funciona com qualquer tipo de conta Google?
R: Sim. Funciona com Google pessoal (Gmail), Google Workspace corporativo e contas eduacionais do Google. A única restrição é que você precisa ser proprietário ou ter permissão para autorizar apps de terceiros na sua conta.
P: Se desconectar a conta Google, os eventos já criados são deletados do calendário?
R: Não. Eventos já criados continuam no seu Google Calendar. Desconectar apenas impede a criação de novos eventos. Se quiser remover eventos antigos, você precisa fazer isso manualmente no Google Calendar.
P: Posso usar um calendário compartilhado da minha equipe?
R: Sim. Se o calendário compartilhado foi compartilhado com você (com permissão de edição), a Nuvia conseguirá detectá-lo e usá-lo. Todos os SDRs podem agendar no mesmo calendário centralizado.
P: E se eu tiver Google Calendar e Outlook? A Nuvia funciona com Outlook?
R: Atualmente, a Nuvia suporta Google Calendar. Suporte para Outlook/Exchange está ⚠️ VERIFICAR COM PRODUTO: (em roadmap? fora do escopo?). Se você usa Outlook, recomendamos conectar sua conta Google Calendar separadamente ou sincronizar Outlook com Google Calendar via ferramentas de terceiros.
P: Quantas contas Google Calendar eu consigo conectar?
R: Você consegue conectar ⚠️ VERIFICAR COM PRODUTO: (número específico?) contas Google diferentes. Cada uma pode ser usada por Funis diferentes. É útil para separar reuniões pessoais de reuniões corporativas.
P: Se múltiplos Funis agendam no mesmo calendário, há conflito de horários?
R: O Google Calendar valida conflitos nativamente. Se dois Funis tentarem agendar no mesmo horário, você verá um alerta no Google Calendar. A Nuvia não faz "bloqueio inteligente" de horários — você precisa manualmente recusar um dos eventos ou renegociar o horário com um dos leads.
P: Como o agente sabe que horário agendar se o lead não escolheu um horário específico?
R: ⚠️ VERIFICAR COM PRODUTO: Isso depende de como o Funil foi configurado. Ele pode:
Pedir um horário específico ("Qual horário prefere?")
Oferecer slots disponíveis ("Você prefere segunda ou terça?")
Integrar com um widget de calendário (Calendly, Fantastical, etc.) para o lead escolher
Verifique a documentação de Funis Inteligentes para detalhes.
P: O lead recebe uma notificação quando um evento é criado?
R: Se o lead é adicionado como convidado ao evento (e sua conta tem acesso a e-mail), ele receberá uma notificação automática do Google Calendar. ⚠️ VERIFICAR COM PRODUTO: Isso é sempre feito ou depende de configuração?
P: Posso personalizar o título e descrição do evento criado?
R: ⚠️ VERIFICAR COM PRODUTO: Essa customização é feita no Funil Inteligente ou na integração? Por exemplo, você consegue escolher se o título será "Reunião - [Nome do Lead]" ou "[Nome da Empresa] - Demo"? Consulte a documentação de Funis Inteligentes para detalhes.
P: Se eu edito um evento manualmente no Google Calendar, a Nuvia sincroniza a mudança?
R: Não. A integração é somente para criação de eventos. Se você edita um evento (horário, descrição, etc.) manualmente no Google Calendar, a Nuvia não sincroniza essas mudanças de volta. A sincronização é unidirecional: Nuvia → Google Calendar.
P: Preciso configurar webhooks ou APIs manualmente?
R: Não. A integração Google Calendar da Nuvia é gerenciada integralmente pela plataforma. Você não precisa configurar webhooks, OAuth ou APIs — tudo é automático após conectar a conta.
P: Como garanto que meus calendários estão sempre sincronizados?
R: A sincronização é automática e em tempo real. Quando um Funil cria um evento, ele aparece instantaneamente no seu Google Calendar e em todos os seus dispositivos conectados (celular, desktop, web). Para verificar o status da integração, vá para Plataforma > Integrações e confirme que o Status é CONECTADO.
P: Posso usar a integração Google Calendar em múltiplos workspaces Nuvia?
R: ⚠️ VERIFICAR COM PRODUTO: Cada workspace Nuvia tem sua própria integração Google Calendar, ou a mesma conta Google consegue estar conectada em múltiplos workspaces? Se você tem múltiplos workspaces, você pode precisar autorizar a mesma conta Google em cada um.