Findalo

Documentación

Activa Findalo en tu tienda en 10 minutos.

Las guías paso a paso para cada plataforma, la API y el panel. Si te quedas atascado, escríbenos a hola@findalo.io — leemos todo.

Instalación por plataforma

Requisitos técnicos mínimos

Lo que necesita tu tienda para instalar el módulo Findalo. Si tu stack está por debajo, dínoslo en hola@findalo.io y vemos qué hacer.

Plataforma Módulo Plataforma compatible PHP Otros requisitos
PrestaShop v1.6.14
Actualizado 9 jun 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.2.2
Actualizado 4 jun 2026
WordPress 6.0+
WooCommerce 7.0+ (probado hasta WC 9.4)
7.4+ WPML o Polylang autodetectados · compatible con WP Rocket / LiteSpeed Cache · temas Storefront / Hello Elementor / Astra / Blocksy verificados
Magento v1.1.8
Actualizado 8 jun 2026
Magento 2
Adobe Commerce (Open Source y Commerce)
8.2 / 8.3 / 8.4 Módulos estándar: Magento_Catalog, Magento_Config, Magento_Backend · Composer recomendado
Shopify Custom App
App pública en camino
Cualquier plan Shopify (incl. Basic, Shopify, Advanced, Plus) Permiso para crear Custom Apps · scopes read_products, read_product_listings, read_collections, read_inventory · acceso a theme.liquid para pegar el snippet
Shopware v0.2.4
Actualizado 8 jun 2026
Shopware 6.6+ (Storefront y Headless) 8.2 / 8.3 Shopware CLI o admin para subir plugin · acceso al Storefront para inyectar el snippet del widget · MySQL 8 / MariaDB 10.4+

El widget en navegador funciona en Chrome, Firefox, Safari y Edge actuales y en las dos versiones anteriores. Sin dependencias jQuery ni de tu tema.

PrestaShop — pasos esenciales

  1. 1 · Descarga

    Entra a tu panel de cliente y abre Integraciones → Módulo PrestaShop. Pulsa Descargar ZIP — siempre te damos la última versión publicada. ¿Aún no tienes cuenta? Date de alta gratis.

  2. 2 · Sube e instala

    En PrestaShop BO: Módulos → Gestor de módulos → Subir un módulo. Arrastra el ZIP y pulsa Instalar.

  3. 3 · Configura

    Pulsa Configurar sobre el módulo Findalo. Rellena:

    • URL del buscador: el slug que tienes en tu panel de findalo.io (lo ves en cuanto te registras).
    • Feed token: déjalo vacío para autogenerar uno fuerte. Cópialo después a tu panel en findalo.io.
    • Trigger selector: déjalo por defecto (cubre el tema Classic y la mayoría). Cámbialo solo si tu tema usa selectores custom.
  4. 4 · Activa

    Marca "Cargar el bundle del buscador en todas las páginas" y guarda. Recarga tu storefront, pulsa la lupa del tema — el widget abre un modal full-screen y los productos aparecen al instante.

  5. 5 · Verifica el sync

    En findalo.io → tu buscador → Estado del catálogo: deberías ver tus productos indexados en menos de 5 minutos. Si no, revisa que tu PrestaShop sea alcanzable desde internet (el sync hace polling cada 5 min al endpoint /module/findalo/feed).

WooCommerce — pasos esenciales

