NPS - Configurar Perguntas e Página de Sucesso

O que é

Esta página concentra toda a personalização da pesquisa de satisfação (NPS) que o Viagilize envia automaticamente aos clientes depois da viagem. Aqui você define quais perguntas vão compor o questionário, em qual ordem elas aparecem, e qual é o conteúdo da página de sucesso que o cliente vê logo após responder.

O admin chega aqui pelo botão Configurar Perguntas no topo da página Pesquisas NPS, ou diretamente pelo menu Relatórios > Pesquisas NPS e em seguida clicando em Configurar Perguntas. A nota NPS de 0 a 10 é sempre incluída automaticamente - ela não aparece na lista e não pode ser removida. As perguntas configuradas aqui são exibidas em adição a essa nota.

Como usar

1. Vá em Relatórios > Pesquisas NPS no menu lateral.
2. Clique em Configurar Perguntas (botão azul no topo).
3. Para criar uma pergunta, clique em Nova Pergunta (botão azul no canto superior direito) e preencha o modal:
   • Pergunta - texto exato que será mostrado ao cliente.
   • Tipo de Resposta - escolha entre Sim / Não / Talvez, Escala 1 a 5, Escala 0 a 10 ou Texto Livre.
   • Resposta obrigatória - marque o checkbox se o cliente não puder pular a pergunta.
4. Confirme em Criar (ou Salvar ao editar).
5. Para mudar a ordem em que as perguntas aparecem na pesquisa, use as setas Mover para cima / Mover para baixo à esquerda de cada item. A ordem é salva automaticamente.
6. Para ativar/desativar uma pergunta sem excluir, clique no ícone de olho à direita. Perguntas desativadas ficam com aparência esmaecida na lista e não são enviadas em novas pesquisas.
7. Para configurar a página de sucesso, role até o bloco Página de Sucesso e preencha:
   • Promotores (9-10) - mensagem para quem deu nota alta.
   • Neutros (7-8) - mensagem para quem deu nota intermediária.
   • Detratores (0-6) - mensagem para quem deu nota baixa.
   • Links de avaliação externa - toggle que, quando ativado, exibe apenas para promotores os campos de Google Reviews (URL), TripAdvisor (URL) e um Link extra opcional (com label e URL próprios).
8. Clique em Salvar Configurações (botão azul no rodapé do bloco) para gravar as mensagens e links. As perguntas em si já são salvas no momento da criação/edição - esse botão grava apenas o bloco de página de sucesso.
9. Use Visualizar Preview (botão no topo) a qualquer momento para abrir a pesquisa em nova aba com dados fictícios e conferir como o cliente vai vê-la.

Casos especiais

Excluir pergunta já usada em pesquisas anteriores

Ao clicar no ícone de lixeira, aparece um modal de confirmação. Confirmando, a pergunta é apagada e não voltará a ser enviada em pesquisas novas. As respostas históricas dessa pergunta continuam preservadas - mas se o objetivo for apenas pausar, prefira desativar (ícone de olho) em vez de excluir, para manter o histórico vinculado a uma pergunta ainda visível na configuração.

Disparo manual da pesquisa para uma excursão

Mesmo com configuração automática, o admin pode forçar o envio para todos os passageiros de uma excursão específica usando o botão Disparar Pesquisas disponível na página Relatórios > Pesquisas NPS > [excursão]. O job DispararPesquisaNpsJob cuida da fila de envio.

Promotores sem links de avaliação externa

Se o toggle Links de avaliação externa estiver desligado, ou se nenhum dos três campos (Google, TripAdvisor, Link extra) estiver preenchido, a página de sucesso para promotores mostra apenas a mensagem configurada, sem os botões externos. Use isso quando ainda não tiver perfil público no Google ou TripAdvisor.

Erros comuns e como resolver

• "O campo pergunta é obrigatório." - Causa: o texto da pergunta ficou em branco no modal Nova Pergunta. Solução: digite o enunciado completo e clique em Criar novamente.
• "O campo tipo é obrigatório." - Causa: o select Tipo de Resposta ficou em "Selecione...". Solução: escolha um dos quatro tipos disponíveis.
• "O valor selecionado para tipo é inválido." - Causa: tipo enviado que não pertence ao conjunto permitido (sim_nao_talvez, escala_1_5, escala_0_10, texto_livre). Solução: selecione um tipo válido no modal - normalmente acontece se a tela ficou aberta após uma atualização do sistema; recarregue a página.
• "Erro ao salvar" (toast vermelho ao clicar em Salvar Configurações) - Causa mais comum: URL do Google Reviews ou TripAdvisor sem https:// no início, ou texto além de 500 caracteres em alguma mensagem. Solução: confira se as URLs começam com http:// ou https:// e se cada mensagem tem no máximo 500 caracteres.

Onde encontrar

• URL: /admin/nps/perguntas
• Caminho no menu: Relatórios > Pesquisas NPS > Configurar Perguntas
• Permissão necessária: ver as pesquisas
• Módulo necessário: nenhum

Veja também

• Perguntas NPS
• Detalhes da Pesquisa NPS