WhatsApp e Google Calendar: automatizar reservas sem duplicar compromissos
Publicado em 2026-11-14 por frfrand
Fluxo de disponibilidade, confirmação, reagendamento e cancelamento com WhatsApp e Google Calendar sem reservas duplicadas.
# WhatsApp e Google Calendar: automatizar reservas sem duplicar compromissos
Dois clientes podem perguntar pelo mesmo horário ao mesmo tempo. Consultar o Google Calendar e depois inserir um evento sem proteger o recurso permite que ambos os processos vejam o horário livre. A API do calendário permite consultar e gravar eventos, mas uma verificação prévia não substitui um bloqueio ou restrição transacional no sistema de reservas quando a simultaneidade importa.
Arquitetura mínima
O WhatsApp recebe a solicitação via webhook; um back-end identifica o cliente e o fuso horário; um serviço de disponibilidade combina horários comerciais, intervalos e eventos ocupados; um banco de dados gerencia o status da reserva; o Google Calendar reflete eventos confirmados. O banco de dados mantém identificadores de cliente, recurso, hora de início e fim, status, calendar_id e event_id.
Fluxo completo
- Receber e validar a mensagem, deduplicando pelo ID do provedor.
- Proporcionar horários calculados para um calendário e recurso específicos.
- Solicitar confirmação e manter uma reserva temporária com expiração definida.
- Confirmar atomicamente a exclusividade do horário no banco de dados.
- Criar ou atualizar o evento no Calendar e salvar o identificador remoto.
- Enviar confirmação apenas após conhecer o resultado; registrar erros para reconciliação.
Evitar conflitos
A regra de exclusividade depende do negócio: mesmo profissional, sala ou equipamento. Para PostgreSQL, uma restrição de exclusão sobre intervalos de tempo é útil quando reservas confirmadas do mesmo recurso não devem se sobrepor. Não baseie a prevenção apenas em cache. As retenções temporais devem expirar e as tentativas repetidas devem reutilizar a mesma chave de operação.
Reagendamentos e cancelamentos
Use um estado explícito: pendente, confirmada, alteração pendente, cancelada. Reagendar implica reservar o novo horário de forma segura antes de liberar o anterior, com compensação se uma etapa falhar. Cancelar deve manter uma referência auditável, atualizar o evento remoto e emitir uma única notificação. Se o Calendar não responder, marque a sincronização como pendente e reconcilie; nunca anuncie uma mudança que não foi aplicada.
Fuso horário e lembretes
Salve datas em UTC e o fuso IANA do negócio, como Europe/Lisbon. Apresente o horário local em cada mensagem. Considere mudanças de horário de verão e calendários com diferentes permissões. Os lembretes de saída devem respeitar preferências e regras de modelos do WhatsApp.
Testes antes do lançamento
Simula solicitações simultâneas, webhooks duplos, falha ao criar evento, reconexão após timeout, cancelamento repetido e mudança de horário de verão. Para aprofundar na exclusividade de reservas, consulte reservas duplicadas em PostgreSQL e webhooks seguros.
Perguntas frequentes
É necessário construir tudo sob medida? Nem sempre. Comece com o processo mínimo e adicione integrações quando existir uma necessidade demonstrável.
Como evitar erros repetidos? Com identificadores estáveis, validações, registros e testes de retentativas.
Quando intervir manualmente? Diante de dados ambíguos, erros persistentes e ações de alto impacto.
Conclusão
Documente o processo e teste suas falhas antes de ampliar o volume. Em ArduMaker você pode explorar a infraestrutura e as integrações aplicáveis a este cenário.