Este guia explica como configurar e utilizar a integração com o Google Calendar no Super Agentes, permitindo que seus agentes realizem agendamentos automáticos de reuniões durante as conversas.

Visão Geral

A integração com o Google Calendar permite que seus agentes:

  • Agendem reuniões automaticamente durante conversas
  • Ofereçam diferentes tipos de reuniões com durações personalizadas
  • Verifiquem disponibilidade em tempo real
  • Enviem convites diretamente para o calendário do usuário

Esta funcionalidade é especialmente útil para agentes de vendas (SDR), atendimento ao cliente, ou qualquer cenário onde o agendamento de reuniões seja necessário.

Quando Usar a Integração Nativa vs. Outras Integrações

Use a Integração Nativa do Google Calendar quando:

  • Você precisa de uma solução simples e direta
  • Não possui fluxos complexos de agendamento já configurados
  • Deseja uma configuração rápida sem ferramentas externas

Use Integrações Alternativas (Make, N8N) quando:

  • Já possui fluxos de agendamento configurados em outras ferramentas
  • Precisa de roteamento complexo entre agendas de diferentes vendedores
  • Necessita de integrações adicionais além do simples agendamento

Configurando a Integração com Google Calendar

Pré-requisitos

  • Uma conta Google
  • Acesso ao Google Cloud Console
  • Um agente configurado no Super Agentes

Passo 1: Configurar o Projeto no Google Cloud Console

  1. Acesse o Google Cloud Console
  2. Clique em “Começar Gratuitamente” (não se preocupe, não haverá custos para esta integração)
  3. Preencha as informações solicitadas (incluindo cartão de crédito, mas não será cobrado)
  4. Após criar sua conta, você será direcionado ao painel do Google Cloud

Passo 2: Configurar a API do Google Calendar

  1. No menu lateral esquerdo, clique em APIs e Serviços
  2. Clique em Ativar APIs e Serviços
  3. Pesquise por “Google Calendar API” e selecione-a
  4. Clique em Ativar para habilitar a API

Passo 3: Criar Credenciais

  1. No menu lateral esquerdo, clique em APIs e Serviços > Credenciais
  2. Clique em Criar Credenciais e selecione ID do Cliente OAuth
  3. Selecione Aplicativo da Web
  4. Dê um nome para o aplicativo (ex: “Super Agentes”)
  5. Em “Origens JavaScript autorizadas”, adicione o seguinte URL:
    https://superagentes.ai
    
  6. Em “URIs de redirecionamento autorizados”, adicione o seguinte URL:
    https://dash.superagentes.ai/api/integrations/google-calendar/callback/
    
  7. Clique em Criar
  8. Copie o ID do Cliente e o Segredo do Cliente que serão exibidos (você precisará deles mais tarde)

Passo 4: Configurar a Tela de Permissão OAuth

  1. No menu lateral esquerdo, clique em APIs e Serviços > Tela de permissão OAuth
  2. Selecione Externo e clique em Criar
  3. Preencha as informações básicas do aplicativo:
    • Nome do aplicativo: “Super Agentes”
    • Email de suporte: seu email
    • Logo: opcional
  4. Clique em Salvar e Continuar
  5. Na seção “Escopos”, você não precisa adicionar nada, apenas clique em Salvar e Continuar
  6. Na seção “Usuários de teste”, você não precisa adicionar nada, apenas clique em Salvar e Continuar
  7. Revise as informações e clique em Voltar para o Painel
  8. Importante: Clique em Publicar Aplicativo para mudar o status de “Teste” para “Produção”

Passo 5: Configurar a Integração no Super Agentes

  1. Acesse seu agente no Super Agentes
  2. Vá para a aba Ferramentas
  3. Role para baixo até encontrar Google Calendar e clique em Adicionar
  4. Cole o ID do Cliente e o Segredo do Cliente que você copiou anteriormente
  5. Configure os serviços de agendamento:
    • Clique em Adicionar Serviço
    • Dê um nome ao serviço (ex: “Reunião Curta”)
    • Defina a duração em minutos (ex: 15)
    • Adicione quantos serviços desejar (ex: “Reunião Longa” de 30 minutos)
  6. Clique em Salvar
  7. Você será redirecionado para a tela de autorização do Google
  8. Selecione sua conta Google e permita o acesso ao seu calendário
  9. Após a autorização, você será redirecionado de volta ao Super Agentes

