Pular para o conteúdo

Sistema de agenda e prontuário feito sob medida

O software antigo não conversava com o atendente de IA. O sistema novo agenda sozinho, nunca marca dois pacientes no mesmo horário e já roda em duas clínicas.

Clínicas de saúde. Em produção. Desde jul. de 2026.

2
clínicas usando o mesmo sistema
Zero
pacientes marcados no mesmo horário
1.074
testes automáticos antes de cada atualização

O problema

O consultório já tinha um atendente de IA no WhatsApp, mas o sistema de prontuário não deixava nenhum outro programa ler ou marcar consultas. O atendente não enxergava a agenda.

Antes de construir, testei a migração para um sistema de prontuário do mercado. O teste foi cancelado: a conexão era lenta e limitada. Ficar sem integração custava mais do que ter um sistema próprio.

Na prática

Agenda da semana em calendário com as consultas coloridas por status e as janelas livres para encaixe
Agenda da semana: consultas por status, janelas livres para encaixe e filtro por profissional.
Pré-reservas feitas pelo atendente de IA no WhatsApp, cada uma com prazo de expiração e botões para a equipe confirmar ou recusar
O atendente de IA pré-reserva o horário no WhatsApp; a equipe confirma o pagamento ou libera a vaga.
Números da agenda com consultas realizadas, faltas, quem marcou (agente ou equipe) e horários livres
Números da agenda: realizadas, faltas, quanto o agente marcou e o que dá para oferecer hoje.
Pré-reservas do atendente de IA vistas no celular
As pré-reservas também no celular.

O resultado

  • Em uso em duas clínicas, com o mesmo sistema.
  • O atendente de IA agenda, confirma e remarca sem passar pela secretária.
  • Cada atualização só vai ao ar depois de passar por 1.074 testes automáticos.

O que ficou de aprendizado

Quando quem mais usa o sistema é um atendente de IA, toda função nova nasce pensando nele, e não só na tela da equipe.
Em saúde, o sistema cresce por etapas: a agenda veio primeiro, já com espaço previsto para o prontuário.
Detalhes técnicosArquitetura, desafios e ferramentas, para quem é da área.
Quem fala com o sistemaarraste para o lado para ver tudo
Painel da equipemédico, secretária, gestãoAgente de IAWhatsApp, via n8nAPI RESTescopos, idempotênciaPostgreSQLGiST, triggers, hashGoogle Agendadois sentidosWebhookseventos de volta ao agenteBackup cifradocom teste de restauração
PessoasIACódigoDadosExterno

Painel da equipe e agente de IA usam a mesma API. A regra que impede conflito de horário mora no banco.

Agenda

  • Calendário de dia, semana, mês e lista, com janelas de atendimento abertas e fechadas clicando na grade.
  • Pré-reserva com validade: o horário fica segurado e se libera sozinho.
  • Google Agenda e sala de vídeo nos dois sentidos, e webhooks de eventos para o agente.

Prontuário

  • Permissão clínica separada da administrativa.
  • Registro assinado não se apaga nem se altera: o que existe é retificação com autor e motivo.
  • Log de acesso encadeado por hash, para provar que ninguém mexeu no histórico.
  • Prescrições com catálogo, modelos e receitas programadas para assinar em lote.
  • Assistente de IA dentro do prontuário: o médico vê exatamente o texto que a IA vai receber, o contexto vai sem identificadores e o trecho só entra no rascunho por ação dele.

Para quem opera é máquina

  • API REST com chaves por escopo (leitura, escrita, admin), idempotência nas escritas e limite de requisições.
  • Modo de simulação para testar escrita sem gravar.
  • O contrato da API nasceu do lado do agente: o que ele precisava virou o documento de integração.
  • Telas por função: médico, secretária e gestão entram cada um no próprio trabalho do dia.

Operação

  • Um único código atende várias instalações, cada uma com servidor e banco próprios e identidade visual calculada a partir de uma cor (OKLCH, com contraste acessível garantido).
  • Deploy automático a cada merge, uma instalação por vez: a primeira serve de canário.
  • Backup cifrado com teste de restauração, vigia externo de saúde e segundo fator no login.
  • Importadores do sistema anterior.

Desafios

  • Constraint de exclusão GiST no Postgres: duas consultas no mesmo horário são impossíveis no banco, não só na tela. Uma ganha, a outra recebe 409.
  • Triggers que impedem apagar registro assinado.
  • Schema separado para o arquivo histórico importado.
  • LGPD de verdade: exportar os dados de um paciente, anonimizar mantendo o histórico e trilha de auditoria.

Decisão difícil

Construir em vez de comprar

Ferramenta pronta não expunha o que o agente precisava. O piloto com um sistema de mercado provou isso na prática, e o custo de construir ficou menor que o de continuar sem integração.

Ferramentas: Next.js 15, TypeScript estrito, PostgreSQL 16, Prisma, Docker Compose, GitHub Actions, Google Calendar API.