Findalo
Démarrer gratuitement

Documentation

Active Findalo sur ta boutique en 10 minutes.

Les guides pas à pas pour chaque plateforme, l'API et le panneau. Si tu bloques, écris-nous à hola@findalo.io — on lit tout.

Installation par plateforme

Prérequis techniques minimaux

Ce dont ta boutique a besoin pour installer le module Findalo. Si ton stack est en dessous, dis-le-nous à hola@findalo.io et on voit ce qu'on peut faire.

Plateforme Module Plateforme compatible PHP Autres prérequis
PrestaShop v1.9.11
Mis à jour 30 oct. 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
Fiche sur WordPress.org ↗
Mis à jour 31 oct. 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
Fiche sur Adobe Commerce Marketplace ↗
Mis à jour 11 sept. 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)
Mis à jour 8 sept. 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

Le widget dans le navigateur fonctionne sur Chrome, Firefox, Safari et Edge actuels et sur les deux versions précédentes. Aucune dépendance jQuery ni à ton thème.

PrestaShop — étapes essentielles

Module natif pour PrestaShop 1.7.6 – 9.x, multiboutique inclus. ~10 minutes. La boutique se connecte d'un bouton depuis le module lui-même : aucun token à copier, aucune URL à modifier.

Back-office PrestaShop avec le module Findalo ouvert : ① le menu Modules et ② le bouton Connect with findalo
① Modules → Gestionnaire de modules → Findalo → Configurer · ② bouton Connect with findalo (affiche « Reconnect with findalo » si la boutique était déjà connectée).
  1. 1 · Installe le module

    Accède à ton panneau client (ou inscris-toi gratuitement) → Intégration → onglet PrestaShop → Télécharger le ZIP : toujours la dernière version publiée. Dans ton back-office : Modules → Gestionnaire de modules → Installer un module, dépose le ZIP et clique sur Installer.

  2. 2 · Établis la connexion

    Dans Modules → Gestionnaire de modules (①), trouve Findalo et clique sur Configurer. Dans l'onglet Configuration, clique sur Connect with findalo (②). panel.findalo.io s'ouvre : connecte-toi avec ton compte Findalo (ou crée-le sur place), choisis le moteur de recherche et clique sur Connecter cette boutique. Tu reviens dans le module déjà connecté : l'identifiant voyage de serveur à serveur, tu ne le vois ni ne le copies jamais.

  3. 3 · Vérifie que tout arrive

    Le module affiche ✓ Connected · ton-moteur. Le catalogue est envoyé tout seul : dans ton panneau → Synchronisation, tes produits apparaissent en quelques minutes et, dès lors, chaque changement de produit, de prix ou de stock arrive automatiquement. Pour forcer un envoi : onglet Statut du module → Mark as pending (force next rebuild), ou Synchroniser maintenant dans le panneau. Recharge ta boutique et clique sur la loupe : la recherche s'ouvre avec tes produits.

Si tu ne peux pas utiliser le bouton

Si la fenêtre du panneau ne s'ouvre pas ou si le retour vers le module se coupe (bloqueur de pop-ups, redirection cassée par l'hébergeur), connecte à la main : dans ton panneau → Intégration → onglet PrestaShop, copie l'ID du moteur et le Token de synchronisation ; dans le module, déplie Connection not working? Connect manually, colle les deux valeurs et clique sur Save manual connection. Le résultat est le même qu'avec le bouton.

WooCommerce — étapes essentielles

Plugin WordPress officiel pour WooCommerce. ~10 minutes. WPML et Polylang sont détectés automatiquement ; compatible avec WP Rocket et LiteSpeed Cache. Démo live : woocommerce.findalo.io/shop.

Administration WordPress avec le plugin Findalo ouvert : ① le menu WooCommerce → Findalo et ② le bouton Connect with Findalo
① WooCommerce → Findalo · ② bouton Connect with Findalo (affiche « Reconnect with Findalo » si la boutique était déjà connectée).
  1. 1 · Installe le plugin

    Dans ton WordPress : Extensions → Ajouter, cherche « Findalo », clique sur Installer maintenant puis sur Activer. Tu peux aussi téléverser le ZIP (Téléverser une extension) téléchargé depuis ton panneau (Intégration → onglet WooCommerce) ou depuis WordPress.org. À l'activation, un court assistant s'ouvre ; inutile de le terminer : la connexion de l'étape 2 règle tout. Pas encore de compte ? Inscris-toi gratuitement — ou crée-le pendant la connexion.

  2. 2 · Établis la connexion

    Dans le menu latéral, WooCommerce → Findalo (①), onglet General, carte Connection : clique sur Connect with Findalo (②). panel.findalo.io s'ouvre : connecte-toi avec ton compte Findalo (ou crée-le sur place), choisis le moteur de recherche et clique sur Connecter cette boutique. Tu reviens dans le plugin déjà connecté ; tu ne vois ni ne copies jamais de tokens.

  3. 3 · Vérifie que tout arrive

    La carte Connection affiche ✓ Connected · ton-moteur et le bouton Verify connection pour la vérifier quand tu veux. Le plugin publie le catalogue tout seul et le tient à jour à chaque changement de produit, de prix ou de stock ; dans ton panneau → Synchronisation, tes produits apparaissent en quelques minutes. Pour forcer un envoi : onglet Status du plugin → Mark as pending (force next rebuild), ou Synchroniser maintenant dans le panneau. Ouvre ta boutique et clique sur la loupe.

