Documentação
Activa o Findalo na tua loja em 10 minutos.
Os guias passo a passo para cada plataforma, a API e o painel. Se ficares preso, escreve-nos para hola@findalo.io — lemos tudo.
Instalação por plataforma
- Disponível
PrestaShop 1.7 / 8.x / 9.x
Módulo nativo. Compatível com o tema Classic, Hummingbird e custom.
- Disponível
Shopify
App pública: ligas a tua loja com um clique a partir do painel e ativas a pesquisa no tema sem mexer no código. Sem módulo nem tokens.
- Disponível
WooCommerce
Plugin WordPress oficial. Compatível com WPML/Polylang e caches WP.
- Disponível
Magento 2 / Adobe Commerce
Módulo nativo. Descarregável a partir do teu painel. PHP 8.2/8.3/8.4. Compatível com Hyvä e PWA Studio.
- Disponível
Shopware 6
App nativa (sem PHP). Descarregável a partir do teu painel. Compatível com Shopware 6.6 e 6.7, Storefront / Headless.
Requisitos técnicos mínimos
O que a tua loja precisa para instalar o módulo Findalo. Se o teu stack estiver abaixo disto, diz-nos em hola@findalo.io e vemos o que fazer.
| Plataforma | Módulo | Plataforma compatível | PHP | Outros requisitos |
|---|---|---|---|---|
| PrestaShop | v1.9.11 Actualizado 30/10/2026 | 1.7.6.0 – 9.x (multi-shop soportado) | 7.2+ (8.1+ recomendado) | cURL y JSON activos · URL de la tienda alcanzable públicamente para sync (endpoint /module/findalo/feed) · cualquier tema (Classic, Hummingbird, custom) |
| WooCommerce | v1.5.2 Ficha em WordPress.org ↗ Actualizado 31/10/2026 | WordPress 6.0+ WooCommerce 7.0+ (probado hasta WP 7.1 y WC 11.1) en el directorio de WordPress.org | 7.4+ | WPML o Polylang autodetectados · compatible con WP Rocket / LiteSpeed Cache · temas Storefront / Hello Elementor / Astra / Blocksy verificados |
| Magento | v1.3.8 Ficha em Adobe Commerce Marketplace ↗ Actualizado 11/09/2026 | Magento 2.4 Adobe Commerce (Open Source, on-premise y cloud) en Adobe Commerce Marketplace | 8.2 / 8.3 / 8.4 / 8.5 | Módulos estándar: Magento_Catalog, Magento_Config, Magento_Backend · Composer recomendado |
| Shopify | App pública Se conecta desde tu panel (Conectar con Shopify) | Cualquier plan Shopify (incl. Basic, Shopify, Advanced, Plus) | — | Acceso al admin de Shopify con permiso para instalar apps · la app pide leer el catálogo y el inventario (read_products, read_inventory), los eventos de compra para la analítica (write_pixels, read_customer_events) y las páginas y políticas de la tienda para el asistente (read_content, read_legal_policies) · cualquier tema: el buscador se activa como incrustación de app en el editor de temas, sin tocar código |
| Shopware | v0.8.3 App nativa (sin PHP) Actualizado 8/09/2026 | Shopware 6.4 – 6.7+ (App nativa, Storefront) | — | App de Shopware (sin PHP, resiliente a versiones) · instalar vía Extensiones → Subir extensión · Admin API accesible para la sincronización (pull del catálogo) · cualquier tema |
O widget no navegador funciona no Chrome, Firefox, Safari e Edge actuais e nas duas versões anteriores. Sem dependências de jQuery nem do teu tema.
PrestaShop — passos essenciais
Módulo nativo para PrestaShop 1.7.6 – 9.x, multiloja incluído. ~10 minutos. A loja liga-se com um botão a partir do próprio módulo: não copias tokens nem mexes em URLs.
- 1 · Instala o módulo
Entra no teu painel de cliente (ou regista-te gratuitamente) → Integração → separador PrestaShop → Descarregar ZIP: sempre a última versão publicada. No teu back office: Módulos → Gestor de módulos → Carregar um módulo, arrasta o ZIP e clica em Instalar.
- 2 · Estabelece a ligação
Em Módulos → Gestor de módulos (①) procura Findalo e clica em Configurar. No separador Configuração clica em Connect with findalo (②). Abre-se panel.findalo.io: inicia sessão com a tua conta Findalo (ou cria-a ali mesmo), escolhe o motor de pesquisa e clica em Ligar esta loja. Voltas ao módulo já ligado: a credencial viaja de servidor para servidor, nunca a vês nem a copias.
- 3 · Confirma que tudo chega
O módulo mostra ✓ Connected · o-teu-motor. O catálogo é enviado sozinho: no teu painel → Sincronização os produtos aparecem em poucos minutos e, a partir daí, cada alteração de produto, preço ou stock chega automaticamente. Para forçar um envio: separador Estado do módulo → Mark as pending (force next rebuild), ou Sincronizar agora no painel. Recarrega a tua loja e clica na lupa: a pesquisa abre com os teus produtos.
Se não puderes usar o botão
Se a janela do painel não abrir ou o regresso ao módulo se cortar (bloqueador de pop-ups, redirecionamento partido pelo alojamento), liga manualmente: no teu painel → Integração → separador PrestaShop copia o ID do motor e o Token de sincronização; no módulo expande Connection not working? Connect manually, cola os dois valores e clica em Save manual connection. O resultado é o mesmo que com o botão.
WooCommerce — passos essenciais
Plugin oficial de WordPress para WooCommerce. ~10 minutos. WPML e Polylang detetam-se sozinhos; compatível com WP Rocket e LiteSpeed Cache. Demo ao vivo: woocommerce.findalo.io/shop.
- 1 · Instala o plugin
No teu WordPress: Plugins → Adicionar novo, procura «Findalo», clica em Instalar agora e depois em Ativar. Também podes carregar o ZIP (Carregar plugin) descarregado do teu painel (Integração → separador WooCommerce) ou de WordPress.org. Ao ativar abre-se um assistente breve; não é preciso completá-lo: a ligação do passo 2 deixa tudo pronto. Ainda não tens conta? Regista-te gratuitamente — ou cria-a durante a ligação.
- 2 · Estabelece a ligação
No menu lateral, WooCommerce → Findalo (①), separador General, cartão Connection: clica em Connect with Findalo (②). Abre-se panel.findalo.io: inicia sessão com a tua conta Findalo (ou cria-a ali mesmo), escolhe o motor de pesquisa e clica em Ligar esta loja. Voltas ao plugin já ligado; nunca vês nem copias tokens.
- 3 · Confirma que tudo chega
No cartão Connection vês ✓ Connected · o-teu-motor e o botão Verify connection para a verificares quando quiseres. O plugin publica o catálogo sozinho e mantém-no atualizado a cada alteração de produto, preço ou stock; no teu painel → Sincronização os produtos aparecem em poucos minutos. Para forçar um envio: separador Status do plugin → Mark as pending (force next rebuild), ou Sincronizar agora no painel. Abre a tua loja e clica na lupa.
Se não puderes usar o botão
Se a janela do painel não abrir ou o regresso ao plugin se cortar (bloqueador de pop-ups, redirecionamento partido pelo alojamento), liga manualmente: no teu painel → Integração → separador WooCommerce copia o ID do motor e o Token de sincronização; no plugin expande Connection not working? Connect manually, cola os dois valores e clica em Save manual connection. O resultado é o mesmo que com o botão.
Shopify — passos essenciais
App pública de Shopify. ~5 minutos. Nada para instalar num servidor, sem tokens nem código: ligas a loja com um clique a partir do teu painel Findalo.
- 1 · Liga a tua loja
Entra no teu painel de cliente (ou regista-te gratuitamente) → Integração → separador Shopify. Escreve o domínio da tua loja (
a-tua-loja.myshopify.com) e clica em Ligar ao Shopify. - 2 · Autoriza a app na Shopify
Abre-se o admin da tua loja e a Shopify mostra as permissões que a app pede (catálogo e inventário, eventos de compra para as estatísticas e páginas da loja para o assistente): confirma com Instalar. Voltas ao painel com a loja ligada e o catálogo sincroniza-se sozinho pela API da Shopify. A partir daí também tens o Findalo em Apps → Findalo, dentro do teu admin da Shopify e com a sessão já iniciada.
- 3 · Ativa a pesquisa no teu tema
Loja online → Temas → Personalizar → Incorporações de apps (o botão Abrir o editor de temas do painel leva-te diretamente), ativa Findalo e guarda. Clica na lupa da tua loja: a pesquisa abre com os teus produtos. As alterações de produto, preço ou stock chegam sozinhas; para forçar uma sincronização: painel → Sincronização → Sincronizar agora.
Se algo não bater certo
A app não usa tokens nem códigos de ligação. Se a pesquisa não aparecer na tua loja, confirma que a incorporação Findalo está ativa no tema e que a app continua instalada em Apps. Ao desinstalar a app, a loja desliga-se sozinha.
Magento — passos essenciais
Módulo nativo para Magento 2.4 e Adobe Commerce, publicado no Adobe Commerce Marketplace. ~10 minutos. PHP 8.2 – 8.5. Compatível com Hyvä e storefronts headless.
- 1 · Instala o módulo
A partir do Adobe Commerce Marketplace, com Composer (as chaves de repo.magento.com estão na tua conta Adobe):
composer require findalo/magento-search bin/magento module:enable Findalo_Search bin/magento setup:upgrade bin/magento cache:flushEm produção acrescenta
bin/magento setup:di:compileebin/magento setup:static-content:deployse a tua pipeline o exigir. Sem Composer: descarrega o ZIP do teu painel (Integração → separador Magento) e descompacta-o emapp/code/Findalo/Search— uma das duas vias, nunca as duas ao mesmo tempo. - 2 · Estabelece a ligação
No admin do Magento, menu lateral Findalo → Configuration (①). No separador Configuration clica em Connect with findalo (②). Abre-se panel.findalo.io: inicia sessão com a tua conta Findalo (ou cria-a ali mesmo), escolhe o motor de pesquisa e clica em Ligar esta loja. Voltas ao módulo já ligado: a credencial viaja de servidor para servidor, nunca a vês nem a copias.
- 3 · Confirma que tudo chega
Junto ao botão vês ✓ Connected · o-teu-motor. O módulo envia o catálogo sozinho (em multi-store, cada vista de loja em separado) e mantém-no atualizado; no teu painel → Sincronização os produtos aparecem em poucos minutos. Para forçar um envio: separador Status → Mark as pending (force next rebuild), ou Sincronizar agora no painel. Se o widget não aparecer na tua loja, limpa as caches:
bin/magento cache:flush.
Se não puderes usar o botão
Se a janela do painel não abrir ou o regresso ao módulo se cortar (bloqueador de pop-ups, redirecionamento partido pelo alojamento), liga manualmente: no teu painel → Integração → separador Magento copia o ID do motor e o Token de sincronização; no módulo expande Connection not working? Connect manually, cola os dois valores nos seus campos e clica em Save. O resultado é o mesmo que com o botão.
Shopware — passos essenciais
App nativa de Shopware (sem PHP) para 6.6 e 6.7. ~10 minutos. A loja liga-se à tua conta Findalo a partir do próprio admin com um código por e-mail: sem tokens.
- 1 · Instala a app
Entra no teu painel de cliente (ou regista-te gratuitamente) → Integração → separador Shopware → Descarregar ZIP. No teu admin Shopware: Extensões → As minhas extensões → Carregar extensão, instala e ativa aceitando as permissões (leitura do catálogo e da configuração). Por CLI:
bin/console app:install --activate FindaloSearch bin/console cache:clearAo ativar-se, a app regista-se automaticamente no Findalo. Requisito: a loja tem de estar acessível por HTTPS a partir da Internet (o Findalo lê o catálogo pela Admin API).
- 2 · Liga a loja à tua conta
Abre Extensões → Findalo. Escreve o e-mail da tua conta Findalo e clica em Enviar código; introduz o código de 6 dígitos que recebes e clica em Verificar y vincular (verificar e ligar). Na tabela de canais, associa cada sales channel Storefront a um motor da tua conta (coluna Buscador): só o canal associado é ligado e indexado. Precisas de outro motor? Cria-o no painel e clica em ↻ Refrescar (atualizar) na app.
- 3 · Confirma que tudo chega
Verás Conectado a Findalo (ligado) e, por canal, produtos e última sincronização. O catálogo sincroniza-se pela Admin API e as alterações chegam sozinhas; Re-sincronizar força um envio e Gestionar buscadores ↗ abre o teu painel. O widget é injetado no Storefront automaticamente: recarrega a tua loja e clica na lupa.
Se o código não chegar ou algo não bater certo
Verifica o spam e que o endereço é o da tua conta Findalo; podes pedir outro código com Enviar código. Desconectar pausa os motores sem apagar nada: voltas a ligar com um clique, sem reinstalar. Se o teu Shopware não permitir carregar extensões a partir do admin, usa o comando CLI do passo 1.
Recursos rápidos
API e endpoints
URL base pública: https://api.findalo.io
GET /api/<motor>/search?q=<query>- Pesquisa principal. Devolve resultados, facetas e total. A origin deve estar em
allowed_domainsdo teu motor de pesquisa. GET /api/<motor>/suggest?q=<query>- Autocompletar. Chama-o à velocidade de escrita; tem um rate limit mais generoso do que /search.
GET /api/public-config/<motor>- Configuração pública do teu motor de pesquisa: tema, layout, plano. O que o widget usa ao arrancar.
POST /api/<motor>/track- Rastreio de eventos (cliques, adições ao carrinho, conversões). Body JSON.
Documentação detalhada com exemplos cURL e SDKs a caminho. Precisas de algo concreto agora? Escreve-nos.
Recomendações (plano Pro+)
Blocos de produtos sugeridos na ficha, no carrinho e na página inicial — sem que o visitante faça qualquer pesquisa. O motor agrega os teus eventos de view/add-to-cart com decay de 30 dias e materializa três índices: co-visitados, co-adicionados ao carrinho e bestsellers.
Auto-inject (PrestaShop)
O módulo já inclui os hooks displayFooterProduct, displayShoppingCartFooter e displayHome. Configura o back office e activa os slots — zero código.
Integração custom (outras plataformas)
// Na ficha de produto:
findalo.reco({
context: 'similar',
productId: '123',
target: '#findalo-similar-slot',
title: 'Também podes gostar',
});
// Ao carregar a ficha:
findalo.trackView('123');
// Ao adicionar ao carrinho:
findalo.trackAddToCart('123');
// Recently viewed (cliente, sem tráfego para o backend):
findalo.recentlyViewed(); // → ['123', '456', ...]Endpoint
GET /api/<motor>/recommend?context=similar|fbt|bestsellers&product_id=<id>&limit=8 · plano ≥ Pro ou devolve 402.
Algo não está a funcionar?
Envia-nos um email para hola@findalo.io com o URL da tua loja e o que está a falhar. Respondemos pessoalmente em horário laboral.