DOCUMENTAÇÃO

BASE DE REGRAS • CONSTRUTOR DE PESQUISAS

Documentação dos componentes

Fonte de verdade para coleta, armazenamento e visualização dos dados no futuro construtor de dashboards.
Sincronizadacom o construtor
FORMS8

Componentes que coletam dados sem calcular uma métrica.

MÉTRICAS8

Componentes com escala e regra própria de cálculo.

REGRA CENTRALVisualização compatível

O dashboard só poderá oferecer gráficos previstos para o tipo de dado e para a natureza de cada componente.

CATÁLOGO DO CONSTRUTOR

Forms

Chamados de Campos no construtor. Coletam respostas abertas, categóricas, datas ou vínculos.
8 itens
FormsTipo de dadoDescriçãoVisualização
Textotext
Texto, e-mail, telefone ou CPF/CNPJ

Coleta uma resposta curta. CPF/CNPJ, telefone e e-mail permanecem como texto para preservar zeros, máscaras e formatação.

  • Lista de respostas
  • Total de respostas válidas
  • Nuvem de termos
Escolha únicaradio
Uma categoria: texto ou número

Permite selecionar exatamente uma alternativa. O valor é associado ao ID único da opção.

  • Gráfico em rosca
  • Barras verticais
  • Barras horizontais
Lista suspensadropdown
Uma categoria: texto ou número

Apresenta alternativas em um menu compacto e registra uma única opção selecionada.

  • Gráfico em rosca
  • Barras verticais
  • Barras horizontais
Múltipla escolhamulti_select
Lista de categorias: texto ou número

Permite escolher mais de uma alternativa. Cada resposta armazena uma lista de IDs de opções.

  • Barras horizontais
  • Barras verticais
  • Ranking de alternativas
Texto longorich_text
Texto livre longo

Coleta comentários, justificativas e relatos extensos sem transformar o conteúdo em uma métrica.

  • Lista de respostas
  • Nuvem de termos
  • Total de comentários
Caixas de seleçãocheckbox
Lista de categorias ou booleanos

Registra nenhuma, uma ou várias alternativas marcadas. Cada opção é contabilizada de forma independente.

  • Barras horizontais
  • Barras verticais
  • Ranking de alternativas
Calendáriodate
Data no padrão ISO (AAAA-MM-DD)

Coleta uma data respeitando os limites mínimo e máximo definidos na configuração da pergunta.

  • Série temporal
  • Distribuição por período
  • Total por dia, mês ou ano
Empresascompany
ID único da empresa

Associa a resposta à empresa cadastrada no módulo Empresas sem duplicar nome ou CNPJ na pesquisa.

  • Ranking de empresas
  • Gráfico em rosca
  • Barras horizontais ou verticais

CATÁLOGO DO CONSTRUTOR

Métricas

Calculam indicadores padronizados e preservam a fórmula definida para cada métrica.
8 itens
MétricasTipo de dadoDescriçãoVisualização
NPS transacionalnps
Número inteiro de 0 a 10

Métrica calculada por % de Promotores menos % de Detratores. A mesma regra visual vale para NPS transacional, relacional e Employee NPS.

  • Escala colorida, preto e branco ou cor da pesquisa
  • Tacômetro NPS com cinco zonas
  • Total, Promotores, Neutros e Detratores
  • Barras com todas as notas de 0 a 10
NPS relacionalnps_relational
Número inteiro de 0 a 10 + ID da empresa

Mede a recomendação no relacionamento geral. Permite apenas um componente por empresa dentro da mesma pesquisa.

  • Escala colorida, preto e branco ou cor da pesquisa
  • Tacômetro NPS com cinco zonas
  • Total, Promotores, Neutros e Detratores
  • Barras de 0 a 10 filtráveis por empresa
CSATcsat
Número inteiro de 1 a 5

Mede satisfação. Notas 4 e 5 formam a faixa satisfeita; a média e a distribuição permanecem disponíveis.

  • Escala colorida, preto e branco, cor da pesquisa ou emojis
  • Indicador de satisfação
  • Média das respostas
  • Barras com as notas de 1 a 5
CES 1.0ces_1_0
Número inteiro de 1 a 5

Mede esforço por concordância, de discordo totalmente a concordo totalmente.

  • Escala colorida, preto e branco ou cor da pesquisa
  • Indicador médio de esforço
  • Distribuição por nível
  • Barras com as respostas de 1 a 5
CES 2.0ces_2_0
Número inteiro de 1 a 7

