> For the complete documentation index, see [llms.txt](https://ajuda.digitalsac.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.digitalsac.io/digicrm/operacao-uso-do-sistema/configuracoes/questionarios-de-fechamento.md).

# 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]]

#### Modal Questionário

| 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]]

#### Modal Pergunta (`ModalQuestion`)

| 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.