Plugin WordPress estándar. ~10 minutos. Compatible con WPML, Polylang, WP Rocket, LiteSpeed Cache y temas Storefront / Hello Elementor / Astra / Blocksy. Demo en vivo: woocommerce.findalo.io/shop.

  1. 1 · Descarga el plugin

    Entra a tu panelIntegración → tab WooCommerceDescargar ZIP. Siempre te damos la última versión publicada. Si aún no tienes cuenta, date de alta gratis.

  2. 2 · Sube e instala en WordPress

    En tu WordPress admin: Plugins → Añadir nuevo → Subir plugin. Arrastra el ZIP y pulsa Instalar, luego Activar.

  3. 3 · Configura el plugin

    En el menú WooCommerce → Findalo. Rellena:

    • Your search URL: el slug que ves en tu panel de findalo.io (lo eliges al alta).
    • Feed token (Bearer): el que aparece en el panel findalo, copialo y pégalo aquí. Si está vacío, el plugin genera uno y luego lo copias al panel.
    • Trigger selector: déjalo por defecto — cubre el bloque de búsqueda de Gutenberg, search-field clásico y el form de búsqueda de productos.

    Guarda. El plugin inyecta el widget en wp_head automáticamente.

  4. 4 · Fuerza el primer sync

    En el mismo settings page del plugin, pulsa "Mark as pending (force next rebuild)". Espera 5-10 segundos. El plugin construye el JSON del catálogo y lo postea a findalo.io (push asíncrono — la página vuelve sin esperar al upload).

  5. 5 · Verifica

    En findalo.io → tu buscador → Sincronización: deberías ver los productos sincronizados con sync_source: push. Abre tu storefront, dale a la lupa — el modal findalo se abre con tus productos. A partir de ahora cualquier cambio en producto, stock o precio se reflejará en ≤10 min (stock throttle anti-spam).

  6. 6 · Soporte multi-idioma (opcional)

    Si usas WPML o Polylang, el plugin los detecta automáticamente y publica cada producto traducido bajo su locale (ISO 2-letras). Sin configuración extra.

Shopify — pasos esenciales

Mientras la app oficial llega al Shopify App Store, el conector funciona en modo Custom App. ~10 minutos de punta a punta. Te llevas la dev store de demo (pass 1234) como referencia de cómo queda.

  1. 1 · Date de alta en findalo

    Regístrate en findalo.io (plan Free es suficiente para probar). Anota tu slug — lo necesitarás en el último paso.

  2. 2 · Crea una Custom App en Shopify

    En tu Shopify Admin: Settings → Apps and sales channels → Develop apps → Create an app. Pon nombre cualquiera (ej. "findalo-search").

  3. 3 · Activa los scopes

    Dentro de la app: Configuration → Admin API integration → Configure. Marca:

    • read_products
    • read_product_listings
    • read_collections
    • read_inventory

    Save abajo a la derecha.

  4. 4 · Instala la app y copia el token

    Pulsa Install app arriba a la derecha. Te lleva a API credentials: copia el Admin API access token (empieza por shpat_ y tiene 38 caracteres).

    ⚠ Shopify enseña el token una sola vez. Si te equivocas o cierras la pestaña, tendrás que rotar credenciales y generar uno nuevo.

  5. 5 · Conecta findalo al panel

    En tu panel de findalo: Integración → tab Shopify. Pega:

    • Dominio: tu-tienda.myshopify.com
    • Admin API access token: el shpat_… del paso 4

    Pulsa Conectar y sincronizar. Validamos credenciales contra Shopify y pullamos tu catálogo en segundos. Verás "Conectado a tu-tienda.myshopify.com".

  6. 6 · Pega el snippet en el theme

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

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

    Sustituye TU_SLUG por el slug del paso 1. Save. Recarga tu storefront y pulsa la lupa — el widget findalo abre el modal con tus productos.

  7. 7 · Sync continuo automático

    A partir de aquí: el cron de findalo hace pull cada 5 min. Cambias precios, stock o productos en Shopify → findalo reindexa solo en menos de 5 minutos. Cero infraestructura tuya. Para forzar un sync manual: panel → Sincronización → Sincronizar ahora.

Magento — pasos esenciales

