Automatize agendamentos no Google Calendar com Huggy IA e n8n

Calebe Ribeiro

Neste guia, vamos construir uma integração completa entre Huggy e Google Calendar para transformar o agendamento de eventos no WhatsApp ou em qualquer outro canal conectado à sua conta.

Mais do que uma simples conexão, você vai obter um ecossistema onde seus clientes garantem horários em instantes com o apoio da IA, permitindo que sua equipe foque no que realmente importa.

Para que você execute este projeto com agilidade, entregamos:

Vídeos com o passo a passo na íntegra.
Workflow pré-configurado para o n8n.
Modelo de prompt estruturado para sua IA.
Links de referência e documentação.

Vamos à prática?

Desenvolvendo a integração

No vídeo a seguir, mostramos a automação em tempo real e tudo o que você precisa para desenvolvê-la.

Importando o template para o n8n

Obtenha o workflow pré-configurado em sua conta, seguindo os seguintes passos:

Abra o seu n8n.
No menu superior direito (três pontos), clique em Import from URL.
Cole a URL: https://api.npoint.io/0a39efce16daffc403ae
Clique em Import.

Requisitos

Veja o que você vai precisar para implementar esta solução:

Huggy: Aplicativo autenticado que dá acesso à API v3 e Webhook.

Acompanhe o vídeo se precisar de ajuda para configurar credenciais no n8n e configurar o recebimento de eventos de webhook.

Google Calendar: Acesso ao Google Cloud para ativar a API do Calendar.

LLM: Chave de API e saldo/plano ativo. Utilize um modelo de IA como OpenAI ou outra de sua preferência.
N8n: Acesso a uma instância do n8n (seja na nuvem ou em servidor próprio).

💡 Caso queira um material detalhado que te ajude a entender como criar um agente de IA no n8n, clique aqui.

Criando um prompt

O sucesso do seu agente de IA está diretamente ligado à construção de um prompt bem estruturado, que traduz as regras do seu negócio em ações precisas.

Para isso, é fundamental definir com clareza o comportamento da IA, suas instruções de execução e os recursos necessários, garantindo uma experiência fluida e segura para o usuário.

Para facilitar o seu trabalho, compartilhamos abaixo um modelo base que você pode adaptar conforme as suas necessidades:

🗒️ Modelo de prompt

CONTEXTO E IDENTIDADE: Você é um assistente virtual de agendamentos. Sua única função é agendar consultas no Google Calendar e interagir com o usuário de forma educada, prestativa e direta.

ESCOLHA DA AGENDA: Converse no chat para saber qual agenda você deve escolher para pesquisar e adicionar eventos. Quando o usuário quiser agendamento para Dr. [Exemplo], utilize a agenda exemplo@exemplo.com. Para Dr. [Exemplo-2], utilize a agenda exemplo2@exemplo.com.

REGRA ESSENCIAL PARA PROSSEGUIR: A data e hora exatas de agora são: {{ new Date( $json.body.time * 1000).toLocaleString('pt-BR') }}. Use essa informação como base absoluta para entender solicitações como "amanhã", "hoje" ou "semana que vem".

REGRAS DE AGENDAMENTO:
Janela de Agendamento: Faça agendamentos apenas para um período máximo de [60] dias a contar da data de hoje.
Duração: Todas as consultas têm duração exata de [uma hora].
Horário de Funcionamento: [Segunda a Sexta, das 08h às 18h]. Não agende fora desses horários.
Disponibilidade: Utilize a tool do Google Calendar PRIMEIRO para verificar a disponibilidade de horários. Nunca prometa um horário sem verificar antes. Se não há conflitos na agenda: confirme o horário e marque.
Conflitos: Se o horário pedido estiver ocupado, sugira imediatamente 2 horários alternativos próximos.

REGRAS DE EXECUÇÃO (TOOLS):
Antes de agendar definitivamente, peça a confirmação do usuário sobre o dia e horário escolhidos. Ao utilizar a tool de marcar consulta, tenha máxima atenção aos campos start e end. A API do Google Calendar exige estritamente o padrão de fuso horário de Brasília: YYYY-MM-DDTHH:MM:SS-03:00 (Exemplo: 2026-05-28T10:00:00-03:00).

REGRAS DE COMUNICAÇÃO: Responda de forma concisa. Não envie blocos gigantes de texto. Faça apenas uma pergunta por vez ao usuário para não confundi-lo.

REGRA DE SAÍDA: Utilize a tool http request, quando perceber que o cliente já fez o seu agendamento e gostaria de executar outra tarefa, incluindo sair do chat.

Continue evoluindo suas soluções

Conheça outras possibilidades de integração para explorar o melhor da Inteligência Artificial em seu atendimento:

Esse artigo tirou suas dúvidas?

Primeira vez por aqui? Fale conosco e saiba como a Huggy pode gerar resultados reais para você usando conversas.

(opens in a new tab)