Integrando o Google Calendar ao Super Agentes
Guia completo para configurar e utilizar a integração com Google Calendar para agendamentos automáticos nos seus agentes
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
- Acesse o Google Cloud Console
- Clique em “Começar Gratuitamente” (não se preocupe, não haverá custos para esta integração)
- Preencha as informações solicitadas (incluindo cartão de crédito, mas não será cobrado)
- Após criar sua conta, você será direcionado ao painel do Google Cloud
Passo 2: Configurar a API do Google Calendar
- No menu lateral esquerdo, clique em APIs e Serviços
- Clique em Ativar APIs e Serviços
- Pesquise por “Google Calendar API” e selecione-a
- Clique em Ativar para habilitar a API
Passo 3: Criar Credenciais
- No menu lateral esquerdo, clique em APIs e Serviços > Credenciais
- Clique em Criar Credenciais e selecione ID do Cliente OAuth
- Selecione Aplicativo da Web
- Dê um nome para o aplicativo (ex: “Super Agentes”)
- Em “Origens JavaScript autorizadas”, adicione o seguinte URL:
- Em “URIs de redirecionamento autorizados”, adicione o seguinte URL:
- Clique em Criar
- 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
- No menu lateral esquerdo, clique em APIs e Serviços > Tela de permissão OAuth
- Selecione Externo e clique em Criar
- Preencha as informações básicas do aplicativo:
- Nome do aplicativo: “Super Agentes”
- Email de suporte: seu email
- Logo: opcional
- Clique em Salvar e Continuar
- Na seção “Escopos”, você não precisa adicionar nada, apenas clique em Salvar e Continuar
- Na seção “Usuários de teste”, você não precisa adicionar nada, apenas clique em Salvar e Continuar
- Revise as informações e clique em Voltar para o Painel
- Importante: Clique em Publicar Aplicativo para mudar o status de “Teste” para “Produção”
Passo 5: Configurar a Integração no Super Agentes
- Acesse seu agente no Super Agentes
- Vá para a aba Ferramentas
- Role para baixo até encontrar Google Calendar e clique em Adicionar
- Cole o ID do Cliente e o Segredo do Cliente que você copiou anteriormente
- 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)
- Clique em Salvar
- Você será redirecionado para a tela de autorização do Google
- Selecione sua conta Google e permita o acesso ao seu calendário
- 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:
Opção 2: Em um Estágio Específico
Crie um estágio dedicado para agendamento:
- Vá para a aba Estágios do seu agente
- Crie um novo estágio chamado “Agendamento”
- 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.”
- 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:
- O agente detecta a intenção de agendamento
- O agente oferece os tipos de reunião disponíveis
- O usuário seleciona o tipo de reunião desejado
- O agente solicita informações adicionais (nome, e-mail)
- O agente verifica a disponibilidade no calendário
- O usuário confirma o horário escolhido
- O agente agenda a reunião e envia o convite
Exemplo de Conversa
Personalizando a Integração
Adicionando Mais Tipos de Reunião
Você pode adicionar quantos tipos de reunião desejar:
- Vá para a aba Ferramentas do seu agente
- Localize a ferramenta Google Calendar e clique em Editar
- Clique em Adicionar Serviço
- Configure o novo tipo de reunião com nome e duração
- 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:
Solução de Problemas
Perguntas Frequentes
Próximos Passos
Após configurar a integração com o Google Calendar, você pode:
Configurar Estágios
Use estágios para controlar quando oferecer agendamentos
Adicionar Subagentes
Configure subagentes especializados para diferentes tipos de reuniões
Conectar Conhecimentos
Adicione bases de conhecimento para melhorar as respostas durante agendamentos
Explorar Outras Ferramentas
Conheça outras ferramentas disponíveis para seus agentes