Findalo
Comença gratis

Documentació

Activa Findalo a la teva botiga en 10 minuts.

Les guies pas a pas per a cada plataforma, l'API i el panell. Si t'encalles, escriu-nos a hola@findalo.io — llegim tot.

Instal·lació per plataforma

Requisits tècnics mínims

El que necessita la teva botiga per instal·lar el mòdul Findalo. Si el teu stack és per sota, digues-nos-ho a hola@findalo.io i veiem què fer.

Plataforma Mòdul Plataforma compatible PHP Altres requisits
PrestaShop v1.9.11
Actualitzat 30 d’oct. del 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
Fitxa a WordPress.org ↗
Actualitzat 31 d’oct. del 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
Fitxa a Adobe Commerce Marketplace ↗
Actualitzat 11 de set. del 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)
Actualitzat 8 de set. del 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

El widget al navegador funciona a Chrome, Firefox, Safari i Edge actuals i a les dues versions anteriors. Sense dependències de jQuery ni del teu tema.

PrestaShop — passos essencials

Mòdul natiu per a PrestaShop 1.7.6 – 9.x, multibotiga inclòs. ~10 minuts. La botiga es connecta amb un botó des del mateix mòdul: no copies tokens ni toques URLs.

Back office de PrestaShop amb el mòdul Findalo obert: ① el menú Mòduls i ② el botó Connect with findalo
① Mòduls → Gestor de mòduls → Findalo → Configurar · ② botó Connect with findalo (hi posa «Reconnect with findalo» si la botiga ja estava connectada).
  1. 1 · Instal·la el mòdul

    Entra al teu panell de client (o dona't d'alta gratis) → Integració → pestanya PrestaShop → Descarregar ZIP: sempre l'última versió publicada. Al teu back office: Mòduls → Gestor de mòduls → Pujar un mòdul, arrossega el ZIP i prem Instal·lar.

  2. 2 · Estableix la connexió

    A Mòduls → Gestor de mòduls (①) busca Findalo i prem Configurar. A la pestanya Configuració prem Connect with findalo (②). S'obre panel.findalo.io: inicia sessió amb el teu compte Findalo (o crea'l allà mateix), tria el cercador i prem Connectar aquesta botiga. Tornes al mòdul ja connectat: la credencial viatja de servidor a servidor, mai la veus ni la copies.

  3. 3 · Comprova que tot arriba

    Al mòdul veuràs ✓ Connected · el-teu-cercador. El catàleg s'envia sol: al teu panell → Sincronització hi apareixen els productes en uns minuts i, a partir d'aquí, cada canvi de producte, preu o estoc arriba automàticament. Per forçar un enviament: pestanya Estat del mòdul → Mark as pending (force next rebuild), o Sincronitzar ara al panell. Recarrega la botiga i prem la lupa: el cercador s'obre amb els teus productes.

Si no pots fer servir el botó

Si la finestra del panell no s'obre o la tornada al mòdul es talla (bloquejador de finestres emergents, redirecció trencada per l'allotjament), connecta a mà: al teu panell → Integració → pestanya PrestaShop copia l'ID del cercador i el Token de sincronització; al mòdul desplega Connection not working? Connect manually, enganxa els dos valors i prem Save manual connection. El resultat és el mateix que amb el botó.

WooCommerce — passos essencials

Plugin oficial de WordPress per a WooCommerce. ~10 minuts. WPML i Polylang es detecten sols; compatible amb WP Rocket i LiteSpeed Cache. Demo en viu: woocommerce.findalo.io/shop.

Administració de WordPress amb el plugin Findalo obert: ① el menú WooCommerce → Findalo i ② el botó Connect with Findalo
① WooCommerce → Findalo · ② botó Connect with Findalo (hi posa «Reconnect with Findalo» si la botiga ja estava connectada).
  1. 1 · Instal·la el plugin

    Al teu WordPress: Extensions → Afegeix, busca «Findalo», prem Instal·la ara i després Activa. També pots pujar el ZIP (Puja una extensió) descarregat des del teu panell (Integració → pestanya WooCommerce) o des de WordPress.org. En activar-lo s'obre un assistent breu; no cal completar-lo: la connexió del pas 2 ho deixa tot a punt. Encara no tens compte? Dona't d'alta gratis — o crea'l durant la connexió.

  2. 2 · Estableix la connexió

    Al menú lateral, WooCommerce → Findalo (①), pestanya General, targeta Connection: prem Connect with Findalo (②). S'obre panel.findalo.io: inicia sessió amb el teu compte Findalo (o crea'l allà mateix), tria el cercador i prem Connectar aquesta botiga. Tornes al plugin ja connectat; mai veus ni copies tokens.

  3. 3 · Comprova que tot arriba

    A la targeta Connection veuràs ✓ Connected · el-teu-cercador i el botó Verify connection per comprovar-la quan vulguis. El plugin publica el catàleg sol i el manté al dia amb cada canvi de producte, preu o estoc; al teu panell → Sincronització hi apareixen els productes en uns minuts. Per forçar un enviament: pestanya Status del plugin → Mark as pending (force next rebuild), o Sincronitzar ara al panell. Obre la botiga i prem la lupa.

