É possível conectar o agente à Agenda do Google?
- Sim. A API do Google Calendar permite consultar disponibilidade e criar eventos; o agente precisa de uma integração autorizada para usar esses recursos durante a conversa.
- O modelo interpreta um pedido como marcar uma reunião na terça à tarde. A aplicação transforma esse pedido em consultas com data, duração e agenda definidas.
- Você precisa autorizar o acesso à conta ou compartilhar a agenda com a identidade usada pela integração, conforme o método de autenticação escolhido.
- Conectar o número ao WhatsApp não concede acesso à agenda. Antes de contratar ou configurar o fluxo, confirme se consulta, criação, remarcação e cancelamento estão implementados.
Como passar da pergunta para o compromisso marcado
- Peça o tipo de atendimento, a duração prevista e a preferência de horário. Quando a pessoa disser amanhã, confirme a data e o fuso que serão usados.
- Consulte os períodos ocupados e aplique as regras do negócio, como expediente, intervalo entre reuniões e antecedência mínima. Um espaço vazio não é automaticamente um horário oferecido.
- Apresente opções e solicite que a pessoa escolha uma delas. Repita data, horário e local ou modalidade antes de registrar o compromisso.
- Crie o evento na agenda correta e guarde seu identificador. Só informe que o horário foi marcado depois de verificar a resposta da integração; se houver erro, mantenha o pedido pendente.
Como evitar conflitos e alterações no evento errado
- Confira novamente o horário antes de gravar. Entre a consulta inicial e a escolha do cliente, outra pessoa pode ter ocupado o mesmo intervalo.
- Implemente uma reserva controlada na aplicação para pedidos simultâneos. Criar um evento no Google Calendar não impede, por si só, a existência de eventos sobrepostos.
- Associe cada pedido a um identificador único e consulte o registro antes de repetir uma tentativa. Isso ajuda a evitar que um webhook reenviado crie duas reuniões.
- Na remarcação, identifique o evento existente antes de atualizar a data. Se houver mais de um compromisso para o mesmo contato, peça esclarecimento em vez de escolher um por suposição.
Quais testes fazer antes de oferecer agendamento automático
- Use uma agenda de teste para simular um dia cheio e um horário fora do expediente. O agente deve explicar a indisponibilidade e apresentar opções permitidas.
- Simule perda de autorização ou falha de conexão com o Google. O cliente deve receber uma informação de pendência, sem confirmação fictícia de reserva.
- Teste dois pedidos para o mesmo horário e a repetição do mesmo evento de entrada. Confira os compromissos efetivamente criados e os registros usados para impedir duplicidade.
- Limite os dados gravados no título e na descrição do evento ao necessário para a equipe. Verifique também quem pode visualizar a agenda compartilhada e seus detalhes.
// Dado próprio ZX LAB
Na ZX LAB, usamos Claude Code para trabalhar com agentes no WhatsApp e automações que conectam serviços por APIs e webhooks. Parte desse trabalho envolve consultar informações antes de responder e conferir se a ação solicitada realmente aconteceu no sistema de destino. Esse procedimento também orienta o desenho de uma integração de agenda: interpretar o pedido no chat é uma etapa, enquanto verificar disponibilidade e registrar o compromisso exige acesso e validação no serviço conectado.