Utilizando a Integração em Seus Agentes

Configurando o Acionamento da Ferramenta

Você pode configurar o acionamento da ferramenta de duas maneiras:

Opção 1: Nas Instruções do Agente

Adicione instruções específicas no prompt do seu agente para acionar o Google Calendar quando apropriado:

Quando o usuário demonstrar interesse em agendar uma reunião ou solicitar um horário para conversar, utilize a ferramenta Google Calendar para oferecer opções de agendamento.

Opção 2: Em um Estágio Específico

Crie um estágio dedicado para agendamento:

  1. Vá para a aba Estágios do seu agente
  2. Crie um novo estágio chamado “Agendamento”
  3. No campo Objetivo, defina: “Este estágio deve ser ativado quando o usuário demonstrar interesse em agendar uma reunião ou quando a conversa chegar ao ponto de agendamento.”
  4. No campo Instruções, inclua: “Utilize a ferramenta Google Calendar para oferecer opções de agendamento ao usuário. Pergunte qual tipo de reunião o usuário prefere e ofereça as opções disponíveis.”

Fluxo de Agendamento

Quando acionado, o fluxo de agendamento seguirá estas etapas:

  1. O agente detecta a intenção de agendamento
  2. O agente oferece os tipos de reunião disponíveis
  3. O usuário seleciona o tipo de reunião desejado
  4. O agente solicita informações adicionais (nome, e-mail)
  5. O agente verifica a disponibilidade no calendário
  6. O usuário confirma o horário escolhido
  7. O agente agenda a reunião e envia o convite

Exemplo de Conversa

Usuário: Gostaria de agendar uma demonstração do produto.

Agente: Claro! Posso ajudar você a agendar uma demonstração. Temos duas opções disponíveis:
1. Reunião Curta (15 minutos) - Para uma visão geral rápida
2. Reunião Longa (30 minutos) - Para uma demonstração detalhada

Qual opção você prefere?

Usuário: Prefiro a reunião longa de 30 minutos.

Agente: Ótima escolha! Para agendar a reunião, preciso de algumas informações:
Qual é o seu nome completo?

Usuário: João Silva

Agente: Obrigado, João. E qual é o seu e-mail para enviar o convite da reunião?

Usuário: joao.silva@exemplo.com

Agente: Obrigado! Estou verificando a disponibilidade para uma reunião de 30 minutos.
Temos horários disponíveis nos próximos dias. Que tal amanhã às 14h?

Usuário: Amanhã às 14h está perfeito.

Agente: Ótimo! Agendei uma reunião de demonstração de 30 minutos para amanhã às 14h.
Você receberá um convite por e-mail em breve com os detalhes e o link da reunião.
Há mais alguma coisa em que eu possa ajudar?

Personalizando a Integração

Adicionando Mais Tipos de Reunião

Você pode adicionar quantos tipos de reunião desejar:

  1. Vá para a aba Ferramentas do seu agente
  2. Localize a ferramenta Google Calendar e clique em Editar
  3. Clique em Adicionar Serviço
  4. Configure o novo tipo de reunião com nome e duração
  5. Clique em Salvar

Personalizando as Instruções de Agendamento

Para personalizar como seu agente oferece e gerencia agendamentos, modifique as instruções no prompt do sistema ou no estágio de agendamento:

Ao oferecer opções de agendamento, siga estas diretrizes:
- Para leads qualificados, ofereça a "Reunião com Especialista" de 45 minutos
- Para consultas iniciais, ofereça a "Reunião Introdutória" de 15 minutos
- Sempre verifique se o horário comercial (9h às 18h) está sendo respeitado
- Evite agendar reuniões em finais de semana
- Deixe pelo menos 15 minutos de intervalo entre reuniões

Solução de Problemas

Perguntas Frequentes

Próximos Passos

Após configurar a integração com o Google Calendar, você pode: