# Assistente de Escolha de Produto: documentação > O Assistente de Escolha de Produto (módulo dffinder) transforma um catálogo complexo num percurso de compra guiado. Constrói uma árvore de perguntas no back-office; o visitante responde etapa a etapa… - Página: - Idioma: pt - Atualizado em: 2026-09-02 - Outros idiomas: [fr](https://www.datafirefly.com/documentation/product-finder/index.md), [en](https://www.datafirefly.com/en/documentation/product-finder/index.md), [es](https://www.datafirefly.com/es/documentation/product-finder/index.md), [de](https://www.datafirefly.com/de/documentation/product-finder/index.md), [it](https://www.datafirefly.com/it/documentation/product-finder/index.md), [pl](https://www.datafirefly.com/pl/documentation/asystent-wyboru-produktu-prestashop/index.md), [nl](https://www.datafirefly.com/nl/documentation/product-finder/index.md) - Índice: O **Assistente de Escolha de Produto** (módulo `dffinder`) transforma um catálogo complexo num percurso de compra guiado. Constrói uma árvore de perguntas no back-office; o visitante responde etapa a etapa e chega a uma seleção de produtos filtrada, exatamente como faria um vendedor especializado na loja. ## Apresentação O módulo destina-se a catálogos em que o cliente hesita: colchões, bicicletas, informática, cosmética, peças sobresselentes. Cada resposta do questionário está ligada a um ou vários critérios do seu catálogo (atributos, características, categorias, fabricantes, escalões de preço) e o módulo traduz as escolhas do visitante numa pesquisa de produtos nativa. - Construtor da árvore de perguntas por arrastar e largar, sem código. - Perguntas de escolha única ou múltipla, títulos e legendas multilingues. - Contador de produtos correspondentes em tempo real em cada etapa. - Página de resultados nativa (ordenação e paginação do tema) através de `ProductSearchProviderInterface`. - Apresentação em widget na página inicial, etiqueta de widget ou página dedicada. - Compatível com o PrestaShop 8.0 a 9.x, multiloja e multilingue. ## Instalação 1. Vá a _Módulos > Gestor de módulos > Carregar um módulo_. 2. Selecione o ficheiro `dffinder-1.0.0.zip` e valide a instalação. 3. O módulo cria as suas tabelas, um separador de administração **DF Product Finder** e as rotas reescritas `product-finder` e `product-finder/results`. Depois da instalação, se os URL `product-finder` não responderem, regenere as ligações: _Parâmetros avançados > Desempenho > Limpar a cache_ e verifique depois se os URL simplificados estão ativados em _Tráfego e SEO_. ## Criar um primeiro assistente Abra _Módulos > DF Product Finder_ e clique em **Adicionar um assistente**. Dê-lhe um nome interno e um texto de introdução apresentado no topo do questionário. O construtor organiza-se em colunas: as perguntas à esquerda, as respostas de cada pergunta e os mapeamentos de cada resposta. ### Acrescentar perguntas Clique em **Adicionar uma pergunta**. Para cada pergunta, indique: - o **título** (por exemplo, «Para que utilização?») e um **texto de ajuda** facultativo; - o **tipo de apresentação**: escolha única (uma só resposta, com avanço automático) ou escolha múltipla (várias respostas assinaláveis); - a ordem, arrastando a pergunta para a posição pretendida. ### Acrescentar respostas Por baixo de cada pergunta, acrescente as respostas propostas ao visitante (por exemplo, «Desporto», «Cidade», «Criança»). Cada resposta tem uma legenda multilingue e reordena-se por arrastar e largar dentro da sua pergunta. ### Mapear as respostas para o catálogo É o coração do módulo: cada resposta aponta para um ou vários critérios de produto. Os tipos de mapeamento disponíveis são: - **Atributo** — um valor de atributo de combinação (tamanho, cor...), procurado nas combinações de produto; - **Característica** — um valor de característica de produto; - **Categoria** — a pertença a uma categoria; - **Fabricante** — a marca do produto; - **Preço** — um intervalo `min`/`max` sobre o preço base da loja. Os campos de atributo, característica, categoria e fabricante têm preenchimento automático: escreva algumas letras para encontrar o valor. Uma mesma resposta pode acumular vários mapeamentos (por exemplo, uma categoria _e_ um intervalo de preço). Os intervalos de preço filtram pelo **preço base sem impostos** do produto para a loja atual (`product_shop.price`). Os impostos e os preços específicos (promoções, preços por grupo) não são aplicados neste filtro. Quando a sua árvore estiver pronta, clique em **Gravar**. A gravação é idempotente: a árvore completa é reconstruída em cada gravação, o que garante um estado coerente. ## Compreender o motor de correspondência O módulo combina as escolhas do visitante segundo duas regras simples: - **OU** entre as respostas de uma mesma pergunta: assinalar «Desporto» e «Cidade» alarga a seleção aos produtos que correspondam a uma _ou_ a outra. - **E** entre as perguntas: os critérios de cada pergunta ultrapassada acumulam-se para restringir a seleção. Em cada etapa, o módulo recalcula por AJAX o número de produtos correspondentes e apresenta-o ao visitante, o que evita chegar a uma seleção vazia. ## Apresentar o assistente ### Widget na página inicial Ative a apresentação na página inicial a partir da configuração do módulo. O widget apresenta um cartão com apelo à ação que leva ao questionário. ### Etiqueta de widget Para inserir o assistente em qualquer ponto de um template do seu tema, utilize a etiqueta Smarty: ``` {widget name='dffinder' id_finder=1} ``` Substitua `id_finder` pelo identificador do assistente pretendido (visível na lista do back-office). ### URL dedicados O questionário também está diretamente acessível através de URL limpos, práticos para as suas campanhas: - `a-sua-loja/product-finder` — o questionário; - `a-sua-loja/product-finder/results?answers=1,4,9` — a página de resultados. ## A página de resultados No fim do questionário, o visitante é encaminhado para uma página de resultados que estende o controlador de listagem nativo do PrestaShop. Na prática, obtém sem qualquer configuração adicional: - o modelo de lista de produtos do seu tema; - a ordenação por data, preço ou nome; - a paginação padrão. Uma ligação **Recomeçar** permite ao visitante relançar o questionário desde o início. ## Multiloja e multilingue O módulo está associado ao contexto de loja: cada assistente pertence à loja ou lojas à sua escolha. Todos os textos (nome, introdução, títulos das perguntas, legendas das respostas) podem ser introduzidos por idioma, através do seletor de idioma de edição presente no topo do construtor. ## Resolução de problemas **O contador apresenta sempre zero.** Verifique se os mapeamentos apontam para valores realmente utilizados pelos seus produtos (atributo ou característica devidamente atribuídos aos produtos) e se os produtos estão ativos e associados à loja atual. **O intervalo de preço não filtra como esperado.** Lembre-se de que o filtro se aplica ao preço base sem impostos, sem preços específicos. Um produto em promoção continua a ser filtrado pelo preço de catálogo. **Boa prática.** Comece por uma pergunta geral (utilização, perfil) e afine depois (orçamento, tamanho). Limite cada pergunta a algumas respostas claras para manter um percurso fluido.