Findalo

Documentazione

Attiva Findalo sul tuo negozio in 10 minuti.

Le guide passo passo per ogni piattaforma, l'API e il pannello. Se rimani bloccato, scrivici a hola@findalo.io — leggiamo tutto.

Installazione per piattaforma

Requisiti tecnici minimi

Ciò di cui il tuo negozio ha bisogno per installare il modulo Findalo. Se il tuo stack è al di sotto, contattaci a hola@findalo.io e vediamo cosa fare.

Piattaforma Modulo Piattaforma compatibile PHP Altri requisiti
PrestaShop v1.9.13
Aggiornato 10 nov 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
Scheda su WordPress.org ↗
Aggiornato 31 ott 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.9
Scheda su Adobe Commerce Marketplace ↗
Aggiornato 8 nov 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.9.8
App nativa (sin PHP)
Aggiornato 21 nov 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
Odoo v1.0.1
Módulo de Odoo (Python, sin PHP)
Scheda su Odoo Apps Store ↗
Aggiornato 12 nov 2026
Odoo 18, 19 y 20 (Community y Enterprise)
instalaciones propias (on-premise) y Odoo.sh
no funciona en Odoo Online: ahí Odoo no permite instalar módulos de terceros
— App eCommerce de Odoo (website_sale) · con la app de Inventario viajan además cantidades y disponibilidad · se descarga desde tu panel (Integración → Odoo) o desde la Odoo Apps Store · sincroniza sin acciones planificadas (sin cron)

Il widget nel browser funziona su Chrome, Firefox, Safari ed Edge attuali e sulle due versioni precedenti. Nessuna dipendenza da jQuery o dal tuo tema.

PrestaShop — passi essenziali

Modulo nativo per PrestaShop 1.7.6 – 9.x, multinegozio incluso. ~10 minuti. Il negozio si connette con un pulsante dal modulo stesso: nessun token da copiare, nessun URL da modificare.

Back office di PrestaShop con il modulo Findalo aperto: ① il menu Moduli e ② il pulsante Connect with findalo
① Moduli → Gestione moduli → Findalo → Configura · ② pulsante Connect with findalo (mostra “Reconnect with findalo” se il negozio era già connesso).
  1. 1 · Installa il modulo

    Accedi al tuo pannello cliente (o registrati gratis) → Integrazione → scheda PrestaShop → Scarica ZIP: sempre l'ultima versione pubblicata. Nel tuo back office: Moduli → Gestione moduli → Carica un modulo, trascina lo ZIP e premi Installa.

  2. 2 · Stabilisci la connessione

    In Moduli → Gestione moduli (①) trova Findalo e premi Configura. Nella scheda Configurazione premi Connect with findalo (②). Si apre panel.findalo.io: accedi con il tuo account Findalo (o crealo lì), scegli il motore di ricerca e premi Connetti questo negozio. Torni nel modulo già connesso: la credenziale viaggia da server a server, non la vedi né la copi mai.

  3. 3 · Verifica che arrivi tutto

    Il modulo mostra ✓ Connected · il-tuo-motore. Il catalogo viene inviato da solo: nel tuo pannello → Sincronizzazione i prodotti compaiono in pochi minuti e, da lì in poi, ogni modifica di prodotto, prezzo o stock arriva automaticamente. Per forzare un invio: scheda Stato del modulo → Mark as pending (force next rebuild), oppure Sincronizza ora nel pannello. Ricarica il negozio e premi la lente: la ricerca si apre con i tuoi prodotti.

Se non puoi usare il pulsante

