Skip to main content

Como funcionam as Notas

Entenda o fluxo de processamento de notas de consulta veterinária

O que são Notas?

As Notas são transcrições estruturadas de consultas veterinárias. Você envia um arquivo de áudio via API e recebe de volta texto organizado em seções úteis como anamnese, diagnóstico e tratamento.

Fluxo de Processamento

1

Upload do áudio

Envie seu arquivo de áudio via POST para /v1/notes
2

Processamento

Nossa IA processa e transcreve o áudio (1-5 minutos)
3

Estruturação

O texto é automaticamente organizado em seções médicas
4

Disponibilização

Os dados ficam disponíveis via GET /v1/notes/{id}

Estados de Processamento

Uma nota pode ter os seguintes status:

pending

Aguardando processamentoÁudio foi recebido e está na fila

processing

Em processamentoIA está transcrevendo o áudio

completed

ConcluídoTranscrição finalizada e seções disponíveis

failed

FalhouErro no processamento (verifique qualidade do áudio)

Estrutura de uma Nota

Dados Básicos

Seções Estruturadas

Quando processada, a nota é dividida automaticamente em seções:

Seções Padrão

Anamnese

Histórico do paciente
  • Sintomas relatados pelo tutor
  • Histórico médico anterior
  • Observações de comportamento

Exame Físico

Avaliação física
  • Peso, temperatura, sinais vitais
  • Observações do exame clínico
  • Alterações encontradas

Diagnóstico

Conclusões médicas
  • Diagnóstico principal
  • Diagnósticos diferenciais
  • Suspeitas clínicas

Tratamento

Plano terapêutico
  • Medicações prescritas
  • Dosagens e frequência
  • Instruções para o tutor

Metadados Personalizados

Você pode incluir informações adicionais ao criar uma nota:
Casos de uso para metadados:
  • Identificação do veterinário
  • Tipo de procedimento
  • Informações do paciente
  • Referências do seu sistema

Requisitos de Áudio

Formato Recomendado

Para melhores resultados, use WAV, 16kHz, mono, 16-bit
Especificações ideais:
  • Formato: WAV ou FLAC
  • Taxa de amostragem: 16.000 Hz
  • Canais: Mono (1 canal)
  • Bit depth: 16-bit

Formatos Aceitos

Dicas para Melhor Qualidade

🔇 Ambiente Silencioso

Minimize ruído de fundo durante a gravação

🎤 Distância Adequada

Mantenha 30-50cm de distância do microfone

🗣️ Fala Clara

Evite falar muito rápido ou com volume muito baixo

⏱️ Duração

Entre 1 minuto e 1 hora de duração

Limitações

Limitações importantes:
  • Tamanho máximo: 100MB por arquivo
  • Duração máxima: 60 minutos
  • Idioma: Português brasileiro (primário)
  • Qualidade: Áudio com muito ruído pode falhar

Monitoramento via Webhook

Ao invés de fazer polling, configure webhooks para receber notificações:
Veja mais em Conceitos de Webhooks.
Próximo passo: Experimente criar sua primeira nota seguindo o Guia de Início Rápido.