Your AI Connector Docs

Integração com o Google Calendar

Visão geral

A plataforma integra-se ao Google Calendar para fornecer sincronização bidirecional entre seus agendamentos e seu calendário. Quando um contato faz um agendamento pela plataforma, o compromisso aparece no seu Google Calendar. Quando você adiciona eventos ao seu Google Calendar, a plataforma reconhece esses horários como ocupados e não os oferecerá como horários disponíveis.

Por que isso é importante: Você nunca precisará se preocupar com agendamentos duplicados. Seja adicionando uma reunião no Google Calendar ou um contato agendando pela plataforma, sua disponibilidade permanece precisa em todos os lugares.

É obrigatório? Não. O agendamento funciona sem nenhum calendário conectado: você define seus horários em um tipo de evento e a IA realiza os agendamentos com base neles. Conectar o Google Agenda adiciona a sincronização bidirecional descrita aqui, além de links automáticos do Google Meet. Veja Sistema de Agendamento.


Conectando o Google Calendar

Existem três maneiras de se conectar:

A partir das Configurações (a maneira principal)

  1. Abra Configurações e, na barra lateral, sob o grupo Integrações, clique em Agendamento e Calendário.
  2. Encontre o cartão do Google Calendar em Disponível e clique em Conectar.
  1. Uma janela de login do Google será aberta. Escolha a conta com o calendário que você deseja sincronizar e conceda permissão. (Se nada abrir, seu navegador bloqueou o pop-up — permita pop-ups para este site e clique em Conectar novamente.)
  2. Assim que você conceder o acesso, a página será atualizada automaticamente: o Google Calendar subirá para Conectado com o endereço da sua conta Google abaixo.

A partir de um tipo de evento

No momento em que você realmente precisar do Google Calendar, o aplicativo o direcionará para ele:

  1. Clique em Agendamentos na barra lateral (em Engajar), alterne para a aba Tipos de evento e crie ou abra um tipo de evento.
  2. Escolha Google Meet como o tipo de reunião (ou tente ativar Sincronizar agendamentos com o Google Agenda na parte inferior do formulário).
  3. Se sua agenda ainda não estiver conectada, um aviso laranja aparecerá com um link Conectar Google Agenda:
  1. Clique no link. Ele levará você para Configurações → Agendamento e Calendário — continue a partir do passo 2 acima.

Durante a integração guiada

Se você estiver configurando sua conta agora, o assistente de integração guiada possui uma etapa Conectar Google Agenda — ela aparece automaticamente assim que você escolhe IA agenda para mim na etapa de opções de agendamento. Veja Integração Guiada.

Importante: Estas permissões são necessárias para que a sincronização bidirecional funcione. A plataforma acessa apenas os dados da sua agenda — ela não lê seus e-mails, contatos ou quaisquer outros dados do Google. Você pode revogar o acesso a qualquer momento nas configurações de segurança da sua conta Google.

Dica: Se você usa várias contas do Google (por exemplo, uma pessoal e uma de trabalho), certifique-se de selecionar a conta que possui a agenda com a qual você deseja que a plataforma sincronize.

Verificando o status da sua conexão e desconectando

Configurações → Agendamento e Calendário também é onde você verifica a conexão posteriormente. Quando o Google Calendar está conectado, ele aparece na lista Conectado com um botão Desconectar ao lado.

Desconectar impede que novos agendamentos sejam sincronizados com seu calendário e impede que a IA crie links do Google Meet. Os agendamentos já existentes na plataforma permanecem exatamente onde estão.


Explicação da Sincronização Bidirecional

A sincronização bidirecional significa que as alterações fluem automaticamente em ambas as direções:

Do Aplicativo para o Google Agenda

  • Quando um contato agenda um compromisso no aplicativo, o evento aparece automaticamente no seu Google Agenda.
  • Quando um compromisso é cancelado no aplicativo, o evento correspondente no Google Agenda é atualizado ou removido.
  • Os detalhes do compromisso são preenchidos no evento da agenda para você (veja a lista abaixo).

O que é sincronizado com seu Google Agenda

Quando um agendamento é criado, a plataforma preenche o evento do Google Agenda com tudo o que você precisa ver rapidamente:

  • A data e a hora do agendamento.
  • O nome, número de telefone e e-mail do contato — para que você saiba com quem vai se reunir e como entrar em contato. Quando o e-mail é conhecido, o contato também é adicionado como convidado no evento e recebe o convite do Google Agenda por e-mail — incluindo o link do Google Meet, para que ele possa participar da reunião. (O convite segue a configuração do botão Enviar e-mail de agendamento para o contato do tipo de evento.)
  • O local da reunião — seja o endereço físico que você definiu no tipo de evento ou o endereço do próprio cliente, caso você o tenha coletado durante o agendamento (consulte Coletando informações extras durante o agendamento).
  • O link da reunião — um link do Google Meet criado automaticamente ou seu link personalizado, dependendo do Tipo de reunião que você escolheu para o evento.
  • Quaisquer informações extras que a IA coletou durante o agendamento (por exemplo, número de convidados ou um número de referência), exibidas na descrição e nas notas do evento.