Si tu ne peux pas utiliser le bouton

Si la fenêtre du panneau ne s'ouvre pas ou si le retour vers le plugin se coupe (bloqueur de pop-ups, redirection cassée par l'hébergeur), connecte à la main : dans ton panneau → Intégration → onglet WooCommerce, copie l'ID du moteur et le Token de synchronisation ; dans le plugin, déplie Connection not working? Connect manually, colle les deux valeurs et clique sur Save manual connection. Le résultat est le même qu'avec le bouton.

Shopify — étapes essentielles

App Shopify publique. ~5 minutes. Rien à installer sur un serveur, ni token ni code : tu connectes la boutique en un clic depuis ton panneau Findalo.

  1. 1 · Connecte ta boutique

    Accède à ton panneau client (ou inscris-toi gratuitement) → Intégration → onglet Shopify. Saisis le domaine de ta boutique (ta-boutique.myshopify.com) et clique sur Connecter à Shopify.

  2. 2 · Autorise l'app dans Shopify

    L'admin de ta boutique s'ouvre et Shopify affiche les autorisations demandées par l'app (catalogue et inventaire, événements d'achat pour les statistiques, pages de la boutique pour l'assistant) : confirme avec Installer. Tu reviens dans ton panneau avec la boutique connectée et le catalogue se synchronise tout seul via l'API Shopify. Dès lors, tu retrouves aussi Findalo dans Apps → Findalo, à l'intérieur de ton admin Shopify, session déjà ouverte.

  3. 3 · Active la recherche dans ton thème

    Boutique en ligne → Thèmes → Personnaliser → Intégrations d'apps (le bouton Ouvrir l'éditeur de thème du panneau t'y emmène directement), active Findalo et enregistre. Clique sur la loupe de ta boutique : la recherche s'ouvre avec tes produits. Les changements de produit, de prix ou de stock arrivent tout seuls ; pour forcer une synchronisation : panneau → Synchronisation → Synchroniser maintenant.

Si quelque chose cloche

L'app n'utilise ni tokens ni codes de connexion. Si la recherche n'apparaît pas dans ta boutique, vérifie que l'intégration Findalo est active dans le thème et que l'app est toujours installée dans Apps. Désinstaller l'app déconnecte la boutique automatiquement.

Magento — étapes essentielles

Module natif pour Magento 2.4 et Adobe Commerce, publié sur l'Adobe Commerce Marketplace. ~10 minutes. PHP 8.2 – 8.5. Compatible avec Hyvä et les storefronts headless.

Admin Magento avec le module Findalo ouvert : ① le menu Findalo et ② le bouton Connect with findalo
① menu Findalo → Configuration · ② bouton Connect with findalo (affiche « Reconnect with findalo » si la boutique était déjà connectée).
  1. 1 · Installe le module

    Depuis l'Adobe Commerce Marketplace, avec Composer (tes clés repo.magento.com sont dans ton compte Adobe) :

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

    En production, ajoute bin/magento setup:di:compile et bin/magento setup:static-content:deploy si ton pipeline l'exige. Sans Composer : télécharge le ZIP depuis ton panneau (Intégration → onglet Magento) et décompresse-le dans app/code/Findalo/Search — l'une des deux voies, jamais les deux à la fois.

  2. 2 · Établis la connexion

    Dans l'admin Magento, menu latéral Findalo → Configuration (①). Dans l'onglet Configuration, clique sur Connect with findalo (②). panel.findalo.io s'ouvre : connecte-toi avec ton compte Findalo (ou crée-le sur place), choisis le moteur de recherche et clique sur Connecter cette boutique. Tu reviens dans le module déjà connecté : l'identifiant voyage de serveur à serveur, tu ne le vois ni ne le copies jamais.

  3. 3 · Vérifie que tout arrive

    À côté du bouton s'affiche ✓ Connected · ton-moteur. Le module envoie le catalogue tout seul (en multi-store, chaque vue de boutique séparément) et le tient à jour ; dans ton panneau → Synchronisation, tes produits apparaissent en quelques minutes. Pour forcer un envoi : onglet Status → Mark as pending (force next rebuild), ou Synchroniser maintenant dans le panneau. Si le widget n'apparaît pas dans ta boutique, vide les caches : bin/magento cache:flush.

Si tu ne peux pas utiliser le bouton

Si la fenêtre du panneau ne s'ouvre pas ou si le retour vers le module se coupe (bloqueur de pop-ups, redirection cassée par l'hébergeur), connecte à la main : dans ton panneau → Intégration → onglet Magento, copie l'ID du moteur et le Token de synchronisation ; dans le module, déplie Connection not working? Connect manually, colle les deux valeurs dans leurs champs et clique sur Save. Le résultat est le même qu'avec le bouton.