Si no pots fer servir el botó

Si la finestra del panell no s'obre o la tornada al plugin es talla (bloquejador de finestres emergents, redirecció trencada per l'allotjament), connecta a mà: al teu panell → Integració → pestanya WooCommerce copia l'ID del cercador i el Token de sincronització; al plugin desplega Connection not working? Connect manually, enganxa els dos valors i prem Save manual connection. El resultat és el mateix que amb el botó.

Shopify — passos essencials

App pública de Shopify. ~5 minuts. Res a instal·lar en un servidor, sense tokens ni codi: connectes la botiga amb un clic des del teu panell de Findalo.

  1. 1 · Connecta la teva botiga

    Entra al teu panell de client (o dona't d'alta gratis) → Integració → pestanya Shopify. Escriu el domini de la teva botiga (la-teva-botiga.myshopify.com) i prem Connectar amb Shopify.

  2. 2 · Autoritza l'app a Shopify

    S'obre l'admin de la teva botiga i Shopify et mostra els permisos que demana l'app (catàleg i inventari, esdeveniments de compra per a l'analítica i pàgines de la botiga per a l'assistent): confirma'ls amb Instal·lar. Tornes al panell amb la botiga connectada i el catàleg se sincronitza sol per l'API de Shopify. A partir d'aquí també tens Findalo a Apps → Findalo, dins del teu admin de Shopify i amb la sessió ja iniciada.

  3. 3 · Activa el cercador al teu tema

    Botiga en línia → Temes → Personalitzar → Incrustacions d'apps (el botó Obrir l'editor de temes del panell t'hi porta directament), activa Findalo i desa. Prem la lupa de la botiga: el cercador s'obre amb els teus productes. Els canvis de producte, preu o estoc arriben sols; per forçar una sincronització: panell → Sincronització → Sincronitzar ara.

Si alguna cosa no quadra

L'app no fa servir tokens ni codis de connexió. Si el cercador no apareix a la botiga, comprova que la incrustació Findalo és activa al tema i que l'app continua instal·lada a Apps. En desinstal·lar l'app, la botiga es desconnecta sola.

Magento — passos essencials

Mòdul natiu per a Magento 2.4 i Adobe Commerce, publicat a l'Adobe Commerce Marketplace. ~10 minuts. PHP 8.2 – 8.5. Compatible amb Hyvä i storefronts headless.

Admin de Magento amb el mòdul Findalo obert: ① el menú Findalo i ② el botó Connect with findalo
① menú Findalo → Configuration · ② botó Connect with findalo (hi posa «Reconnect with findalo» si la botiga ja estava connectada).
  1. 1 · Instal·la el mòdul

    Des de l'Adobe Commerce Marketplace, amb Composer (les claus de repo.magento.com són al teu compte d'Adobe):

    composer require findalo/magento-search
bin/magento module:enable Findalo_Search
bin/magento setup:upgrade
bin/magento cache:flush

    En producció afegeix bin/magento setup:di:compile i bin/magento setup:static-content:deploy si la teva pipeline ho requereix. Sense Composer: descarrega el ZIP des del teu panell (Integració → pestanya Magento) i descomprimeix-lo a app/code/Findalo/Search — una de les dues vies, mai totes dues alhora.

  2. 2 · Estableix la connexió

    A l'admin de Magento, menú lateral Findalo → Configuration (①). A la pestanya Configuration prem Connect with findalo (②). S'obre panel.findalo.io: inicia sessió amb el teu compte Findalo (o crea'l allà mateix), tria el cercador i prem Connectar aquesta botiga. Tornes al mòdul ja connectat: la credencial viatja de servidor a servidor, mai la veus ni la copies.

  3. 3 · Comprova que tot arriba

    Al costat del botó veuràs ✓ Connected · el-teu-cercador. El mòdul envia el catàleg sol (en multi-store, cada vista de botiga per separat) i el manté al dia; al teu panell → Sincronització hi apareixen els productes en uns minuts. Per forçar un enviament: pestanya Status → Mark as pending (force next rebuild), o Sincronitzar ara al panell. Si el widget no apareix a la botiga, buida les memòries cau: bin/magento cache:flush.

Si no pots fer servir el botó

Si la finestra del panell no s'obre o la tornada al mòdul es talla (bloquejador de finestres emergents, redirecció trencada per l'allotjament), connecta a mà: al teu panell → Integració → pestanya Magento copia l'ID del cercador i el Token de sincronització; al mòdul desplega Connection not working? Connect manually, enganxa els dos valors als seus camps i prem Save. El resultat és el mateix que amb el botó.