Módulo nativo para Magento 2 y Adobe Commerce. ~10 minutos. Requiere PHP 8.2, 8.3 o 8.4. Compatible con Hyvä Themes y storefronts PWA Studio / headless.

  1. 1 · Descarga el módulo

    Entra a tu panelIntegración → tab MagentoDescargar ZIP. Siempre te damos la última versión publicada. Si aún no tienes cuenta, date de alta gratis.

  2. 2 · Sube el módulo a tu Magento

    Descomprime el ZIP y copia la carpeta a app/code/Findalo/Search de tu Magento. Por SSH:

    mkdir -p app/code/Findalo/Search
    unzip findalo-magento-*.zip -d app/code/Findalo/Search
  3. 3 · Habilita el módulo

    Desde la raíz de tu Magento:

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

    En producción añade bin/magento setup:di:compile y bin/magento setup:static-content:deploy si tu pipeline lo requiere.

  4. 4 · Configura

    En Magento Admin: Stores → Configuration → Findalo → General. Rellena:

    • Search URL: el slug que ves en tu panel de findalo.io.
    • Feed token: cópialo desde el panel findalo y pégalo aquí, o déjalo vacío para autogenerarlo.
    • Trigger selector: déjalo por defecto — cubre los temas Luma, Blank y Hyvä.

    Guarda y vacía cachés: bin/magento cache:flush.

  5. 5 · Verifica el sync

    En findalo.io → tu buscador → Estado del catálogo: deberías ver tus productos indexados en menos de 5 minutos. Si llevas multi-store o multi-website, cada vista se indexa por separado y se identifica por su store_code. Recarga tu storefront, pulsa la lupa — el widget abre el modal con tus productos.

Shopware — pasos esenciales

Plugin nativo para Shopware 6.6 y superiores. ~10 minutos. Compatible con Storefront clásico y con storefronts headless.

  1. 1 · Descarga el plugin

    Entra a tu panelIntegración → tab ShopwareDescargar ZIP. Siempre te damos la última versión publicada. Si aún no tienes cuenta, date de alta gratis.

  2. 2 · Sube el plugin a Shopware

    En tu Shopware Admin: Extensiones → Mis extensiones → Subir extensión. Arrastra el ZIP. Por CLI:

    bin/console plugin:refresh
    bin/console plugin:install --activate FindaloSearch
    bin/console cache:clear
  3. 3 · Configura

    En Shopware Admin: Extensiones → Findalo Search → Configurar. Rellena:

    • Search URL: el slug que ves en tu panel de findalo.io.
    • Feed token: cópialo desde el panel findalo y pégalo aquí, o déjalo vacío para autogenerarlo.
    • Trigger selector: déjalo por defecto — cubre los temas Storefront por defecto.

    Guarda. El plugin inyecta el widget en el Storefront automáticamente.

  4. 4 · Verifica el sync

    En findalo.io → tu buscador → Estado del catálogo: deberías ver tus productos indexados en menos de 5 minutos. Si llevas multi-sales-channel, cada uno se indexa por separado. Recarga tu Storefront, pulsa la lupa — el widget abre el modal con tus productos.

Recursos rápidos

API y endpoints

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

GET /api/<buscador>/search?q=<query>
Búsqueda principal. Devuelve hits, facetas y total. Origin debe estar en allowed_domains de tu buscador.
GET /api/<buscador>/suggest?q=<query>
Autocomplete. Llámalo a typing speed; tiene rate limit más generoso que /search.
GET /api/public-config/<buscador>
Config pública de tu buscador: theme, layout, plan. Lo que el widget usa al boot.
POST /api/<buscador>/track
Track de eventos (clicks, adds-to-cart, conversions). Body JSON.

Documentación detallada con ejemplos cURL y SDKs llegando. ¿Necesitas algo en concreto ya? Escríbenos.

Recomendaciones (plan Pro+)

Bloques de productos sugeridos en ficha, carrito y home — sin que el shopper haga ninguna búsqueda. El motor agrega tus eventos de view/add-to-cart con decay 30 días y materializa tres índices: co-visitación, co-añadidos al carrito y bestsellers.

Auto-inject (PrestaShop)

El módulo ya viene con los hooks displayFooterProduct, displayShoppingCartFooter y displayHome. Configura el back office y activa los slots — cero código.

Integración custom (otras plataformas)

// En la ficha de producto:
findalo.reco({
  context: 'similar',
  productId: '123',
  target: '#findalo-similar-slot',
  title: 'También te puede gustar',
});

// Al cargar la ficha:
findalo.trackView('123');

// Al añadir al carrito:
findalo.trackAddToCart('123');

// Recently viewed (cliente, sin tráfico al backend):
findalo.recentlyViewed();  // → ['123', '456', ...]

Endpoint

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

¿Algo no funciona?

Mándanos un email a hola@findalo.io con tu URL de tienda y qué falla. Te respondemos personalmente en horas laborables.