For the complete documentation index, see llms.txt. This page is also available as Markdown.

Questionários de Fechamento

Finalidade

Definir questionários com perguntas tipadas (texto, seleção, data, etc.). O campo Quem responde decide onde cada questionário é usado:

Quem responde
Onde aparece

Atendente (padrão)

No fechamento do ticket. Vinculado a filas

Cliente

Junto com a avaliação NPS, na web

Questionários de público Cliente não aparecem no fechamento do ticket, e os de Atendente não são oferecidos ao cliente — o formulário interno nunca vaza para fora.

[[FOTO]]

O que você vê na tela

Elemento
Função

Hero Questionários de Fechamento

Subtítulo de gestão

Tabela / Cards

Preferência questionnaires_view_mode

Abas Ativos / Inativos

Filtro por isActive

Adicionar Questionário

Abre modal

Colunas: # · Nome · Descrição · Quem responde · Ativo · Perguntas (contagem) · Ações

[[FOTO]]

Campo
Detalhe

Nome

Obrigatório

Descrição

Textarea opcional

Quem responde

Atendente (padrão) ou Cliente

Ativo

Toggle; padrão ligado

Perguntas: só aparecem depois que o questionário foi salvo (modo edição). Em criação, banner: “Salve o questionário primeiro para poder adicionar perguntas.”

Após criar com sucesso, o modal permanece aberto em edição para permitir incluir perguntas.

Lista de perguntas: texto, tipo, obrigatório/opcional; ações editar/excluir pergunta.

[[FOTO]]

Campo
Detalhe

Pergunta

Obrigatório

Tipo

Ver tabela abaixo

Campo Obrigatório

Toggle

Ordem

Número ≥ 0

Opções

Só para Seleção e Checkbox; adicionar/remover opções

Tipos de pergunta (pt-BR):

Label
Valor interno

Texto

input

Área de Texto

textarea

Seleção

select

Checkbox

checkbox

Número

number

Data

date

Hora

time

Moeda

currency

Para tipos que não são select/checkbox, options é enviado como null.

[[FOTO]]

Ações

Ação
Comportamento

Salvar questionário

Cria ou atualiza; notifica “Questionário salvo com sucesso”

Excluir questionário

Confirma com nome; “Esta ação não pode ser desfeita”

Adicionar/editar pergunta

Modal dedicado; exige questionnaireId

Excluir pergunta

Confirmação específica

Regras importantes

  • Não é possível desativar um questionário ainda vinculado a filas: aviso lista os nomes das filas e pede para desvincular primeiro (Cannot deactivate questionnaire).

  • Perguntas só após o primeiro save.

  • Abas ativos/inativos; preferência de visualização no localStorage.

Mensagens

Situação
Texto

Salvo

Questionário salvo com sucesso

Excluído

Questionário excluído com sucesso

Pergunta excluída

Pergunta excluída com sucesso

Erro salvar/carregar/excluir

Mensagens error_* do i18n



Questionário do cliente (NPS)

Marcado como Cliente, o questionário fica disponível em dois lugares:

Onde vincular
Efeito

Configurações → NPS → Questionário da avaliação

Vale para o NPS do atendimento (modo link)

Configurações → Agendamento Público → página → Questionário da avaliação

Vale para o NPS daquela página de agendamento

Na página que o cliente abre, a ordem é sempre nota → perguntas → comentário livre → enviar, num único envio. O comentário livre não é substituído pelas perguntas: continua existindo e vai por último.

Os tipos viram controles de verdade — seleção vira botão de rádio, múltipla escolha vira caixas de seleção. O cliente não precisa digitar "sim".

As respostas aparecem no Relatório de NPS, em linha expansível e numa aba própria do Excel.

Cuidado ao apagar perguntas: o texto da pergunta é guardado junto da resposta, então o histórico continua legível — mas as respostas antigas, gravadas antes desta funcionalidade, aparecem apenas com o número da pergunta.

Atualizado