Exemplo: Um contato agenda uma “Consulta Domiciliar”. O evento na agenda aparece com o nome, telefone e e-mail dele, o endereço fornecido durante o agendamento como local, um link do Google Meet caso a chamada se torne virtual e quaisquer notas que a IA reuniu — tudo isso sem que você precise digitar nada.

Do Google Agenda para o Aplicativo

  • Quando você adiciona um evento ao seu Google Agenda, a plataforma reconhece esse horário como ocupado.
  • A IA não oferecerá horários que entrem em conflito com seus eventos existentes no Google Agenda.
  • Se você mover ou excluir um evento do Google Agenda, a plataforma será atualizada de acordo.

Exemplo: Você adiciona um almoço de equipe das 12:00 às 13:00 no seu Google Agenda. A plataforma reconhece imediatamente esse horário como indisponível. Quando um contato solicitar horários disponíveis ao seu agente de IA, o período das 12:00 às 13:00 não aparecerá como uma opção.

Isso mantém o que o tipo de evento permitir: um bloco ocupado em seu calendário remove o horário mesmo para tipos de evento que aceitam múltiplas reservas por intervalo, porque isso significa que você não está disponível naquele momento, e não que uma de suas salas foi ocupada. Se o tipo de evento tiver várias salas, o bloqueio se aplica à sala à qual aquele calendário pertence.


Ativando a Sincronização para um Tipo de Evento

A sincronização de calendário é uma chave definida por tipo de evento:

  1. Clique em Agendamentos na barra lateral e mude para a aba Tipos de Evento.
  2. Abra o tipo de evento que você deseja sincronizar — clique na linha dele ou use o ícone de lápis na extremidade direita — ou crie um novo.
  1. Role até a parte inferior do formulário, para a seção Notificações.
  2. Ative a opção Sincronizar agendamentos com o Google Calendar.
  1. Clique em Save (ou Create event para um novo).

A partir de então, cada agendamento deste tipo de evento será adicionado ao seu Google Calendar, e a IA verificará esse calendário em busca de conflitos antes de oferecer horários.

Escolhendo qual calendário. Uma vez que o Google Agenda esteja conectado, a seção Salas do tipo de evento (logo acima de Notificações) oferece a cada sala seu próprio seletor de Google Agenda, com a observação “O tempo ocupado neste calendário bloqueia esta sala, e as reservas desta sala são adicionadas a ele.” Um tipo de evento com uma sala escolhe um calendário ali. Um tipo de evento com uma sala por membro da equipe aponta cada sala para o calendário daquela pessoa, de modo que cada sala seja verificada em relação ao seu próprio calendário e registre suas próprias reservas nele. Deixe uma sala em Nenhum calendário se ela não deve ser sincronizada. Veja Salas.

Dica: Se você tiver um calendário dedicado para agendamentos (por exemplo, “Reservas de Clientes”), conecte a conta do Google que o contém. Uma conta do Google pode conter vários calendários, portanto, uma equipe geralmente precisa de apenas uma conexão, não uma por pessoa. Isso mantém seus eventos pessoais separados da sua agenda de reservas.


Detecção de Conflitos e Bloqueio de Horários Ocupados

Uma vez que o Google Calendar esteja conectado e a sincronização ativada para um tipo de evento:

  • Bloqueio de tempo ocupado — Intervalos de tempo que coincidem com eventos existentes no Google Agenda são removidos automaticamente dos horários disponíveis. Seus contatos nunca receberão uma oferta de horário que conflite com algo que já esteja em seu calendário.
  • Limpeza de intervalo — Assim que um horário é reservado, pelo aplicativo ou diretamente em seu calendário, ele deixa de ser oferecido. A única exceção é um tipo de evento configurado para aceitar múltiplas reservas por intervalo: esse horário continua sendo oferecido até que esteja completo.
  • Um calendário por sala — Se um tipo de evento tiver várias salas e cada uma estiver vinculada ao seu próprio calendário, cada sala será verificada em relação ao seu próprio calendário de forma independente. A manhã ocupada do Dr. A nunca removerá a sala do Dr. B da lista.

