Como integrar com Google Calendar
Nível: Intermediário
Tempo de leitura: 7 min
Plano necessário: Todos os planos
O que o agente pode fazer com Google Calendar
Com a integração ativa, o agente consegue:
- Verificar disponibilidade: checar horários livres em um ou mais calendários
- Criar eventos: agendar consultas, reuniões, visitas diretamente no calendário
- Listar eventos: informar ao cliente os próximos compromissos
- Cancelar ou reagendar: remover ou mover eventos existentes
- Enviar convites: adicionar o e-mail do cliente como participante
Isso significa que o agente pode fazer um agendamento completo, do "quero marcar uma consulta" ao "confirmado, você receberá um convite", sem intervenção humana.
Pré-requisitos
- Conta Google com o calendário que será usado pela integração
- Permissões de editor no calendário (não apenas visualizador)
Como conectar
Passo 1: Acesse as integrações
- No painel da Wevi, acesse Conectores → Google Calendar
- Clique em "Conectar conta Google"
Passo 2: Autorize o acesso
Você será redirecionado para a tela de autenticação do Google. Faça login com a conta que contém o calendário que o agente deve usar.
Na tela de permissões, a Wevi solicita acesso para:
- Visualizar e editar eventos do calendário
- Ver informações básicas do perfil
Clique em "Permitir".
Passo 3: Selecione o calendário
Após a autenticação, selecione quais calendários da conta o agente pode acessar. Você pode selecionar múltiplos calendários, útil para verificar disponibilidade em vários médicos ou salas ao mesmo tempo.
Passo 4: Vincule ao agente
- Acesse o agente que fará os agendamentos
- Vá na aba Inteligência, seção Conectores
- Marque a conexão do Google Calendar que você criou
Configurando o comportamento no prompt
Para que o agente use o calendário de forma inteligente, instrua-o no prompt:
AGENDAMENTO
Quando o cliente quiser marcar uma consulta:
1. Pergunte o tipo de consulta e o médico preferido (se houver)
2. Use o Google Calendar para verificar horários disponíveis nos próximos 7 dias
3. Ofereça 3 opções de horário
4. Confirme nome completo, telefone e e-mail do paciente
5. Crie o evento com o título "[Especialidade] - [Nome do Paciente]"
6. Adicione o e-mail do paciente como convidado
7. Confirme o agendamento e informe que um convite será enviado por e-mail
IMPORTANTE:
- Não ofereça horários fora de 08h às 18h em dias úteis
- Consultas têm duração de 50 minutos; bloqueie esse intervalo no calendário
- Se não houver disponibilidade em 7 dias, ofereça as opções mais próximas
Gerenciando múltiplos profissionais
Se você tem múltiplos médicos, advogados ou prestadores de serviço, pode:
Opção 1: Um calendário por profissional Cada profissional usa um calendário separado na mesma conta Google. O agente verifica todos e mostra disponibilidade por profissional.
Opção 2: Um agente por profissional Cada profissional tem seu próprio agente, com acesso apenas ao seu calendário. O orquestrador direciona o cliente para o agente do profissional escolhido.
Opção 3: Conta Google compartilhada Um único calendário usado por toda a equipe. Menos granularidade, mas mais simples de gerenciar.
Testando a integração
Após configurar, faça um teste completo:
- Inicie uma conversa com o agente
- Solicite um agendamento
- Verifique se o agente consulta a disponibilidade corretamente
- Confirme o agendamento
- Abra o Google Calendar e verifique se o evento foi criado
Se o evento aparecer no calendário com as informações corretas, a integração está funcionando.
Problemas comuns
"O agente não encontra horários disponíveis" Verifique se o calendário selecionado está correto e se há horários livres no período consultado. O agente busca disponibilidade; se o calendário estiver cheio, ele informa corretamente.
"O evento foi criado com informações erradas" Ajuste o prompt para especificar o formato exato do evento: título, duração, convidados.
"A integração parou de funcionar" Tokens de autenticação do Google expiram periodicamente. Acesse Conectores → Google Calendar e reconecte a conta.
"O agente está agendando fora do horário permitido" Instrua explicitamente no prompt os horários e dias de funcionamento. O agente respeita as regras do prompt.