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.11
Aggiornato 30 ott 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.8
Scheda su Adobe Commerce Marketplace ↗
Aggiornato 11 set 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)
Aggiornato 8 set 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

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.

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.