Site - Depoimentos de Clientes

O que é

Os depoimentos são a prova social da empresa no site público: nome do cliente, foto, avaliação de 1 a 5 estrelas, texto livre e - opcionalmente

• a excursão a que se referem. Quando ativos, aparecem automaticamente na seção de depoimentos da home e na página /depoimentos do site público.

Você normalmente chega aqui em dois momentos: para cadastrar manualmente depoimentos coletados fora do sistema (WhatsApp, e-mail, redes sociais) ou para revisar e aprovar depoimentos que chegaram automaticamente via pesquisa NPS pós-viagem. Toda alteração reflete no site sem precisar de publicação manual.

Como usar

1. Vá em Vitrine > Depoimentos no sidebar.
2. Para cadastrar um depoimento manual, clique em Novo Depoimento (botão azul no canto superior direito).
3. Preencha o formulário:
   • Foto do Cliente - opcional, formato circular com crop 1:1. Se ficar em branco, o sistema mostra a inicial do nome em um gradiente colorido.
   • Nome do Cliente - obrigatório, até 255 caracteres.
   • Depoimento - obrigatório, até 2000 caracteres.
   • Avaliação - clique nas estrelas (1 a 5). Começa em 5 por padrão.
   • {Excursão} Relacionada - opcional. Lista as excursões em ordem decrescente de data de início. Vincular ajuda a exibir o depoimento na página dessa excursão.
   • Destacar na homepage - marca o depoimento com selo amarelo "Destaque" e o prioriza nos blocos de destaque do site.
   • Depoimento ativo - marcado por padrão. Desmarcado, o depoimento fica salvo mas oculto do site público.
4. Confirme em Criar Depoimento. Você volta para a lista com o toast "Depoimento criado com sucesso!".
5. Para revisar depoimentos vindos da pesquisa NPS, use o campo de busca por nome do cliente ou role a lista - depoimentos automáticos chegam inativos (com etiqueta cinza "Inativo") e ficam translúcidos. Clique no ícone de olho no rodapé do card para ativá-los.
6. Para reordenar a exibição, ajuste o campo ordem (suportado pelo endpoint reordenar, usado por integrações que enviam um array de IDs). Depoimentos novos entram com ordem = MAX(ordem) + 1, ou seja, no fim da lista.

Casos especiais

Depoimento vindo da pesquisa NPS

Quando um cliente responde a pesquisa de satisfação pós-viagem e escreve um texto opcional no campo de depoimento (no portal /pesquisa/{token}/depoimento), o sistema cria automaticamente um registro em depoimentos com:

• nome = nome do cliente respondente (ou "Anônimo" se não houver)
• foto = avatar_url do cliente, se disponível (geralmente do Google OAuth)
• avaliacao = nota de 1 a 5 escolhida pelo próprio cliente na pesquisa (não confundir com o NPS 0–10; aqui é uma segunda nota voltada ao depoimento)
• excursao_id = excursão da pesquisa
• ativo = false - o depoimento nunca entra publicado direto, ele sempre cai na fila para sua aprovação

Esses depoimentos aparecem na lista com a etiqueta "Inativo" e opacidade reduzida. Revise o texto, ajuste o que for necessário em Editar e clique no ícone de olho para publicar. Não há nota mínima obrigatória - você decide quais publicar independentemente da avaliação atribuída.

Destacar na home sem ativar

Marcar Destaque sem marcar Ativo salva a configuração mas o depoimento continua oculto do site. O destaque só passa a valer no momento em que o depoimento é ativado. Útil para preparar uma fornada de depoimentos premium e ligá-los todos de uma vez antes de uma campanha.

Foto vinda de URL externa

O campo foto aceita tanto caminho relativo (armazenado em tenancy/assets/depoimentos/...) quanto URL externa começada por http. O acessor foto_url no model detecta o tipo: se começar com http, usa direto; senão, prefixa com /tenancy/assets/. Isso permite reaproveitar avatares do Google da pesquisa NPS sem precisar fazer download.

Busca por nome ou texto

O filtro Buscar por nome ou texto procura o termo digitado tanto na coluna nome quanto na coluna depoimento (via LIKE %termo%). Use para localizar rapidamente um cliente específico ou para encontrar depoimentos que mencionem um destino ("Gramado", "Bonito").

Erros comuns e como resolver

• "O nome é obrigatório." - Causa: o campo nome ficou em branco. Solução: preencher antes de salvar.
• "O depoimento é obrigatório." - Causa: o textarea ficou em branco. Solução: digitar o texto do depoimento (mínimo 1, máximo 2000 caracteres).
• "A avaliação mínima é 1 estrela." / "A avaliação máxima é 5 estrelas." - Causa: o campo avaliacao foi enviado fora do intervalo 1–5 (normalmente só acontece via edição manual no DevTools). Solução: recarregar a página e clicar nas estrelas normalmente.
• Depoimento da pesquisa não apareceu na lista - Causa: o cliente respondeu a pesquisa mas deixou o campo de texto vazio. Sem texto, nenhum registro é criado. Solução: enviar a pesquisa novamente ou cadastrar manualmente o depoimento.
• Depoimento não aparece no site mesmo com Ativo marcado - Causa: a seção de depoimentos pode estar oculta na configuração da home. Solução: verificar em Vitrine > Seções da Home se o bloco de depoimentos está habilitado.

Onde encontrar

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

Veja também

• Seções da Home - habilitar e ordenar o bloco de depoimentos na página inicial do site público
• Hero Slides do Carrossel - outra fonte de impacto visual logo no topo da home
• Diferenciais da Empresa - reforçar a prova social com os pontos fortes do negócio