Mapa de dados obrigatório: quais campos do prontuário integrar para agendamentos automáticos confiáveis
Um guia técnico e operacional para definir os campos do prontuário, da agenda e das regras clínicas que a automação precisa consultar antes de confirmar um horário.
Conheça boas práticas de automação em saúde
Neste artigo9 seções
- Por que o mapa de dados obrigatório é a base do agendamento automático
- Quais campos do prontuário são essenciais para confirmar a disponibilidade
- Como mapear preparo, restrições clínicas e requisitos por tipo de serviço
- Como priorizar campos quando há múltiplos prontuários e agendas
- Exemplo de payload e regras de validação para evitar agendamentos incorretos
- Como a Auris usa o mapa de dados para reduzir erros de contexto
- Checklist de implantação e ajuste contínuo do mapa de dados
- Erros frequentes ao integrar prontuário e agendador automático
- Como saber se o mapa de dados está funcionando
Por que o mapa de dados obrigatório é a base do agendamento automático
O mapa de dados obrigatório define quais informações do prontuário, da agenda e do cadastro precisam ser lidas ou atualizadas para que um agendamento automático seja confiável. Sem essa definição, a IA pode encontrar um horário livre, mas ignorar uma restrição clínica, selecionar o profissional inadequado ou confirmar um exame sem pedido válido.
A questão não é apenas integrar muitos campos. É estabelecer a finalidade de cada dado, sua origem, frequência de atualização, formato permitido e consequência quando ele estiver ausente. Um telefone identifica o paciente, enquanto a modalidade do atendimento determina se aquele horário pode ser usado; os dois têm pesos diferentes na decisão.
Em uma clínica de diagnóstico, por exemplo, o agendador precisa relacionar procedimento, unidade, equipamento, duração, preparo e disponibilidade. Em uma consulta ambulatorial, a especialidade, o profissional, o convênio e o tipo de primeira consulta podem alterar completamente os horários exibidos.
A automação deve confirmar somente quando os dados críticos estiverem consistentes. Quando faltar informação ou existir conflito, o fluxo precisa solicitar esclarecimento ou encaminhar a conversa, seguindo critérios definidos no guia de fluxos de escalonamento 24/7 em clínicas.
Quais campos do prontuário são essenciais para confirmar a disponibilidade
O primeiro grupo é formado pelos dados de identificação e correspondência do paciente: identificador único, nome completo, data de nascimento, telefone, e-mail, convênio e unidade de atendimento. O identificador interno deve ser a chave principal, porque nome e telefone podem aparecer duplicados ou mudar ao longo do tempo.
O segundo grupo reúne os dados do serviço solicitado. Mapeie código e nome padronizado do procedimento, especialidade, subespecialidade, tipo de atendimento, duração prevista, modalidade, unidade e profissional habilitado. A descrição que o paciente usa no WhatsApp, como “ultrassom da barriga”, precisa ser relacionada a uma opção cadastrada no sistema, sem permitir que a IA invente um procedimento equivalente.
A agenda exige outro conjunto de campos: identificador do recurso, profissional, sala, equipamento, unidade, data e hora inicial, data e hora final, fuso horário, status do compromisso e origem da reserva. O status deve diferenciar horário livre, pré-reserva, confirmado, cancelado, bloqueado e indisponível por manutenção.
Também entram nesse núcleo as regras de elegibilidade. O sistema deve saber se o atendimento aceita determinado convênio, faixa etária, modalidade, sexo quando clinicamente pertinente, encaminhamento, pedido médico ou retorno dentro de uma janela definida.
Para validar a integração, teste não apenas a leitura de horários, mas também a atualização após uma reserva, cancelamento ou bloqueio feito por um recepcionista. O checklist técnico de sincronização em tempo real entre IA, prontuário e agenda ajuda a organizar esses cenários.
Como mapear preparo, restrições clínicas e requisitos por tipo de serviço
- ✓Consultas médicas: integre especialidade, tipo de consulta, profissional habilitado, duração, faixa etária atendida, modalidade, convênio, unidade e necessidade de retorno. A regra deve impedir que uma consulta de retorno seja marcada como primeira avaliação quando os fluxos e tempos forem diferentes.
- ✓Exames laboratoriais: relacione o procedimento ao preparo, período de jejum, horário recomendado, coleta domiciliar ou presencial, necessidade de pedido médico, materiais exigidos e restrições de idade. O texto do preparo deve vir de uma fonte aprovada pela clínica, com data de revisão e versão identificável.
- ✓Diagnóstico por imagem: mapeie equipamento, região anatômica, contraste, alergias ou condições que exigem avaliação humana, tempo de sala, autorização do convênio e instruções específicas. Um horário livre no equipamento não significa que o paciente esteja apto para aquele exame.
- ✓Odontologia: considere procedimento, profissional, duração, sala, necessidade de avaliação inicial e eventual sequência de sessões. O agendador deve evitar oferecer um procedimento que dependa de uma consulta anterior ainda não realizada.
- ✓Hospitais e centros maiores: acrescente unidade, setor, recurso, regras de prioridade, janela de atendimento, perfil do paciente e canal de transferência. Quanto maior a operação, mais necessário é separar disponibilidade de agenda de elegibilidade clínica.
- ✓Todos os serviços: registre responsável pela regra, data da última revisão, fonte do conteúdo e ação de contingência. Se o preparo estiver desatualizado ou incompleto, a conversa deve ser interrompida antes da confirmação e encaminhada para uma pessoa.
Como priorizar campos quando há múltiplos prontuários e agendas
- 1
Classifique o impacto do campo
Marque como crítico todo dado cuja ausência possa gerar conflito, risco clínico, cobrança indevida ou deslocamento perdido. Identificador do paciente, procedimento, unidade, profissional, horário e status da agenda normalmente entram nessa categoria.
- 2
Separe leitura, escrita e consulta
Alguns campos servem apenas para orientar a conversa, enquanto outros precisam ser gravados no prontuário ou na agenda. Defina se a automação consulta, cria, altera ou apenas registra cada informação, evitando permissões mais amplas do que o necessário.
- 3
Escolha a fonte de verdade
Para cada campo, indique qual sistema prevalece quando houver divergência. A agenda deve ser a referência para disponibilidade, o cadastro financeiro pode governar convênios e o sistema clínico pode concentrar pedidos e históricos.
- 4
Defina a atualização aceitável
Disponibilidade, bloqueios e cancelamentos exigem atualização próxima do tempo real. Dados menos voláteis, como instruções institucionais, podem seguir um ciclo de revisão, desde que a versão publicada seja identificável.
- 5
Crie fallback para dado ausente
O fallback pode pedir uma informação ao paciente, oferecer outra modalidade ou transferir para a recepção. Nunca preencha um campo crítico por inferência quando a consequência for confirmar um serviço inadequado.
- 6
Faça a matriz por sistema e unidade
Em uma operação com Feegow, Amplimed, Prodoctor ou outros sistemas, registre o nome equivalente do campo, formato, código e regra de conversão em cada origem. A matriz deve mostrar também quais unidades estão habilitadas para cada procedimento.
Exemplo de payload e regras de validação para evitar agendamentos incorretos
Um payload de disponibilidade precisa carregar mais do que data e hora. Um modelo conceitual pode conter: identificador do horário, procedimento, profissional, unidade, recurso, início, fim, modalidade, convênios aceitos e regras de elegibilidade. Os nomes abaixo são ilustrativos e devem ser adaptados ao contrato da API usada pela clínica.
{
"horario_id": "A-83921",
"procedimento_codigo": "IMG-042",
"unidade_id": "UN-03",
"profissional_id": "MED-117",
"recurso_id": "EQUIP-08",
"inicio": "2026-09-10T14:00:00-03:00",
"fim": "2026-09-10T14:45:00-03:00",
"modalidade": "presencial",
"convenios": ["particular", "CONV-22"],
"requer_pedido": true,
"status": "disponivel",
"versao_regras": "2026-08-28"
}
Antes de confirmar, implemente validações de identidade, disponibilidade, compatibilidade e persistência. A identidade confirma se o paciente correto está sendo associado; a disponibilidade verifica se o horário continua livre; a compatibilidade cruza procedimento, unidade, recurso e requisitos; a persistência confirma que a reserva foi gravada e recebeu um identificador.
Para exames que exigem pedido, o fluxo deve verificar a presença e a validade do pedido conforme a política da instituição. Se a API não retornar esse dado, a IA deve informar que precisa de conferência, em vez de afirmar que o agendamento está liberado.
Use também uma proteção contra concorrência. Entre a consulta de disponibilidade e a gravação da reserva, outro canal pode ocupar o horário. Por isso, a confirmação deve depender de uma resposta final do sistema de agenda, com tratamento específico para conflito e nova consulta de opções.
A Lei Geral de Proteção de Dados no portal do Planalto orienta o tratamento de dados pessoais, e a página da ANPD sobre segurança da informação reúne referências para medidas de proteção. O mapa deve incluir finalidade, controle de acesso, retenção e registro de operações, não apenas nomes de campos.
Como a Auris usa o mapa de dados para reduzir erros de contexto
Depois de definir o mapa, a implementação precisa conectar cada campo à etapa correta da conversa. A Auris trabalha com integrações nativas com Feegow, Amplimed e mais de 11 sistemas de prontuário e agenda, incluindo Clinicorp, Medware, Visual Asa, Prodoctor, Amigo e Clínica nas Nuvens. O objetivo é consultar e registrar informações no ambiente que a clínica já utiliza.
Na arquitetura Orchestra, um agente maestro coordena agentes especializados para interpretar a intenção, consultar regras, verificar agenda e conduzir a confirmação. Essa separação reduz o risco de uma única resposta conversacional ignorar uma condição clínica ou misturar dados de serviços diferentes.
Durante o onboarding de 14 dias, o mapa é ajustado com exemplos reais da operação, exceções da agenda e validações da equipe. O acompanhamento deve observar indicadores como conflitos de horário, agendamentos interrompidos por falta de dado, retrabalho da recepção e quantidade de reservas que exigiram correção manual.
Os resultados variam conforme qualidade cadastral, volume e complexidade do fluxo. Entre clientes da Auris, há referências de redução de até 90% do trabalho de atendimento no WhatsApp, aumento de agendamentos de até 40% e mais de 35% da demanda atendida fora do horário comercial, sempre como métricas observadas em operações específicas, não como garantia.
A integração também deve cobrir pacientes que param de responder e pessoas que faltam. Um CRM conversacional pode usar o status do agendamento, última interação e motivo da pendência para selecionar uma mensagem de retomada, sem criar uma nova reserva antes de consultar a agenda.
Checklist de implantação e ajuste contínuo do mapa de dados
- 1
Inventarie os sistemas e serviços
Liste prontuários, agendas, unidades, canais e responsáveis. Para cada serviço, registre onde vivem os códigos, horários, pedidos, preparos, convênios e informações de contato.
- 2
Escolha dez cenários prioritários
Comece pelos fluxos que concentram volume ou retrabalho, como primeira consulta, retorno, coleta, exame com preparo e reagendamento. Inclua pelo menos um caso de conflito e um caso de transferência humana.
- 3
Faça testes com dados controlados
Use pacientes de teste e horários reservados para validar leitura, gravação, alteração e cancelamento. Compare o que foi exibido na conversa com o que ficou registrado na agenda e no prontuário.
- 4
Meça a qualidade antes do volume
Acompanhe percentual de reservas confirmadas sem correção, conflitos, transferências por dado ausente, tempo de retrabalho e pedidos de informação repetidos. Aumentar a quantidade de conversas antes de corrigir o mapa amplia o impacto dos erros.
- 5
Revise regras com a operação
Recepção, coordenação clínica, faturamento e tecnologia enxergam falhas diferentes. Faça uma reunião de revisão após os primeiros dias e registre cada mudança com data, responsável, motivo e impacto esperado.
- 6
Estabeleça governança mensal
Revise procedimentos novos, profissionais, convênios, unidades, mensagens de preparo e códigos desativados. O mapa é um ativo operacional vivo, não um documento encerrado no dia da integração.
Erros frequentes ao integrar prontuário e agendador automático
O primeiro erro é tratar o prontuário como uma fonte única e uniforme. Na prática, o mesmo conceito pode ter nomes, códigos e regras diferentes entre unidades ou sistemas, o que exige uma camada de correspondência e uma fonte de verdade definida.
Outro problema é integrar apenas o cadastro do paciente e a agenda. Sem procedimento, duração, recurso, convênio e restrições, a automação enxerga horários, mas não consegue determinar se eles servem para aquele pedido.
Também é arriscado usar texto livre como regra operacional. “Trazer pedido” ou “jejum conforme orientação” pode ser útil para uma pessoa, mas não oferece estrutura suficiente para uma decisão automática. Transforme essas orientações em atributos, condições e ações de fallback.
Logs incompletos dificultam a investigação. Registre a versão da regra, campos consultados, resposta da API, identificador do horário, decisão tomada e motivo de uma transferência, respeitando controles de acesso e retenção definidos pela instituição.
Por fim, não confunda disponibilidade com confirmação. O horário pode ficar livre no momento da consulta e ser ocupado antes da gravação. A confirmação precisa ser transacional quando o sistema permitir, ou seguir uma rotina explícita de nova validação.
Como saber se o mapa de dados está funcionando
A qualidade do mapa aparece no comportamento da operação. Meça conflitos de agenda por mil agendamentos, percentual de reservas corrigidas manualmente, proporção de conversas transferidas por ausência de dado e tempo médio gasto pela recepção em cada exceção.
Para laboratórios, acompanhe também pedidos recusados por falta de requisito, pacientes que receberam orientação complementar e coletas reagendadas por preparo inadequado. Para clínicas, separe primeira consulta, retorno, encaixe e faltas, pois cada fluxo tem custo e regra próprios.
Uma métrica útil é a taxa de confirmação válida: agendamentos que permanecem corretos após a conferência da equipe, sem alteração de procedimento, profissional, unidade ou horário. Outra é a cobertura fora do horário comercial, que mostra quantas oportunidades foram encaminhadas sem depender de atendimento humano naquele momento.
O painel deve relacionar essas métricas ao resultado financeiro, mas sem misturar agendamentos com atendimentos realizados. O guia de métricas do pipeline de agendamento e o material sobre atribuição de receita conversacional ajudam a separar as etapas.
Quando um indicador piorar, investigue a origem: cadastro incompleto, código desatualizado, agenda sem bloqueio, regra clínica ambígua ou falha de comunicação com a API. Essa análise transforma o mapa em instrumento de melhoria operacional.
Perguntas Frequentes
Quais campos do prontuário são indispensáveis para um agendamento automático?▼
Os campos indispensáveis costumam incluir identificador único do paciente, procedimento, especialidade, profissional, unidade, duração, modalidade, disponibilidade, status do horário e convênio. Dependendo do serviço, também são críticos pedido médico, preparo, equipamento e faixa etária. A lista deve ser definida por fluxo, porque uma consulta e um exame de imagem não possuem as mesmas exigências.
Como sincronizar jejum e preparo de exames com o agendador?▼
O preparo deve ser associado ao código do procedimento, e não apenas armazenado como uma mensagem genérica. Mapeie duração do jejum, horário limite, restrições, versão do texto, fonte responsável e ação quando o paciente não atender ao requisito. Se o sistema não devolver uma confirmação confiável, o agendador deve solicitar conferência humana antes de confirmar.
Como evitar que a IA marque um exame sem pedido médico?▼
Crie um campo estruturado que indique se o pedido é obrigatório e uma validação que procure o documento ou status correspondente no sistema autorizado. A regra precisa considerar validade, procedimento relacionado e eventuais exigências do convênio. Quando qualquer item estiver ausente, o fluxo deve explicar a pendência e transferir ou orientar o próximo passo, sem concluir o agendamento.
O que fazer quando minha clínica usa mais de um prontuário?▼
Monte uma matriz de correspondência com o campo equivalente em cada sistema, seus códigos, formatos, fonte de verdade e frequência de atualização. Identifique quais informações são comuns a todas as unidades e quais dependem de regras locais. Também defina uma política para conflitos, pois o sistema que informa o horário pode não ser o mesmo que armazena o pedido ou o cadastro financeiro.
Quais dados precisam de sincronização em tempo real?▼
Disponibilidade, bloqueios, cancelamentos, confirmações, pré-reservas e alterações de profissional ou recurso devem ser atualizados com a menor defasagem possível. Dados cadastrais e textos institucionais podem seguir ciclos de revisão, desde que exista controle de versão. A prioridade deve considerar o prejuízo de uma informação antiga, não apenas a facilidade técnica de integração.
Como tratar um horário ocupado entre a consulta e a confirmação?▼
A gravação da reserva precisa retornar sucesso ou conflito de forma explícita. Em caso de conflito, o fluxo deve consultar novas opções e informar o paciente sem afirmar que a primeira escolha foi confirmada. Quando a API não oferecer uma operação transacional, use uma nova verificação imediatamente antes da confirmação e registre o evento para auditoria.
Quais dados a IA não deve inferir ao agendar?▼
A IA não deve deduzir diagnóstico, autorização de convênio, validade de pedido, preparo cumprido, identidade do paciente ou elegibilidade clínica a partir de pistas incompletas. Esses dados precisam vir de campos estruturados, confirmação do paciente ou avaliação de uma pessoa habilitada. A arquitetura pode reduzir o risco de erro de contexto, mas regras críticas ainda exigem validação e fallback.
Como medir se a integração reduziu o retrabalho da recepção?▼
Compare o volume de agendamentos corrigidos, conflitos, transferências por falta de informação e tempo gasto por exceção antes e depois da implantação. Separe os resultados por serviço, unidade e canal, pois uma média geral pode esconder problemas em exames específicos. Também acompanhe a taxa de confirmação válida e os reagendamentos decorrentes de dados incorretos.