Activa o Findalo na tua loja em 10 minutos.

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.

• Beta — self-service

  Shopify

  Custom App + snippet em theme.liquid. App oficial no Partners a caminho.

• 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

  Plugin nativo. Descarregável a partir do teu painel. Compatível com Shopware 6.6+ e 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.

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

1. 1 · Descarregar

   Entra no teu painel de cliente e abre Integrações → Módulo PrestaShop. Clica em Descarregar ZIP — damos-te sempre a última versão publicada. Ainda não tens conta? Regista-te gratuitamente.

2. 2 · Carrega e instala

   No PrestaShop BO: Módulos → Gestor de módulos → Carregar um módulo. Arrasta o ZIP e clica em Instalar.

3. 3 · Configura

   Clica em Configurar no módulo Findalo. Preenche:

   • URL do motor de pesquisa: o slug que tens no teu painel findalo.io (vês-o assim que te registas).
   • Feed token: deixa vazio para gerar um forte automaticamente. Copia-o depois para o teu painel findalo.io.
   • Trigger selector: deixa o valor por omissão (cobre o tema Classic e a maioria). Muda-o apenas se o teu tema usar selectores custom.
4. 4 · Activa

   Marca «Carregar o bundle do motor de pesquisa em todas as páginas» e grava. Recarrega a tua loja, clica na lupa do tema — o widget abre um modal em ecrã completo e os produtos aparecem instantaneamente.

5. 5 · Verifica a sincronização

   Em findalo.io → o teu motor de pesquisa → Estado do catálogo: deverás ver os teus produtos indexados em menos de 5 minutos. Se não, verifica que o teu PrestaShop está acessível a partir da internet (a sincronização faz polling a cada 5 min ao endpoint /module/findalo/feed).

WooCommerce — passos essenciais

Plugin WordPress standard. ~10 minutos. Compatível com WPML, Polylang, WP Rocket, LiteSpeed Cache e os temas Storefront / Hello Elementor / Astra / Blocksy. Demo ao vivo: woocommerce.findalo.io/shop.

1. 1 · Descarrega o plugin

   Entra no teu painel → Integração → separador WooCommerce → Descarregar ZIP. Damos-te sempre a última versão publicada. Se ainda não tens conta, regista-te gratuitamente.

2. 2 · Carrega e instala no WordPress

   No teu WordPress admin: Plugins → Adicionar novo → Carregar plugin. Arrasta o ZIP e clica em Instalar, depois Activar.

3. 3 · Configura o plugin

   No menu WooCommerce → Findalo. Preenche:

   • Your search URL: o slug que vês no teu painel findalo.io (escolhes-o ao registares-te).
   • Feed token (Bearer): o que aparece no painel findalo — copia-o e cola-o aqui. Se estiver vazio, o plugin gera um e depois copias-o para o painel.
   • Trigger selector: deixa o valor por omissão — cobre o bloco de pesquisa do Gutenberg, o search-field clássico e o formulário de pesquisa de produtos.

   Grava. O plugin injeta o widget em wp_head automaticamente.

4. 4 · Força a primeira sincronização

   Na mesma página de configurações do plugin, clica em «Mark as pending (force next rebuild)». Aguarda 5 a 10 segundos. O plugin constrói o JSON do catálogo e envia-o para findalo.io (push assíncrono — a página regressa sem esperar pelo envio).

5. 5 · Verifica

   Em findalo.io → o teu motor de pesquisa → Sincronização: deverás ver os produtos sincronizados com sync_source: push. Abre a tua loja, clica na lupa — o modal findalo abre com os teus produtos. A partir de agora, qualquer alteração em produto, stock ou preço será reflectida em ≤10 min (throttle anti-spam no stock).

6. 6 · Suporte multilingue (opcional)

   Se usares WPML ou Polylang, o plugin detecta-os automaticamente e publica cada produto traduzido sob a sua locale (ISO 2 letras). Sem configuração adicional.

Shopify — passos essenciais

Enquanto a app oficial chega ao Shopify App Store, o conector funciona em modo Custom App. ~10 minutos de ponta a ponta. Usa a dev store de demonstração (pass 1234) como referência do resultado final.

1. 1 · Cria uma conta findalo

   Regista-te em findalo.io (o plano Free é suficiente para testar). Anota o teu slug — precisarás dele no último passo.

2. 2 · Cria uma Custom App no Shopify

   No teu Shopify Admin: Settings → Apps and sales channels → Develop apps → Create an app. Dá-lhe o nome que quiseres (ex. "findalo-search").

3. 3 · Activa os scopes

   Dentro da app: Configuration → Admin API integration → Configure. Marca:

   • read_products
   • read_product_listings
   • read_collections
   • read_inventory

   Save em baixo à direita.

