Site - Perguntas Frequentes (FAQ)

O que é

As FAQs são as perguntas e respostas que aparecem na página pública /faqs do site da agência. Cada item tem dois campos de texto - a pergunta e a resposta - e um status (ativa ou inativa) que controla a exibição no site. A ordem da lista no admin é exatamente a ordem que o cliente vê no site público.

Você normalmente chega aqui em três momentos: ao montar o site pela primeira vez (para responder antecipadamente às dúvidas mais comuns sobre cancelamento, pagamento, bagagem, embarque), ao perceber que uma mesma pergunta chega repetidamente para a equipe de atendimento (vira uma nova FAQ) ou para revisar respostas após mudanças de política (prazos, formas de pagamento, regras de cancelamento).

Como usar

1. Vá em Vitrine > FAQs no sidebar.
2. Para cadastrar uma nova entrada, clique em Nova FAQ (botão azul no canto superior direito).
3. Preencha o formulário:
   • Pergunta - obrigatória, até 1000 caracteres. Use o ponto de vista do cliente (ex: "Qual é o prazo para cancelamento?").
   • Resposta - obrigatória, até 5000 caracteres. Campo de texto simples (sem editor rico): formatação acontece como texto puro.
   • FAQ ativa - marcada por padrão. Desmarcada, a pergunta fica salva mas oculta do site público.
4. Confirme em Criar FAQ. Você volta para a lista com a mensagem "FAQ criada com sucesso!".
5. Para alternar visibilidade direto na lista, clique no badge verde Ativa (vira cinza "Inativa") ou no badge cinza Inativa (vira verde "Ativa"). A mesma ação está disponível no dropdown de ações de cada linha como Desativar / Ativar.
6. Para reordenar, use as setas pequenas para cima e para baixo à esquerda do ícone de cada FAQ. A página recarrega após cada movimento já com a nova ordem persistida.
7. Para editar, abra o dropdown de ações (três pontos no canto direito da linha) e clique em Editar. Após salvar, a mensagem "FAQ atualizada com sucesso!" confirma a alteração.
8. Para excluir, abra o dropdown e clique em Excluir (em vermelho). Um modal pergunta "Tem certeza que deseja excluir esta FAQ?" - só após confirmar a exclusão é efetivada. A ação é definitiva.

Casos especiais

Buscar dentro de pergunta e resposta

O campo Buscar por pergunta ou resposta... filtra a lista por qualquer trecho encontrado tanto na pergunta quanto na resposta (via LIKE %termo%). É útil para localizar rapidamente uma FAQ específica quando a lista cresce ou para verificar se um assunto já está coberto antes de criar uma nova entrada. Clique em Limpar para voltar à listagem completa.

Reordenação por setas

A reordenação não é por arrastar e soltar - usa duas setas (para cima e para baixo) na coluna esquerda de cada item. A seta para cima fica desabilitada na primeira FAQ da página e a seta para baixo, na última. Após cada clique, o sistema envia a nova ordem ao endpoint reordenar e recarrega a página para refletir a sequência atualizada. Como a listagem é paginada (15 por página), a reordenação opera dentro da página visível.

FAQ inativa para preparar lançamento

Cadastrar a FAQ com o checkbox FAQ ativa desmarcado salva o registro sem expô-lo no site. Útil para preparar perguntas relativas a uma temporada ou promoção e ativá-las todas no momento certo (basta voltar à lista e clicar no badge cinza Inativa de cada uma). O texto auxiliar abaixo do checkbox reforça: "FAQs inativas não aparecem no site".

Posição de novas FAQs na lista

Toda FAQ recém-criada entra com ordem = MAX(ordem) + 1, ou seja, sempre no fim da lista. Se quiser que apareça entre as primeiras no site público, cadastre primeiro e em seguida use as setas Mover para cima até a posição desejada.

Erros comuns e como resolver

• "A pergunta é obrigatória." - Causa: o campo Pergunta ficou em branco no formulário. Solução: preencher antes de salvar.
• "A resposta é obrigatória." - Causa: o textarea Resposta ficou em branco. Solução: digitar o texto da resposta (mínimo 1, máximo 5000 caracteres).
• Pergunta ou resposta cortada após salvar - Causa: a pergunta ultrapassou 1000 caracteres ou a resposta ultrapassou 5000. A validação rejeita o envio. Solução: reduzir o texto, dividir em mais de uma FAQ ou apontar a resposta para uma página completa de termos via link textual.
• FAQ não aparece no site mesmo marcada como Ativa - Causa: a página /faqs pode estar oculta no menu do site público ou o bloco de FAQ pode estar desabilitado na configuração da home. Solução: verificar em Vitrine > Menu do Site e em Vitrine > Seções da Home se a FAQ está visível.
• Setas de reordenação sem efeito - Causa: erro de rede ao chamar o endpoint reordenar (badge não recarrega). Solução: recarregar a página manualmente - a ordem só é persistida quando o POST conclui com sucesso.

Onde encontrar

• URL: /admin/faqs
• Caminho no menu: Vitrine > FAQs
• Permissão necessária: ver as configurações (ver) e editar as configurações (criar, editar, ativar/desativar, reordenar, excluir)
• Módulo necessário: nenhum (faz parte da configuração base do site)

Veja também

• Site - Depoimentos de Clientes - complementar a prova social com avaliações reais ao lado das respostas
• Seções da Home - habilitar o bloco de FAQ na página inicial do site público
• Páginas Customizadas - criar uma página dedicada de termos e políticas referenciada a partir das respostas