Se la finestra del pannello non si apre o il ritorno al modulo si interrompe (blocco popup, redirect rotto dall'hosting), connetti a mano: nel tuo pannello → Integrazione → scheda PrestaShop copia l'ID del motore e il Token di sincronizzazione; nel modulo espandi Connection not working? Connect manually, incolla i due valori e premi Save manual connection. Il risultato è lo stesso del pulsante.

WooCommerce — passi essenziali

Plugin WordPress ufficiale per WooCommerce. ~10 minuti. WPML e Polylang si rilevano da soli; compatibile con WP Rocket e LiteSpeed Cache. Demo live: woocommerce.findalo.io/shop.

Amministrazione WordPress con il plugin Findalo aperto: ① il menu WooCommerce → Findalo e ② il pulsante Connect with Findalo
① WooCommerce → Findalo · ② pulsante Connect with Findalo (mostra “Reconnect with Findalo” se il negozio era già connesso).
  1. 1 · Installa il plugin

    Nel tuo WordPress: Plugin → Aggiungi nuovo, cerca “Findalo”, premi Installa ora e poi Attiva. Puoi anche caricare lo ZIP (Carica plugin) scaricato dal tuo pannello (Integrazione → scheda WooCommerce) o da WordPress.org. All'attivazione si apre una breve procedura guidata; non serve completarla: la connessione del passo 2 sistema tutto. Non hai ancora un account? Registrati gratis — o crealo durante la connessione.

  2. 2 · Stabilisci la connessione

    Nel menu laterale, WooCommerce → Findalo (①), scheda General, riquadro Connection: premi Connect with Findalo (②). Si apre panel.findalo.io: accedi con il tuo account Findalo (o crealo lì), scegli il motore di ricerca e premi Connetti questo negozio. Torni nel plugin già connesso; non vedi né copi mai token.

  3. 3 · Verifica che arrivi tutto

    Nel riquadro Connection vedi ✓ Connected · il-tuo-motore e il pulsante Verify connection per verificarla quando vuoi. Il plugin pubblica il catalogo da solo e lo tiene aggiornato a ogni modifica di prodotto, prezzo o stock; nel tuo pannello → Sincronizzazione i prodotti compaiono in pochi minuti. Per forzare un invio: scheda Status del plugin → Mark as pending (force next rebuild), oppure Sincronizza ora nel pannello. Apri il negozio e premi la lente.

Se non puoi usare il pulsante

Se la finestra del pannello non si apre o il ritorno al plugin si interrompe (blocco popup, redirect rotto dall'hosting), connetti a mano: nel tuo pannello → Integrazione → scheda WooCommerce copia l'ID del motore e il Token di sincronizzazione; nel plugin espandi Connection not working? Connect manually, incolla i due valori e premi Save manual connection. Il risultato è lo stesso del pulsante.

Shopify — passi essenziali

App pubblica di Shopify. ~5 minuti. Niente da installare su un server, né token né codice: colleghi il negozio con un clic dal tuo pannello Findalo.

  1. 1 · Collega il tuo negozio

    Accedi al tuo pannello cliente (o registrati gratis) → Integrazione → scheda Shopify. Scrivi il dominio del tuo negozio (tuo-negozio.myshopify.com) e premi Connetti a Shopify.

  2. 2 · Autorizza l'app in Shopify

    Si apre l'admin del tuo negozio e Shopify mostra i permessi richiesti dall'app (catalogo e inventario, eventi di acquisto per le statistiche e pagine del negozio per l'assistente): confermali con Installa. Torni al pannello con il negozio collegato e il catalogo si sincronizza da solo tramite l'API di Shopify. Da quel momento trovi Findalo anche in App → Findalo, dentro l'admin di Shopify e con la sessione già avviata.

  3. 3 · Attiva la ricerca nel tuo tema

    Negozio online → Temi → Personalizza → Incorporamenti di app (il pulsante Apri l'editor del tema del pannello ti ci porta direttamente), attiva Findalo e salva. Premi la lente del tuo negozio: la ricerca si apre con i tuoi prodotti. Le modifiche di prodotto, prezzo o stock arrivano da sole; per forzare una sincronizzazione: pannello → Sincronizzazione → Sincronizza ora.

Se qualcosa non torna

L'app non usa token né codici di connessione. Se la ricerca non compare nel negozio, controlla che l'incorporamento Findalo sia attivo nel tema e che l'app sia ancora installata in App. Disinstallando l'app, il negozio si disconnette da solo.

Magento — passi essenziali

Modulo nativo per Magento 2.4 e Adobe Commerce, pubblicato sull'Adobe Commerce Marketplace. ~10 minuti. PHP 8.2 – 8.5. Compatibile con Hyvä e storefront headless.

Admin di Magento con il modulo Findalo aperto: ① il menu Findalo e ② il pulsante Connect with findalo
① menu Findalo → Configuration · ② pulsante Connect with findalo (mostra “Reconnect with findalo” se il negozio era già connesso).
  1. 1 · Installa il modulo

    Dall'Adobe Commerce Marketplace, con Composer (le chiavi di repo.magento.com sono nel tuo account Adobe):

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

    In produzione aggiungi bin/magento setup:di:compile e bin/magento setup:static-content:deploy se la tua pipeline lo richiede. Senza Composer: scarica lo ZIP dal tuo pannello (Integrazione → scheda Magento) e scompattalo in app/code/Findalo/Search — una delle due vie, mai entrambe insieme.

  2. 2 · Stabilisci la connessione

    Nell'admin di Magento, menu laterale Findalo → Configuration (①). Nella scheda Configuration premi Connect with findalo (②). Si apre panel.findalo.io: accedi con il tuo account Findalo (o crealo lì), scegli il motore di ricerca e premi Connetti questo negozio. Torni nel modulo già connesso: la credenziale viaggia da server a server, non la vedi né la copi mai.

  3. 3 · Verifica che arrivi tutto

    Accanto al pulsante vedi ✓ Connected · il-tuo-motore. Il modulo invia il catalogo da solo (in multi-store, ogni store view separatamente) e lo tiene aggiornato; nel tuo pannello → Sincronizzazione i prodotti compaiono in pochi minuti. Per forzare un invio: scheda Status → Mark as pending (force next rebuild), oppure Sincronizza ora nel pannello. Se il widget non compare nel negozio, svuota le cache: bin/magento cache:flush.

Se non puoi usare il pulsante

Se la finestra del pannello non si apre o il ritorno al modulo si interrompe (blocco popup, redirect rotto dall'hosting), connetti a mano: nel tuo pannello → Integrazione → scheda Magento copia l'ID del motore e il Token di sincronizzazione; nel modulo espandi Connection not working? Connect manually, incolla i due valori nei loro campi e premi Save. Il risultato è lo stesso del pulsante.

Shopware — passi essenziali

App nativa di Shopware (senza PHP) per 6.6 e 6.7. ~10 minuti. Il negozio si collega al tuo account Findalo dall'admin stesso con un codice via e-mail: nessun token.

Admin di Shopware con l'app Findalo aperta: ① Estensioni → Findalo e ② l'email del tuo account con il pulsante Invia codice
① Estensioni → Findalo · ② la tua email e Enviar código (invia codice; il codice a 6 cifre arriva per email).
  1. 1 · Installa l'app

    Accedi al tuo pannello cliente (o registrati gratis) → Integrazione → scheda Shopware → Scarica ZIP. Nel tuo admin Shopware: Estensioni → Le mie estensioni → Carica estensione, installa e attiva accettando i permessi (lettura del catalogo e della configurazione). Da CLI:

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

    All'attivazione l'app si registra automaticamente su Findalo. Requisito: il negozio deve essere raggiungibile in HTTPS da Internet (Findalo legge il catalogo tramite l'Admin API).

  2. 2 · Collega il negozio al tuo account

    Apri Estensioni → Findalo. Inserisci l'e-mail del tuo account Findalo e premi Enviar código (invia codice); digita il codice a 6 cifre ricevuto e premi Verificar y vincular (verifica e collega). Nella tabella dei canali associa ogni sales channel Storefront a un motore del tuo account (colonna Buscador): solo il canale associato viene connesso e indicizzato. Ti serve un altro motore? Crealo nel pannello e premi ↻ Refrescar (aggiorna) nell'app.

  3. 3 · Verifica che arrivi tutto

    Vedrai Conectado a Findalo (connesso) e, per canale, prodotti e ultima sincronizzazione. Il catalogo si sincronizza tramite l'Admin API e le modifiche arrivano da sole; Re-sincronizar forza un invio e Gestionar buscadores ↗ apre il tuo pannello. Il widget viene iniettato nello Storefront automaticamente: ricarica il negozio e premi la lente.

Se il codice non arriva o qualcosa non torna

Controlla la posta indesiderata e che l'indirizzo sia quello del tuo account Findalo; puoi richiedere un altro codice con Enviar código. Desconectar mette in pausa i motori senza cancellare nulla: ti riconnetti con un clic, senza reinstallare. Se il tuo Shopware non permette di caricare estensioni dall'admin, usa il comando CLI del passo 1.

Odoo — passi essenziali

Modulo “Findalo Search” per Odoo 18, 19 e 20 (Community ed Enterprise), su installazioni proprie (on-premise) e su Odoo.sh. ~10 minuti. Richiede l'app eCommerce di Odoo. Non funziona su Odoo Online: lì Odoo non permette di installare moduli di terze parti. Demo live: odoo.findalo.io.

Back office di Odoo con la schermata Findalo Search aperta: ① il menu Sito web → Configurazione → Findalo Search e ② il pulsante Connect with findalo
① Sito web → Configurazione → Findalo Search (nello screenshot, in inglese: Website → Configuration) · ② pulsante Connect with findalo (mostra “Reconnect with findalo” se il negozio era già connesso).
  1. 1 · Installa il modulo

    Accedi al tuo pannello cliente (o registrati gratis) → Integrazione → scheda Odoo → Scarica ZIP. Scompatta la cartella findalo_search nel percorso degli addons del tuo Odoo (o aggiungila al repository di Odoo.sh). In Odoo: Applicazioni → Aggiorna elenco app, cerca Findalo Search e premi Installa.

  2. 2 · Stabilisci la connessione

    Nel back office di Odoo, Sito web → Configurazione → Findalo Search (①). Premi Connect with findalo (②). Si apre panel.findalo.io: accedi con il tuo account Findalo, scegli il motore di ricerca e premi Connetti questo negozio. Torni in Odoo già connesso: la credenziale viaggia da server a server, non la vedi né la copi mai. Se il tuo Odoo gestisce più siti web, ognuno si collega al proprio motore di ricerca.

  3. 3 · Verifica che arrivi tutto

    In quella stessa schermata, Verify connection verifica la connessione e Send catalog now invia il catalogo a mano. Non c'è nulla da programmare: il modulo non usa azioni pianificate (cron) e ogni modifica di prodotto, prezzo, categoria, attributo o stock viene inviata da sola subito dopo il salvataggio. Odoo non ha un campo marca: in Brand attribute scegli quale attributo di prodotto fa da marca. Apri il tuo negozio e premi la lente nell'header: si apre Findalo con i tuoi prodotti.

Se non puoi usare il pulsante

Se la finestra del pannello non si apre o il ritorno a Odoo si interrompe (blocco popup, redirect rotto dall'hosting), connetti a mano: nel tuo pannello → Integrazione → scheda Odoo copia l'ID del motore e il Token di sincronizzazione; in Odoo, in quella stessa schermata (Sito web → Configurazione → Findalo Search), incollali in Search engine ID e Sync token e salva. Il risultato è lo stesso del pulsante.

Risorse rapide

API ed endpoint

URL base pubblica: https://api.findalo.io

GET /api/<motore>/search?q=<query>
Ricerca principale. Restituisce risultati, facet e totale. L'origin deve essere in allowed_domains del tuo motore di ricerca.
GET /api/<motore>/suggest?q=<query>
Autocompletamento. Chiamalo alla velocità di digitazione; ha un rate limit più generoso di /search.
GET /api/public-config/<motore>
Config pubblica del tuo motore di ricerca: tema, layout, piano. Quello che usa il widget all'avvio.
POST /api/<motore>/track
Tracciamento eventi (clic, aggiunte al carrello, conversioni). Body JSON.

Documentazione dettagliata con esempi cURL e SDK in arrivo. Hai bisogno di qualcosa di specifico adesso? Scrivici.

Raccomandazioni (piano Pro+)

Blocchi di prodotti suggeriti su scheda prodotto, carrello e homepage — senza che il visitatore effettui alcuna ricerca. Il motore aggrega i tuoi eventi di view/add-to-cart con decay di 30 giorni e materializza tre indici: co-visitati, co-aggiunti al carrello e bestseller.

Auto-inject (PrestaShop)

Il modulo include già gli hook displayFooterProduct, displayShoppingCartFooter e displayHome. Configura il back office e attiva gli slot — zero codice.

Integrazione custom (altre piattaforme)

// Nella scheda prodotto:
findalo.reco({
  context: 'similar',
  productId: '123',
  target: '#findalo-similar-slot',
  title: 'Potrebbe interessarti anche',
});

// Al caricamento della scheda:
findalo.trackView('123');

// All'aggiunta al carrello:
findalo.trackAddToCart('123');

// Recently viewed (lato client, senza traffico al backend):
findalo.recentlyViewed();  // → ['123', '456', ...]

Endpoint

GET /api/<motore>/recommend?context=similar|fbt|bestsellers&product_id=<id>&limit=8 · piano ≥ Pro altrimenti restituisce 402.

Qualcosa non funziona?

Mandaci un'email a hola@findalo.io con l'URL del tuo negozio e cosa non va. Ti rispondiamo personalmente durante l'orario lavorativo.