Shopware — étapes essentielles

App Shopware native (sans PHP) pour 6.6 et 6.7. ~10 minutes. La boutique se relie à ton compte Findalo depuis l'admin lui-même, avec un code reçu par e-mail : aucun token.

Admin Shopware avec l'app Findalo ouverte : ① Extensions → Findalo et ② l'e-mail de votre compte avec le bouton Envoyer le code
① Extensions → Findalo · ② votre e-mail et Enviar código (envoyer le code ; le code à 6 chiffres arrive par e-mail).
  1. 1 · Installe l'app

    Accède à ton panneau client (ou inscris-toi gratuitement) → Intégration → onglet Shopware → Télécharger le ZIP. Dans ton admin Shopware : Extensions → Mes extensions → Téléverser une extension, installe et active en acceptant les autorisations (lecture du catalogue et de la configuration). En CLI :

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

    À l'activation, l'app s'enregistre automatiquement auprès de Findalo. Prérequis : la boutique doit être accessible en HTTPS depuis Internet (Findalo lit le catalogue via l'Admin API).

  2. 2 · Relie la boutique à ton compte

    Ouvre Extensions → Findalo. Saisis l'e-mail de ton compte Findalo et clique sur Enviar código (envoyer le code) ; entre le code à 6 chiffres reçu et clique sur Verificar y vincular (vérifier et relier). Dans le tableau des canaux, associe chaque sales channel Storefront à un moteur de ton compte (colonne Buscador) : seul le canal associé est connecté et indexé. Besoin d'un autre moteur ? Crée-le dans le panneau et clique sur ↻ Refrescar (actualiser) dans l'app.

  3. 3 · Vérifie que tout arrive

    Tu vois Conectado a Findalo (connecté) et, par canal, les produits et la dernière synchronisation. Le catalogue se synchronise via l'Admin API et les changements arrivent tout seuls ; Re-sincronizar force un envoi et Gestionar buscadores ↗ ouvre ton panneau. Le widget est injecté automatiquement dans le Storefront : recharge ta boutique et clique sur la loupe.

Si le code n'arrive pas ou si quelque chose cloche

Vérifie les indésirables et que l'adresse est bien celle de ton compte Findalo ; redemande un code avec Enviar código. Desconectar met les moteurs en pause sans rien effacer : tu te reconnectes en un clic, sans réinstaller. Si ton Shopware n'autorise pas le téléversement d'extensions depuis l'admin, utilise la commande CLI de l'étape 1.

Ressources rapides

Démo live

PrestaShop propre avec findalo actif. Essaie la loupe.

Démo avec ton catalogue

On te monte un moteur de recherche d'essai avec tes produits, gratuitement.

Tarifs

Free : essai gratuit d'1 mois sans carte bancaire. Starter et Pro : 14 jours d'essai gratuit. Sans engagement.

API et endpoints

URL de base publique : https://api.findalo.io

GET /api/<moteur>/search?q=<query>
Recherche principale. Retourne les hits, les facettes et le total. L'origin doit être dans allowed_domains de ton moteur de recherche.
GET /api/<moteur>/suggest?q=<query>
Autocomplétion. Appelle-le à la vitesse de frappe ; il a un rate limit plus généreux que /search.
GET /api/public-config/<moteur>
Config publique de ton moteur : thème, mise en page, plan. Ce que le widget utilise au démarrage.
POST /api/<moteur>/track
Suivi d'événements (clics, ajouts au panier, conversions). Body JSON.

Documentation détaillée avec exemples cURL et SDK en chemin. Tu as besoin de quelque chose de précis maintenant ? Écris-nous.

Recommandations (plan Pro+)

Blocs de produits suggérés sur la fiche produit, le panier et la page d'accueil — sans que le visiteur effectue de recherche. Le moteur agrège tes événements view/add-to-cart avec un decay de 30 jours et matérialise trois indices : co-visités, co-ajoutés au panier et bestsellers.

Auto-inject (PrestaShop)

Le module inclut déjà les hooks displayFooterProduct, displayShoppingCartFooter et displayHome. Configure le back office et active les slots — zéro code.

Intégration custom (autres plateformes)

// Sur la fiche produit :
findalo.reco({
  context: 'similar',
  productId: '123',
  target: '#findalo-similar-slot',
  title: 'Vous aimerez peut-être aussi',
});

// Au chargement de la fiche :
findalo.trackView('123');

// À l'ajout au panier :
findalo.trackAddToCart('123');

// Recently viewed (côté client, sans trafic vers le backend) :
findalo.recentlyViewed();  // → ['123', '456', ...]

Endpoint

GET /api/<moteur>/recommend?context=similar|fbt|bestsellers&product_id=<id>&limit=8 · plan ≥ Pro sinon retourne 402.

Quelque chose ne fonctionne pas ?

Envoie-nous un email à hola@findalo.io avec l'URL de ta boutique et ce qui ne va pas. On te répond personnellement pendant les heures ouvrées.