No menu lateral, dentro de Instrumentos, clique em Personalizados. Biblioteca e Personalizados agora são duas abas da mesma página, chamada Biblioteca de instrumentos: clicar em qualquer um dos dois itens do menu abre a mesma tela, já na aba certa. Clique aqui para acessar diretamente: https://app.humantrack.io/app/forms

Depois clique em Criar instrumento, no canto superior direito, e escolha Criar personalizado. No celular, esse botão fica na barra da lista, como um "+", e abre as mesmas duas opções.

Na janela Escolha como gostaria de criar o seu instrumento, marque Manualmente e clique em Continuar.

Agora é hora de criar seu instrumento, cada campo tem um objetivo específico:

Esse campo é usado como identificador do instrumento que está criando, serve para você buscar esse formulário depois e pode ser exibido para o paciente também.

O título precisa ter pelo menos 2 caracteres e não pode repetir o título de outro instrumento seu.

Mesma finalidade do Título, é usado para ajudar a identificar os instrumentos.

Tags são usadas para te auxiliar a filtrar os instrumentos na sua lista.

Esse campo é para você registrar brevemente sobre o que se trata o instrumento em questão.

A descrição não é exibida para o paciente, porém é usada pela Artemi na hora de avaliar os resultados do instrumento.
​

Esse campo é para você registrar os detalhes de interpretação de resultado do instrumento em questão. A interpretação é exibida para você junto as repostas dos pacientes, para auxiliar em uma avaliação rápida dos resultados:

A interpretação não é exibida para o paciente, porém é usada pela Artemi na hora de avaliar os resultados do instrumento.

O texto aqui descrito é exibido para o paciente logo antes de responder uma Submissão. Ele é exibido dessa forma ao paciente:

Campo destinado para registrar o desenvolvedor original do instrumento e a pesquisa científica que deu origem ao instrumento caso exista.

Esse campo é usado em alguns documentos como o PDF exportado do formulário ou no PDF de resumo dos resultados do paciente.

Outras pesquisas, livros, citações relacionados ao instrumento em questão. Como revisões sistemáticas, traduções, entre outros.

Em um instrumento tradicional, a escala global é uma pontuação única que representa o desempenho geral do paciente naquele formulário. Ela é útil para uma visão ampla, mas pode ocultar variações importantes entre diferentes tipos de sintomas ou dimensões avaliadas.

Já a estrutura de subescalas (ou domínios) permite dividir o instrumento em partes específicas. Cada subescala agrupa um conjunto de itens relacionados a um mesmo aspecto, como "humor deprimido", "sono e apetite" ou "iniciativa social", por exemplo. Assim, em vez de uma única pontuação, você passa a ter múltiplas: uma por subescala, além da pontuação geral.

Essas divisões revelam padrões mais sutis e ajudam a identificar áreas que podem estar em maior ou menor grau de comprometimento, mesmo que a pontuação total pareça estável.

A Escala Global pode ser calculada a partir de duas fontes:

Permite classificar os resultados finais. Cada ponto de corte pode conter:

Exemplo:

Essas faixas são exibidas nos relatórios e nos gráficos.

Ao criar uma subescala (ou domínio) dentro de um instrumento, você pode definir como a pontuação dessa subescala será calculada com base nas respostas do paciente. Isso é feito através do campo "Método de Cálculo", localizado na parte superior direita da configuração da subescala.

Atualmente, estão disponíveis três opções:

1. Soma

A pontuação da subescala é calculada pela soma bruta das respostas dos itens que a compõem.
Esse método é frequentemente utilizado em escalas do tipo Likert com pesos uniformes, e está presente em grande parte dos instrumentos clássicos da psicologia e psiquiatria. Exemplo: BDI, BAI, SDQ.

2. Média

Neste método, a pontuação final é obtida pela média aritmética simples das respostas dos itens.
Ele é adotado quando se deseja manter a escala de pontuação em uma faixa padronizada (por exemplo, 0 a 5), independentemente do número de itens na subescala. Isso facilita comparações entre domínios de tamanhos diferentes e respeita a estrutura original de alguns instrumentos adaptados ou validados dessa forma.

3. Soma multiplicada por 2

Essa opção reflete um modelo específico de ponderação padronizada, utilizado em alguns instrumentos adaptados, onde a pontuação bruta da subescala é multiplicada por um fator constante.
Por exemplo, no DASS-21, as subescalas são compostas por 7 itens cada, mas foram derivadas de uma versão de 42 itens. Por isso, a soma de cada subescala é multiplicada por 2 para manter a comparabilidade com os escores originais.

Depois de definir o nome da subescala e o método de cálculo, o próximo passo é configurar os pontos de corte, que são faixas de pontuação usadas para interpretar os resultados obtidos na subescala.

Cada ponto de corte representa um intervalo numérico que pode ser rotulado com uma descrição clínica ou funcional (ex: "leve", "moderado", "grave", ou qualquer nomenclatura que faça sentido dentro do seu protocolo).

Na tela de criação da subescala, você pode:

Por exemplo, você pode configurar uma subescala com os seguintes cortes:

O print mostra três pontos de corte configurados com diferentes cores, rótulos e faixas numéricas. Os pontos de corte entram pelo botão Criar primeiro ponto de corte (ou Adicionar ponto de corte, quando a subescala já tem algum), dentro da configuração da subescala.

Os pontos de corte são opcionais, mas altamente recomendados: eles enriquecem a interpretação clínica dos dados e são usados tanto nos relatórios da plataforma quanto nas análises visuais (gráficos).