Shopware — passos essencials

App nativa de Shopware (sense PHP) per a 6.6 i 6.7. ~10 minuts. La botiga es vincula al teu compte Findalo des del mateix admin amb un codi per correu: sense tokens.

Admin de Shopware amb l'app Findalo oberta: ① Extensions → Findalo i ② el correu del teu compte amb el botó Enviar codi
① Extensions → Findalo · ② el teu correu i Enviar código (el codi de 6 dígits arriba per correu).
  1. 1 · Instal·la l'app

    Entra al teu panell de client (o dona't d'alta gratis) → Integració → pestanya Shopware → Descarregar ZIP. Al teu admin de Shopware: Extensions → Les meves extensions → Pujar extensió, instal·la i activa acceptant els permisos (lectura del catàleg i de la configuració). Per CLI:

    bin/console app:install --activate FindaloSearch
bin/console cache:clear

    En activar-se, l'app es registra a Findalo automàticament. Requisit: la botiga ha de ser accessible per HTTPS des d'internet (Findalo llegeix el catàleg per l'Admin API).

  2. 2 · Vincula la botiga al teu compte

    Obre Extensions → Findalo. Escriu el correu del teu compte Findalo i prem Enviar código (envia el codi); introdueix el codi de 6 dígits que reps i prem Verificar y vincular (verifica i vincula). A la taula de canals, associa cada sales channel Storefront a un cercador del teu compte (columna Buscador): només el canal associat es connecta i s'indexa. Necessites un altre cercador? Crea'l al panell i prem ↻ Refrescar (actualitza) a l'app.

  3. 3 · Comprova que tot arriba

    Veuràs Conectado a Findalo (connectat) i, per canal, productes i última sincronització. El catàleg se sincronitza per l'Admin API i els canvis arriben sols; Re-sincronizar força un enviament i Gestionar buscadores ↗ obre el teu panell. El widget s'injecta al Storefront automàticament: recarrega la botiga i prem la lupa.

Si no arriba el codi o alguna cosa no quadra

Revisa el correu brossa i que l'adreça sigui la del teu compte Findalo; pots demanar un altre codi amb Enviar código. Desconectar pausa els cercadors sense esborrar res: et reconnectes amb un clic, sense reinstal·lar. Si el teu Shopware no deixa pujar extensions des de l'admin, fes servir l'ordre CLI del pas 1.

Recursos ràpids

Demo en viu

PrestaShop net amb findalo actiu. Prova la lupa.

Demo amb el teu catàleg

Et muntem un cercador de prova amb els teus productes, sense cost.

Preus

Free: prova gratuïta d'1 mes sense targeta. Starter i Pro: 14 dies de prova gratis. Sense permanència.

API i endpoints

URL base pública: https://api.findalo.io

GET /api/<cercador>/search?q=<query>
Cerca principal. Retorna hits, facetes i total. L'origen ha d'estar a allowed_domains del teu cercador.
GET /api/<cercador>/suggest?q=<query>
Autocompletar. Crida'l a velocitat de teclat; té un rate limit més generós que /search.
GET /api/public-config/<cercador>
Config pública del teu cercador: theme, layout, pla. El que fa servir el widget en arrencar.
POST /api/<cercador>/track
Track d'esdeveniments (clics, add-to-carts, conversions). Body JSON.

Documentació detallada amb exemples cURL i SDKs en camí. Necessites alguna cosa concreta ara? Escriu-nos.

Recomanacions (pla Pro+)

Blocs de productes suggerits a la fitxa, al carret i a la home — sense que el comprador faci cap cerca. El motor agrega els teus esdeveniments de view/add-to-cart amb decay de 30 dies i materialitza tres índexs: co-visitats, co-afegits al carret i bestsellers.

Auto-inject (PrestaShop)

El mòdul ja incorpora els hooks displayFooterProduct, displayShoppingCartFooter i displayHome. Configura el back office i activa els slots — zero codi.

Integració custom (altres plataformes)

// A la fitxa de producte:
findalo.reco({
  context: 'similar',
  productId: '123',
  target: '#findalo-similar-slot',
  title: 'També et pot agradar',
});

// En carregar la fitxa:
findalo.trackView('123');

// En afegir al carret:
findalo.trackAddToCart('123');

// Recently viewed (client, sense tràfic al backend):
findalo.recentlyViewed();  // → ['123', '456', ...]

Endpoint

GET /api/<cercador>/recommend?context=similar|fbt|bestsellers&product_id=<id>&limit=8 · pla ≥ Pro o retorna 402.

Alguna cosa no funciona?

Envia'ns un email a hola@findalo.io amb la URL de la teva botiga i què falla. Et responem personalment en horari laboral.