4. 4 · Instala a app e copia o token

   Clica em Install app no canto superior direito. Chegas a API credentials: copia o Admin API access token (começa por shpat_ e tem 38 caracteres).

   ⚠ O Shopify mostra o token uma única vez. Se cometeres um erro ou fechares o separador, terás de rodar as credenciais e gerar um novo.

5. 5 · Liga o findalo no painel

   No teu painel findalo: Integração → separador Shopify. Cola:

   • Domínio: a-tua-loja.myshopify.com
   • Admin API access token: o shpat_… do passo 4

   Clica em Ligar e sincronizar. Validamos as credenciais com o Shopify e importamos o teu catálogo em segundos. Verás "Ligado a a-tua-loja.myshopify.com".

6. 6 · Cola o snippet no tema

   No Shopify Admin: Online Store → Themes → ⋯ → Edit code → layout/theme.liquid. Mesmo antes de </body>:

   <script src="https://widget.findalo.io/widget.js" data-tenant="O_TEU_SLUG" defer></script>

   Substitui O_TEU_SLUG pelo slug do passo 1. Grava. Recarrega a tua loja e clica na lupa — o widget findalo abre o modal com os teus produtos.

7. 7 · Sincronização contínua automática

   A partir daqui: o cron do findalo faz pull a cada 5 min. Alteras preços, stock ou produtos no Shopify → o findalo reindexa sozinho em menos de 5 minutos. Zero infra-estrutura da tua parte. Para forçar uma sincronização manual: painel → Sincronização → Sincronizar agora.

Magento — passos essenciais

Módulo nativo para Magento 2 e Adobe Commerce. ~10 minutos. Requer PHP 8.2, 8.3 ou 8.4. Compatível com Hyvä Themes e storefronts PWA Studio / headless.

1. 1 · Descarrega o módulo

   Entra no teu painel → Integração → separador Magento → Descarregar ZIP. Damos-te sempre a última versão publicada. Se ainda não tens conta, regista-te gratuitamente.

2. 2 · Carrega o módulo para o teu Magento

   Descomprime o ZIP e copia a pasta para app/code/Findalo/Search do teu Magento. Via SSH:

   mkdir -p app/code/Findalo/Search
   unzip findalo-magento-*.zip -d app/code/Findalo/Search

3. 3 · Activa o módulo

   A partir da raiz do teu Magento:

   bin/magento module:enable Findalo_Search
   bin/magento setup:upgrade
   bin/magento cache:flush

   Em produção adiciona bin/magento setup:di:compile e bin/magento setup:static-content:deploy se o teu pipeline o exigir.

4. 4 · Configura

   No Magento Admin: Stores → Configuration → Findalo → General. Preenche:

   • Search URL: o slug que vês no teu painel findalo.io.
   • Feed token: copia-o do painel findalo e cola-o aqui, ou deixa vazio para o gerar automaticamente.
   • Trigger selector: deixa o valor por omissão — cobre os temas Luma, Blank e Hyvä.

   Grava e limpa as caches: bin/magento cache:flush.

5. 5 · Verifica a sincronização

   Em findalo.io → o teu motor de pesquisa → Estado do catálogo: deverás ver os teus produtos indexados em menos de 5 minutos. Se usares multi-store ou multi-website, cada vista é indexada separadamente e identificada pelo seu store_code. Recarrega a tua loja, clica na lupa — o widget abre o modal com os teus produtos.

Shopware — passos essenciais

Plugin nativo para Shopware 6.6 e versões superiores. ~10 minutos. Compatível com Storefront clássico e storefronts headless.

1. 1 · Descarrega o plugin

   Entra no teu painel → Integração → separador Shopware → Descarregar ZIP. Damos-te sempre a última versão publicada. Se ainda não tens conta, regista-te gratuitamente.

2. 2 · Carrega o plugin para o Shopware

   No teu Shopware Admin: Extensões → As minhas extensões → Carregar extensão. Arrasta o ZIP. Via CLI:

   bin/console plugin:refresh
   bin/console plugin:install --activate FindaloSearch
   bin/console cache:clear

3. 3 · Configura

   No Shopware Admin: Extensões → Findalo Search → Configurar. Preenche:

   • Search URL: o slug que vês no teu painel findalo.io.
   • Feed token: copia-o do painel findalo e cola-o aqui, ou deixa vazio para o gerar automaticamente.
   • Trigger selector: deixa o valor por omissão — cobre os temas Storefront por omissão.

   Grava. O plugin injeta o widget no Storefront automaticamente.

4. 4 · Verifica a sincronização

   Em findalo.io → o teu motor de pesquisa → Estado do catálogo: deverás ver os teus produtos indexados em menos de 5 minutos. Se usares multi-sales-channel, cada um é indexado separadamente. Recarrega o teu Storefront, clica na lupa — o widget abre o modal com os teus produtos.

Recursos rápidos

API e endpoints

Recomendações (plano Pro+)

// 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', ...]