Exemplo: Você tem uma reunião das 14:00 às 15:00 no seu Google Calendar. A IA não oferecerá nenhum horário de agendamento que coincida com o período das 14:00 às 15:00.


Atualizações em tempo real

A plataforma recebe notificações em tempo real do Google Calendar sempre que sua agenda muda. Veja o que isso significa para você:

  • Quando você adiciona, move ou exclui um evento no seu Google Agenda, a plataforma atualiza sua disponibilidade em segundos — não em minutos ou horas.
  • Você não precisa atualizar ou sincronizar nada manualmente. Isso acontece automaticamente em segundo plano.
  • Se a conexão entre a plataforma e o Google Agenda for interrompida, a plataforma a restabelece automaticamente.

Por que isso é importante: Se você bloquear um horário no seu Google Agenda às 10:00, um contato que solicitar horários disponíveis ao seu agente de IA às 10:01 já verá esse horário como indisponível.


Usando eventos sincronizados com o calendário com sua IA

Assim que seu tipo de evento estiver configurado, aponte sua IA para ele.

  1. Abra Agentes de IA, abra seu agente e vá para a etapa Habilidades de IA dele.
  2. Encontre o cartão Agendamentos.
  3. Ative Permitir que este agente agende compromissos, mantenha o provedor em Calendário integrado e escolha o seu tipo de evento em Escolha o que as pessoas podem agendar.
  1. Clique em Save changes.

Assim que isso for feito, a IA irá:

  • Verificar seu Google Agenda em busca de eventos existentes.
  • Oferecer apenas horários que estejam genuinamente disponíveis.
  • Criar o compromisso tanto na plataforma quanto no Google Agenda quando um contato fizer um agendamento.

Isso significa que seus contatos sempre veem a disponibilidade precisa, mesmo que sua agenda mude ao longo do dia. O fluxo completo da campanha é abordado passo a passo em Sistema de Agendamento.

O calendário utiliza créditos?

Conectar o Google Calendar e a sincronização bidirecional são gratuitos — manter um calendário conectado não gera custos contínuos, e agendamentos feitos diretamente na sua página de agendamento também são gratuitos.

Os créditos são usados apenas quando a IA realiza alguma ação em uma conversa. Sua resposta conta como uma ação de IA e, quando ela verifica sua disponibilidade ou agenda um horário para um contato, cada uma dessas etapas do calendário também conta como uma ação de IA, cobrada na taxa normal por ação do seu nível de modelo. Portanto, uma conversa de agendamento custa algumas ações de IA no total, e nada extra pelo calendário em si.


Solução de problemas de sincronização

Calendário não sincronizando

  • Verifique a conexão — Abra Configurações → Agendamento e Calendário e confirme se o Google Calendar aparece como conectado. Se precisar (re)autorizar, clique em Desconectar lá e depois em Conectar novamente.
  • Conceda permissões novamente — Se você removeu anteriormente o acesso da plataforma nas configurações da sua conta Google, precisará reconectar e conceder permissões novamente.
  • Verifique o tipo de evento — Certifique-se de que Sincronizar agendamentos com o Google Calendar esteja ativado para o tipo de evento em questão (na parte inferior do formulário).

Compromissos não aparecendo no Google Calendar

  • Verifique se o tipo de evento está com a opção Sincronizar agendamentos com o Google Agenda ativada.
  • Verifique se você conectou a conta Google que está realmente consultando.
  • Aguarde um momento — pode haver um pequeno atraso na primeira sincronização após a conexão.

Horários ocupados não sendo bloqueados

  • Confirme se a conta do Google que você conectou contém a agenda onde seus eventos existentes estão. Por exemplo, se suas reuniões estão em uma conta de trabalho, mas você conectou sua conta pessoal, a plataforma não verá essas reuniões.
  • Todos os eventos na sua agenda conectada bloqueiam o respectivo horário — incluindo eventos marcados como “Livre” no Google. Se um horário estiver inesperadamente indisponível, verifique a agenda para ver se há algum evento naquele momento.
  • Eventos de “dia inteiro” podem ser tratados de forma diferente, dependendo das configurações da sua agenda.

Se o Google perder o acesso à sua conta

Se a plataforma perder o acesso à sua conta Google (por exemplo, se você alterou sua senha do Google ou revogou as permissões do aplicativo), os eventos do seu calendário pararão de sincronizar até que o acesso seja restaurado. Reconecte a partir do link Conectar Google Agenda de um tipo de evento; entre em contato com o suporte se isso não resolver, e nós ajudaremos você a sincronizar novamente.


Precisa de ajuda?

If you are experiencing persistent sync issues, reach out via our email support.