Agenda Google & Booking

O Dexter integra com o Google Calendar para que seus assistentes possam consultar disponibilidade e agendar reuniões diretamente na conversa do WhatsApp. Toda a negociação de horário acontece de forma natural, sem que o cliente precise sair do chat.

Quando usar

  • Agendamento de consultas (clínicas, escritórios, profissionais de saúde)
  • Aulas experimentais (academias, escolas, cursos)
  • Reuniões de vendas e discovery calls
  • Demonstrações de produto
  • Qualquer cenário em que o cliente precise reservar um horário com você

Conectar Google Calendar

Planos: a integração com Google Calendar está disponível em todos os planos (Starter, Professional e Scale).
1
Acesse o dashboard

Vá até Configurações → Integrações no painel do Dexter.

2
Conecte sua conta Google

Clique em Conectar Google Calendar e autorize o acesso na janela que será aberta.

3
Selecione o calendário

Escolha qual calendário da sua conta Google será usado para consultas e agendamentos. Se nenhum for selecionado, o calendário principal (primary) será usado automaticamente.

4
Ative o agendamento no assistente

Em Assistentes, habilite a opção Agendamento para que o assistente possa oferecer horários durante as conversas.

Consultar disponibilidade

Com a integração ativa, o assistente verifica automaticamente os horários livres na sua agenda durante a conversa. Ele considera apenas dias úteis, respeita os horários configurados e ignora slots que já estejam ocupados.

Por padrão, o Dexter sugere slots de 45 minutos nos próximos 3 dias úteis, em horários pré-definidos (10h, 15h, 16h e 17h). Esses valores podem ser ajustados via variáveis de ambiente.

O assistente sempre exige pelo menos 2 horas de antecedência para qualquer agendamento, garantindo que nenhum slot "em cima da hora" seja oferecido.

Agendar via conversa

1
O cliente manifesta interesse

O assistente identifica a intenção de agendamento e consulta os slots disponíveis na sua agenda.

2
Negociação de horário

O assistente apresenta as opções livres e o cliente escolhe a que preferir. Se nenhuma servir, o assistente pode buscar mais datas.

3
Confirmação e criação do evento

Ao confirmar, o Dexter cria o evento no Google Calendar com os dados do cliente (nome, e-mail, telefone). Um link do Google Meet é gerado automaticamente.

4
Confirmação por WhatsApp

O cliente recebe a confirmação do agendamento diretamente na conversa, incluindo data, horário e link da reunião.

Via MCP

Se você conecta agentes externos ao Dexter via MCP, as seguintes tools estão disponíveis para interagir com a agenda:

Tool Tipo Descrição
dexter_calendar_status Leitura Verifica se a instância tem Google Calendar configurado e acessível. Não devolve tokens.
dexter_calendar_freebusy Leitura Retorna as janelas ocupadas da agenda em um intervalo (time_min / time_max em ISO 8601).
dexter_calendar_slots Leitura Lista os slots disponíveis nos próximos dias úteis (45 min cada). Aceita later: true para ver mais datas.
dexter_calendar_book Envio Cria um evento na agenda e devolve o link. Recusa automaticamente se o horário estiver ocupado.

Exemplo: agendar com dexter_calendar_book

{
  "confirm_booking": true,
  "start": "2026-09-26T14:00:00-03:00",
  "end": "2026-09-26T14:45:00-03:00",
  "summary": "Limpeza de pele - Maria Silva",
  "attendee_email": "maria@exemplo.com",
  "phone": "5511999999999"
}
Campos obrigatórios: confirm_booking (deve ser true), start, end, summary, attendee_email e phone (com DDI, ex.: 5511...). Opcionalmente, description adiciona texto ao corpo do evento.

Exemplo de resposta

{
  "booked": true,
  "link": "https://calendar.google.com/event?eid=...",
  "email": "maria@exemplo.com",
  "phone": "5511999999999"
}

Caso de uso: Clínica de estética

Quem Mensagem
Cliente Quero agendar uma limpeza de pele
Assistente Consulta os slots disponíveis na agenda e oferece três opções nos próximos dias úteis
Cliente Pode ser sexta às 15h
Assistente Confirma o horário, cria o evento no Google Calendar e envia a confirmação com data, hora e link do Meet

Todo o fluxo acontece dentro do WhatsApp, sem redirecionamentos ou formulários externos.

Erros comuns

Erro Causa Solução
google_calendar_not_enabled_for_instance O Google Calendar não está conectado ou o agendamento não foi habilitado no assistente. Conecte a conta Google no dashboard e ative a opção de agendamento.
slot_busy O horário escolhido já foi reservado por outro evento. Consulte novamente os slots disponíveis com dexter_calendar_slots.
google_calendar_unavailable A API do Google Calendar está temporariamente inacessível ou o token expirou. Tente novamente em alguns minutos. Se persistir, reconecte a conta Google no dashboard.
google_calendar_book_failed A criação do evento falhou (permissão insuficiente ou erro da API). Verifique se a conta Google ainda tem acesso ao calendário selecionado.

Permissões e limites

  • Planos: todos (Starter, Professional e Scale)
  • Leitura: o assistente pode consultar disponibilidade (dexter_calendar_status, dexter_calendar_freebusy, dexter_calendar_slots)
  • Escrita: o assistente pode criar eventos (dexter_calendar_book)
  • Limitações: o assistente não cancela, edita ou remove eventos existentes
  • Segurança: dexter_calendar_book exige confirm_booking: true para efetivamente criar o evento — chamadas sem essa flag são recusadas
  • Antecedência mínima: 2 horas em relação ao horário atual
  • Duração padrão dos slots: 45 minutos
  • Dias úteis: somente segunda a sexta (fins de semana são ignorados)
Tokens e credenciais do Google nunca são expostos nas respostas das tools MCP. Apenas o status da conexão e os horários são retornados.

Links relacionados