Após configurar as subescalas e seus pontos de corte, o próximo passo é associar cada pergunta do seu instrumento a uma dessas subescalas. Essa associação define a qual domínio clínico aquela questão pertence e, portanto, em qual subescala ela será contabilizada.

Depois que o instrumento tem subescalas, cada pergunta ganha, no canto superior direito, o campo Subescalas. É ali que você vincula a pergunta a um dos domínios previamente criados, ou a mais de um: o campo aceita várias subescalas na mesma pergunta.

Qualquer pergunta pode ser vinculada a uma subescala, mas só quatro tipos entram na pontuação dela.

Veja a regra:

Essa estrutura garante que apenas os itens mensuráveis influenciem os resultados das subescalas, mantendo a integridade estatística da análise.

Todo formulário precisa ter no mínimo 1 questão. A plataforma oferece estes tipos de questão: Múltipla escolha, Caixas de seleção (várias respostas possíveis), Escala linear, Discursiva, Número e Horário:

Questões de Múltipla Escolha são questões com pelo menos 2 opções, onde o paciente precisa selecionar 1 alternativa entre as disponíveis:

Os itens configuráveis são:

Permite que o paciente marque mais de uma alternativa.

É útil para captar múltiplos comportamentos, sintomas ou estratégias ao mesmo tempo.

Exemplo:

"Quais estratégias você utilizou para lidar com o estresse nos últimos dias?"

✅ Exercício físico

✅ Leitura

✅ Respiração consciente

✅ Outro

Configurações disponíveis:

Questões de Escala Linear apresentam um intervalo numérico ordenado, no qual o respondente escolhe um valor para indicar a intensidade, frequência ou grau de concordância em relação a um enunciado.

Os itens configuráveis são:

Questões Discursivas apresentam uma solicitação de resposta aberta, permitindo expressar opiniões, experiências ou argumentos com suas próprias palavras.

Os itens configuráveis são:

A questão de Número permite que o paciente registre um valor numérico. Útil para diários e acompanhamentos quantitativos, como registrar o peso ao longo do tempo ou a quantidade de vezes que o paciente realizou determinada ação.

A questão de Horário permite registrar um horário do dia. Útil em vários contextos, como em um diário de sono, em que o paciente informa a que horas foi dormir e a que horas acordou.

Além dos tipos de questão, o botão Adicionar seção cria um separador visual que organiza as perguntas em blocos: por tema, por momento da avaliação ou por qualquer lógica que faça sentido para o seu instrumento.

Criar instrumentos personalizados pode ser um processo extenso, principalmente quando envolve muitas perguntas parecidas ou quando você percebe, durante a revisão, que algo ficou fora de ordem.

Aqui vão algumas dicas valiosas para tornar esse processo mais leve e eficiente:

Se você está montando um instrumento longo com várias questões parecidas, não precisa escrever tudo do zero.

Basta clicar no botão "Copiar" ao lado da pergunta original. Isso gera uma nova versão, que você pode apenas ajustar conforme necessário.

📌 Ideal para sequências com a mesma estrutura, como:

Errou a ordem das questões? Percebeu que esqueceu de inserir uma no meio do formulário?

Você pode mover qualquer pergunta de lugar, simplesmente arrastando e soltando com o mouse (drag & drop).

🖱️ Isso vale para as questões de qualquer instrumento em rascunho. Num instrumento já ativo, as questões só voltam a ser editáveis com Mover para rascunho, e só enquanto ele não tiver sido aplicado.

Essas duas ações combinadas (copiar e mover) permitem que você construa blocos inteiros de maneira mais rápida e consistente, mantendo a lógica do instrumento sem retrabalho.

Quando terminar de montar, clique em Ativar. A janela Ativar instrumento? avisa que, depois de ativar, o instrumento fica disponível para aplicar a pacientes e as questões deixam de ser editáveis: título, descrição, instruções e referências continuam editáveis. Para voltar a editar as questões, use Mover para rascunho, o que só funciona enquanto o instrumento não tiver sido aplicado.

Quando a ativação é recusada, a mensagem nomeia a questão, a subescala ou o ponto de corte com problema e leva a tela até o campo. O rascunho continua editável.

O título precisa ser único entre os instrumentos que você criou. Mudar só a sigla não resolve mais: dois instrumentos seus não podem ter o mesmo título, mesmo com siglas diferentes. O instrumento continua aberto na tela, com o campo Título destacado, e é só escolher outro título para seguir.

A comparação não diferencia maiúsculas de minúsculas nem espaços repetidos, então "Escala de bem-estar" e "Escala de Bem-Estar" contam como o mesmo título. Acentos, sim, fazem diferença.

Cada pontuação precisa cair em um único ponto de corte. Se duas faixas dividem qualquer valor, a ativação é recusada com essa mensagem. Na seção Pontos de Corte, um aviso em vermelho acima da lista mostra as sobreposições encontradas, e as faixas citadas nesse aviso ficam com um contorno vermelho.

O engano mais comum é terminar uma faixa no mesmo número em que a próxima começa. O início e o fim entram na faixa, então "0 a 10" seguido de "10 a 20" dividem a pontuação 10 e contam como sobreposição. O certo é "0 a 10" e depois "11 a 20". Para montar as faixas do zero, veja Como definir os pontos de corte e cores nas pontuações.

A regra vale para as faixas da escala global e para as de cada subescala, e alcança também as faixas encaixadas uma dentro da outra (como "0 a 20" junto de "6 a 10").

Aparece quando o instrumento recebeu outra alteração no mesmo instante em que você ativava ou salvava. Vale para ativar, para salvar um instrumento que já está ativo e para o salvamento automático do rascunho. A plataforma recarrega o instrumento e as suas edições continuam na tela: é só tentar de novo.

​

​
​