> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superagentes.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# 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
1. Acesse o [Google Cloud Console](https://console.cloud.google.com/)
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
**Possíveis causas e soluções:**
* Verifique se o status do aplicativo no Google Cloud Console está como "Em produção" (não em "Teste")
* Se estiver em "Teste", clique em **Publicar Aplicativo** para mudar para "Produção"
* Certifique-se de que os URIs de redirecionamento estão configurados corretamente
* Tente revogar o acesso e configurar novamente a integração
**Possíveis causas e soluções:**
* Verifique se você autorizou o acesso ao calendário correto
* Certifique-se de que a integração foi configurada corretamente
* Verifique se o e-mail do usuário foi digitado corretamente
* Tente revogar o acesso e configurar novamente a integração
**Possíveis causas e soluções:**
* Verifique se as instruções para usar o Google Calendar estão claras no prompt ou estágio
* Certifique-se de que a ferramenta está ativada no agente
* Teste com comandos diretos como "Quero agendar uma reunião"
* Verifique se você salvou as configurações após adicionar a ferramenta
## Perguntas Frequentes
Não, a integração com o Google Calendar é gratuita. O Google Cloud Platform oferece uma cota gratuita que é mais que suficiente para uso normal.
Atualmente, o Super Agentes oferece integração nativa apenas com o Google Calendar. Para outros sistemas, você pode usar ferramentas como Make ou N8N.
Sim, você pode configurar a integração separadamente para cada agente, conectando-os a diferentes calendários Google.
Vá para a aba Ferramentas do seu agente, localize o Google Calendar e clique em Remover. Você também deve revogar o acesso no Google Cloud Console.
Atualmente, as informações básicas são preenchidas automaticamente. Para personalizações avançadas, considere usar integrações alternativas como Make ou N8N.
Sim, a integração funciona perfeitamente com contas pessoais do Google e contas do Google Workspace.
## Próximos Passos
Após configurar a integração com o Google Calendar, você pode:
Use estágios para controlar quando oferecer agendamentos
Configure subagentes especializados para diferentes tipos de reuniões
Adicione bases de conhecimento para melhorar as respostas durante agendamentos
Conheça outras ferramentas disponíveis para seus agentes