Cadastro de paciente
Fluxo passo a passo para o profissional registrar um novo paciente — campos, pontos de entrada, auto cadastro e o que acontece após a criação.
O profissional pode registrar um paciente novo a partir de dois pontos de entrada:
- Lista de pacientes — botão “Novo paciente” no canto superior direito.
- Agenda — ao criar uma sessão, se o paciente ainda não existe, o profissional pode criá-lo diretamente no formulário de agendamento.
Auto cadastro pelo paciente
Em vez de preencher todos os dados manualmente, o profissional pode enviar um link de auto cadastro para o próprio paciente completar suas informações.
Como enviar o link
- Clique em Novo paciente.
- Informe o nome e, quando disponível, o telefone ou e-mail do paciente.
- Clique em Enviar link de auto cadastro.
- Selecione o canal de envio: WhatsApp ou E-mail.
- O sistema registra o convite e gera um link com validade de 48 horas. No estado atual, a resposta informa
deliveryStatus: not_configured; copie o link e faça o envio pelo canal escolhido.
O que o paciente preenche
O auto cadastro atual aceita somente os campos abaixo, sem exigir login:
- nome, telefone, e-mail e profissão;
- data de nascimento, gênero e descrição de outro gênero;
- estado civil e escolaridade;
- fuso horário, data de início, complexidade, observações familiares e modalidade.
CPF, endereço, contato de emergência, responsável financeiro, plano de saúde e anexos não fazem parte deste link. Esses dados continuam sendo preenchidos pelo profissional no cadastro interno.
O que acontece após o preenchimento
- O paciente submete o formulário.
- O profissional recebe uma notificação in-app: “João Silva completou o auto cadastro.”
- O perfil do paciente é atualizado automaticamente com os dados enviados.
- Campos já preenchidos pelo profissional (nome, telefone) não são sobrescritos — o paciente só completa o que está em branco.
Status do link
| Status | Descrição |
|---|---|
Aguardando |
Link enviado, paciente ainda não abriu |
Em preenchimento |
Paciente abriu o link mas não concluiu |
Concluído |
Paciente submeteu o formulário |
Expirado |
48 horas sem resposta — é possível reenviar |
O status do link aparece no perfil do paciente até que seja concluído ou expirado.
Campos do formulário
Obrigatórios
| Campo | Descrição |
|---|---|
| Nome completo | Identificação principal do paciente. Aceita nome social — o profissional deve usar o nome pelo qual o paciente prefere ser chamado, independentemente do nome registrado em documentos. |
| Telefone | Contato do paciente; não habilita automaticamente um provider de WhatsApp ou SMS |
Os demais campos são opcionais — refletem a realidade de captações informais, onde o primeiro contato pode chegar apenas com nome e telefone.
Dados pessoais
| Campo | Observação |
|---|---|
| Data de nascimento | Formato dd/mm/aaaa |
| Gênero | Seleção: Masculino · Feminino · Outro |
| — | |
| CPF | Aceita CPF de pessoa física |
| Endereço | Endereço completo |
| Profissão | Seleção com busca por nome — lista pré-cadastrada de profissões (ex.: Professora, Engenheiro, Autônomo). Caso a profissão não esteja na lista, o profissional pode digitá-la livremente para adicioná-la como nova opção |
| Estado civil | Solteiro(a) · Casado(a) · União estável · Divorciado(a) · Separado(a) · Viúvo(a) · Outro |
| Escolaridade | Sem escolaridade · Ensino fundamental incompleto · Ensino fundamental completo · Ensino médio incompleto · Ensino médio completo · Ensino superior incompleto · Ensino superior completo · Pós-graduação · Mestrado · Doutorado |
Contato de emergência
| Campo | Descrição |
|---|---|
| Nome | Nome da pessoa de contato |
| Telefone | Telefone para contato em emergências |
| Vínculo | Relação com o paciente: Familiar · Cônjuge · Amigo(a) · Responsável · Outro |
Informações adicionais
| Campo | Descrição |
|---|---|
| Familiares | Informações sobre familiares (texto livre, opcional) |
| Plano de saúde | Nome do plano de saúde (seleção, opcional) |
| Anexos | Use a aba Documentos depois do cadastro |
Preferências de atendimento
| Campo | Descrição |
|---|---|
| Modalidade | Como o paciente prefere ser atendido: Presencial · Online · Híbrido |
| Fuso horário | Fuso do paciente — usado para calcular horários de lembretes automáticos quando ele está em fuso diferente do profissional (padrão: fuso do profissional) |
Informações clínicas
| Campo | Descrição |
|---|---|
| Queixa principal | Motivo do atendimento descrito pelo profissional |
| Data de início do tratamento | Data em que o atendimento teve início efetivo — usada para calcular o tempo de tratamento e exibida no perfil do paciente |
| Complexidade do tratamento | Avaliação clínica do nível de complexidade: Alta · Média · Baixa — visível apenas ao profissional |
| Paciente ativo | Flag que indica se o paciente está em atendimento ativo |
Responsável financeiro
Quando o pagador das sessões não é o próprio paciente (ex.: pais de crianças/adolescentes, cônjuge, empresa), o profissional pode cadastrar um responsável financeiro.
| Campo | Descrição |
|---|---|
| Nome completo | Nome do responsável financeiro |
| E-mail para envio de faturas e cobranças | |
| Documento | CPF ou CNPJ do responsável |
| Telefone | Contato do responsável |
| Grau de parentesco | Relação com o paciente: Pai/Mãe · Cônjuge · Filho(a) · Irmão/Irmã · Avô/Avó · Responsável legal · Empresa · Outro |
Quando há um responsável financeiro cadastrado, faturas e links de pagamento são enviados para o e-mail e telefone do responsável — não para o paciente.
Após o cadastro
Ao salvar, o paciente é vinculado a você e à sua clínica, e você é levado direto para o perfil dele.
Todo paciente criado pelo fluxo atual recebe status Ativo. Não existe o status lead no banco.
O status pode depois ser alterado para inactive, paused ou completed, conforme o ciclo do atendimento.
Editar ou arquivar um cadastro
Alterações no cadastro são salvas imediatamente — não há botão de confirmação separado.
Arquivar um paciente não apaga o histórico de atendimentos: sessões, faturas e documentos continuam preservados e o cadastro pode ser restaurado. Pacientes arquivados saem da lista principal e deixam de aparecer na busca da agenda.
Duplicatas
Telefone e e-mail não possuem índice UNIQUE por tenant. O CPF, quando informado, é armazenado por hash e possui unicidade por tenant para registros não excluídos; uma tentativa duplicada é rejeitada. A relação ativa entre uma pessoa e um cadastro de paciente também é única.
Campos personalizados
Após o cadastro inicial, você pode adicionar campos extras próprios da sua prática (texto, número, data, seleção, sim/não). Os valores ficam associados individualmente ao paciente.
Para formulários estruturados — anamnese, evolução, escalas — use as abas customizadas do prontuário, montadas a partir dos modelos da Biblioteca.