Pular para o conteúdo principal
DocumentationAPI ReferenceVideo Tutorials

Google Calendar

Ligue o Google Calendar para que os seus agentes de voz IA possam verificar disponibilidade e marcar compromissos reais enquanto um interlocutor ainda está em linha. Uma vez ligado, cada agente na sua conta pode usar o calendário — sem necessidade de re-autorização por agente.

Disponível em todos os planos

O Google Calendar está disponível em todos os planos, incluindo Free. Sem taxa extra — as consultas de calendário e a criação de eventos usam algumas palavras de saída de LLM por turno, faturadas à sua taxa normal por minuto.

O Que Faz​

  • Verificações de disponibilidade — o agente lê o seu calendário para confirmar se um slot pedido está livre.
  • Criação de eventos — o agente marca um compromisso confirmado como um novo evento de calendário, com o nome do interlocutor, telefone e quaisquer notas captadas durante a chamada.
  • Links de cancelamento — cada marcação inclui um link self-service de cancelamento que o interlocutor recebe por email ou SMS, para que possa mudar planos sem voltar a ligar.

O agente não lê detalhes de eventos de outras pessoas, edita eventos não relacionados ou expõe o conteúdo do calendário — apenas os slots de que precisa para responder ao interlocutor.

Ligar a Sua Conta Google​

  1. Abra Integrations na barra lateral e clique em Connect Google Calendar.
  2. É redirecionado para o ecrã de consentimento padrão da Google.
  3. Inicie sessão com a conta Google que detém o calendário que pretende usar.
  4. Reveja a permissão pedida — Ver e editar eventos nos seus calendários — e clique em Allow.
  5. É devolvido à HANC e o cartão de integração mostra Connected com o endereço de email usado.

Escopo pedido​

A HANC pede um único escopo OAuth: https://www.googleapis.com/auth/calendar.events.

Este é um escopo Sensitive (não Restricted), o que significa:

  • A HANC pode ler e criar eventos, mas não pode ler a sua lista completa de calendários, definições de partilha ou aceder a qualquer outro serviço Google (sem Gmail, sem Drive, sem contactos).
  • A Google não exige uma Security Assessment para este escopo, e não há re-verificação anual.

Ao nível da conta, não por agente​

A ligação vive ao nível da conta HANC. Os tokens são armazenados uma vez num store partilhado e disponibilizados a cada agente de voz IA na sua conta. Autoriza uma vez e depois ativa a ferramenta de calendário em quantos agentes quiser.

Isto é diferente das definições por agente como prompt, base de conhecimento ou voz — essas são configuradas separadamente em cada agente.

Configuração de Ferramenta por Agente​

Ligar a Google à sua conta HANC torna a ferramenta disponível. Para a usar efetivamente, adicione a ferramenta Google Calendar à aba Actions do agente e configure-a.

DefiniçãoO que faz
CalendarQue calendário ligado o agente lê e escreve
TimezoneO fuso horário usado para cada slot que o agente menciona (ver abaixo)
Work hoursDias e intervalos horários que o agente irá oferecer (ex. Seg–Sex, 09:00–18:00)
Slot durationDuração padrão do compromisso (ex. 30 minutos)
BufferMargem entre compromissos consecutivos (ex. 15 minutos)

Cada agente na sua conta pode configurar isto de forma independente — útil quando um agente marca demos de vendas de 30 minutos e outro marca consultas de 90 minutos a partir do mesmo calendário.

Para o passo a passo completo de configuração incluindo o equivalente Outlook, veja Integrações → Google Calendar.

Gestão de Fuso Horário​

Todas as ofertas de slot, confirmações e eventos criados usam o fuso horário configurado na ferramenta de calendário do agente (ex. Europe/Vienna, Europe/Berlin, America/New_York). O agente diz o fuso horário em voz alta quando oferece um slot — por exemplo, "Terça-feira às três da tarde, hora de Viena, fica bem?" — para que o interlocutor nunca tenha de adivinhar.

Se o seu interlocutor está num fuso horário diferente, configure o agente para confirmar verbalmente o equivalente local antes de marcar. O evento criado no Google Calendar guarda sempre a hora no fuso horário configurado; a Google trata da apresentação na zona local de cada participante.

Desligar e Voltar a Ligar​

Pode desligar o Google Calendar a qualquer momento a partir da página Integrations.

Quando desliga:

  • Os tokens armazenados são removidos.
  • Cada ferramenta Google Calendar em cada agente na sua conta é desativada — a ferramenta permanece em cada agente mas deixa de ser acionada durante as chamadas.
  • Os eventos já marcados no próprio Google não são eliminados ou alterados.

Quando volta a ligar (ou liga uma conta Google diferente), as ferramentas previamente desativadas reativam-se automaticamente com as suas antigas definições de horário de trabalho, duração de slot e fuso horário — não tem de voltar a adicionar a ferramenta em cada agente.

Também pode revogar o acesso da HANC nas definições de segurança da sua conta Google. O efeito é o mesmo de desligar dentro da HANC; a próxima chamada que tente usar o calendário falhará de forma limpa e as ferramentas serão desativadas na próxima sincronização.

Compromissos Marcados na HANC​

Cada evento que o agente cria também aparece em CRM → Calendário ao lado de quaisquer marcações Outlook, com uma ligação de volta ao registo de contacto do interlocutor. Veja CRM → Calendário para a vista unificada.

Relacionados​