Mede a facilidade percebida com sete níveis, de muito difícil a muito fácil.

  • Escala colorida, preto e branco ou cor da pesquisa
  • Indicador médio de facilidade
  • Distribuição por nível
  • Barras com as respostas de 1 a 7
Ratingrating
Número inteiro de 1 a 5

Coleta uma avaliação de uma a cinco estrelas e preserva o valor numérico para cálculo da média.

  • Estrelas em escala colorida, preto e branco ou cor da pesquisa
  • Média em estrelas
  • Distribuição por quantidade de estrelas
  • Barras de 1 a 5 estrelas
eNPSenps
Número inteiro de 0 a 10

Mede a recomendação da empresa como local de trabalho, usando a segmentação de Detratores, Neutros e Promotores.

  • Escala colorida, preto e branco ou cor da pesquisa
  • Tacômetro eNPS com cinco zonas
  • Total, Promotores, Neutros e Detratores
  • Barras com todas as notas de 0 a 10
Like e Dislikelike_dislike
Número binário: Like = 1 e Dislike = 0

Coleta uma avaliação positiva ou negativa em dois botões e armazena o resultado de forma eficiente.

  • Percentual de Likes
  • Total de Likes e Dislikes
  • Rosca ou barras comparativas

PADRÃO VISUAL • MÉTRICAS NPS

Visualização obrigatória do NPS

O mesmo conjunto deve ser usado para NPS transacional, NPS relacional e Employee NPS.
NPS transacionalNPS relacionalEmployee NPS (eNPS)
Dados demonstrativos usados somente para documentar o comportamento do componente.
NET PROMOTER SCORENPS transacional
Zona Aperfeiçoamento
Crítica-100 a 0
Aperfeiçoamento1 a 50
Qualidade51 a 75
Excelência76 a 90
Encantamento91 a 100
ESTRATIFICAÇÃO DA COLETAQuantidade por avaliações
7.465Total de coletas100% da base
4.308Promotores57,71%
1.422Neutros19,05%
1.735Detratores23,24%
Detratores • 0–6Neutros • 7–8Promotores • 9–10

DISTRIBUIÇÃO

Formatos de envio da pesquisa

O canal define como a pesquisa chega ao respondente. A coleta permanece vinculada à pesquisa, à versão e ao canal utilizado.
WhatsAppPlanejado
E-mailPlanejado
SMSPlanejado
ImpressaPlanejado
QR CodePlanejado
LinkDisponível
Seu AppPlanejado
Seu SitePlanejado
TotemPlanejado
1

Pesquisa ativa e canal Link habilitado

2

Preenchimento com ramificações

3

Resposta persistida e disponível em Relatórios

GOVERNANÇA

Regras obrigatórias para os dashboards

01Escolha única

O percentual usa respostas válidas como base e a soma das alternativas deve resultar em 100%.

02Múltiplas escolhas

O percentual representa respondentes por alternativa; por isso, a soma pode ultrapassar 100%.

03Identificadores estáveis

Alternativas e empresas são agrupadas por ID. O nome é apenas o rótulo exibido e pode ser atualizado sem quebrar o histórico.

04Respostas vazias

Não respondidas devem ser exibidas separadamente e nunca misturadas às respostas válidas.

05Métricas padronizadas

Fórmula, escala e segmentação pertencem à métrica e não poderão ser alteradas por um gráfico.

06Atualização contínua

Todo novo componente ou alteração de tipo, regra ou visualização deve ser registrada neste catálogo compartilhado.

07Exportação rastreável

A planilha de resultados possui uma linha por coleta e uma coluna por pergunta. Cada cabeçalho registra o ID estável e o texto da pergunta.

08NPS Relacional por empresa

Cada empresa pode ter apenas um NPS relacional na mesma pesquisa. Um novo componente exige o ID de outra empresa.

09Escalas imutáveis

CSAT e Rating usam 1 a 5, CES 1.0 usa 1 a 5, CES 2.0 usa 1 a 7, eNPS usa 0 a 10 e Like/Dislike usa 1 ou 0.

10Renderização compartilhada

Construtor, preview e formulário público usam o mesmo componente visual. NPS, CES e CSAT nunca poderão divergir entre esses contextos durante uma atualização.

11Modos de escala

NPS e CES oferecem escala colorida, preto e branco ou cor primária da pesquisa. O CSAT mantém essas três opções e acrescenta cinco emojis configuráveis sem alterar os valores de 1 a 5 armazenados no banco.