Findalo
Empezar gratis

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.9.11
Actualizado 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
Ficha en WordPress.org ↗
Actualizado 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
Ficha en Adobe Commerce Marketplace ↗
Actualizado 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)
Actualizado 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

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

Módulo nativo para PrestaShop 1.7.6 – 9.x, multitienda incluido. ~10 minutos. La tienda se conecta con un botón desde el propio módulo: no copias tokens ni tocas URLs.

Back office de PrestaShop con el módulo Findalo abierto: ① el menú Módulos y ② el botón Connect with findalo
① Módulos → Gestor de módulos → Findalo → Configurar · ② botón Connect with findalo (pone «Reconnect with findalo» si la tienda ya estaba conectada).
  1. 1 · Instala el módulo

    Entra en tu panel de cliente (o date de alta gratis) → Integración → pestaña PrestaShop → Descargar ZIP: siempre la última versión publicada. En tu back office: Módulos → Gestor de módulos → Subir un módulo, arrastra el ZIP y pulsa Instalar.

  2. 2 · Establece la conexión

    En Módulos → Gestor de módulos (①) busca Findalo y pulsa Configurar. En la pestaña Configuración pulsa Connect with findalo (②). Se abre panel.findalo.io: inicia sesión con tu cuenta Findalo (o créala ahí mismo), elige el buscador y pulsa Conectar esta tienda. Vuelves al módulo ya conectado: la credencial viaja de servidor a servidor, nunca la ves ni la copias.

  3. 3 · Comprueba que todo llega

    En el módulo verás ✓ Connected · tu-buscador. El catálogo se envía solo: en tu panel → Sincronización aparecen los productos en unos minutos y, a partir de ahí, cada cambio de producto, precio o stock llega automáticamente. Para forzar un envío: pestaña Estado del módulo → Mark as pending (force next rebuild), o Sincronizar ahora en el panel. Recarga tu tienda y pulsa la lupa: el buscador se abre con tus productos.

Si no puedes usar el botón

Si la ventana del panel no se abre o la vuelta al módulo se corta (bloqueador de ventanas emergentes, redirección rota por el hosting), conecta a mano: en tu panel → Integración → pestaña PrestaShop copia el ID del buscador y el Token de sincronización; en el módulo despliega Connection not working? Connect manually, pega los dos valores y pulsa Save manual connection. El resultado es el mismo que con el botón.

WooCommerce — pasos esenciales

Plugin oficial de WordPress para WooCommerce. ~10 minutos. WPML y Polylang se detectan solos; compatible con WP Rocket y LiteSpeed Cache. Demo en vivo: woocommerce.findalo.io/shop.

Administración de WordPress con el plugin Findalo abierto: ① el menú WooCommerce → Findalo y ② el botón Connect with Findalo
① WooCommerce → Findalo · ② botón Connect with Findalo (pone «Reconnect with Findalo» si la tienda ya estaba conectada).
  1. 1 · Instala el plugin

    En tu WordPress: Plugins → Añadir nuevo, busca «Findalo», pulsa Instalar ahora y después Activar. También puedes subir el ZIP (Subir plugin) descargado desde tu panel (Integración → pestaña WooCommerce) o desde WordPress.org. Al activarlo se abre un asistente breve; no hace falta completarlo: la conexión del paso 2 lo deja todo listo. ¿Aún no tienes cuenta? Date de alta gratis — o créala durante la conexión.

  2. 2 · Establece la conexión

    En el menú lateral, WooCommerce → Findalo (①), pestaña General, tarjeta Connection: pulsa Connect with Findalo (②). Se abre panel.findalo.io: inicia sesión con tu cuenta Findalo (o créala ahí mismo), elige el buscador y pulsa Conectar esta tienda. Vuelves al plugin ya conectado; nunca ves ni copias tokens.

  3. 3 · Comprueba que todo llega

    En la tarjeta Connection verás ✓ Connected · tu-buscador y el botón Verify connection para comprobarla cuando quieras. El plugin publica el catálogo solo y lo mantiene al día con cada cambio de producto, precio o stock; en tu panel → Sincronización aparecen los productos en unos minutos. Para forzar un envío: pestaña Status del plugin → Mark as pending (force next rebuild), o Sincronizar ahora en el panel. Abre tu tienda y pulsa la lupa.

Si no puedes usar el botón

Si la ventana del panel no se abre o la vuelta al plugin se corta (bloqueador de ventanas emergentes, redirección rota por el hosting), conecta a mano: en tu panel → Integración → pestaña WooCommerce copia el ID del buscador y el Token de sincronización; en el plugin despliega Connection not working? Connect manually, pega los dos valores y pulsa Save manual connection. El resultado es el mismo que con el botón.

Shopify — pasos esenciales

App pública de Shopify. ~5 minutos. Nada que instalar en un servidor, sin tokens ni código: la tienda se conecta desde tu panel de Findalo con un clic.

  1. 1 · Conecta tu tienda

    Entra en tu panel de cliente (o date de alta gratis) → Integración → pestaña Shopify. Escribe el dominio de tu tienda (tu-tienda.myshopify.com) y pulsa Conectar con Shopify.

  2. 2 · Autoriza la app en Shopify

    Se abre el admin de tu tienda y Shopify te muestra los permisos que pide la app (catálogo e inventario, eventos de compra para la analítica y páginas de la tienda para el asistente): confírmalos con Instalar. Vuelves a tu panel con la tienda conectada y el catálogo se sincroniza solo por la API de Shopify. Desde entonces también tienes Findalo en Apps → Findalo, dentro de tu admin de Shopify y con la sesión ya iniciada.

  3. 3 · Activa el buscador en tu tema

    Tienda online → Temas → Personalizar → Incrustaciones de apps (el botón Abrir el editor de temas del panel te lleva directo), activa Findalo y guarda. Pulsa la lupa de tu tienda: el buscador se abre con tus productos. Los cambios de producto, precio o stock llegan solos; para forzar una sincronización: panel → Sincronización → Sincronizar ahora.

Si algo no cuadra

La app no usa tokens ni códigos de conexión. Si el buscador no aparece en tu tienda, comprueba que la incrustación Findalo está activa en el tema y que la app sigue instalada en Apps. Al desinstalar la app, la tienda se desconecta sola.

Magento — pasos esenciales

Módulo nativo para Magento 2.4 y Adobe Commerce, publicado en el Adobe Commerce Marketplace. ~10 minutos. PHP 8.2 – 8.5. Compatible con Hyvä y storefronts headless.

Admin de Magento con el módulo Findalo abierto: ① el menú Findalo y ② el botón Connect with findalo
① menú Findalo → Configuration · ② botón Connect with findalo (pone «Reconnect with findalo» si la tienda ya estaba conectada).
  1. 1 · Instala el módulo

    Desde el Adobe Commerce Marketplace, con Composer (las claves de repo.magento.com están en tu cuenta de Adobe):

    composer require findalo/magento-search
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. Sin Composer: descarga el ZIP desde tu panel (Integración → pestaña Magento) y descomprímelo en app/code/Findalo/Search — una de las dos vías, nunca las dos a la vez.

  2. 2 · Establece la conexión

    En el admin de Magento, menú lateral Findalo → Configuration (①). En la pestaña Configuration pulsa Connect with findalo (②). Se abre panel.findalo.io: inicia sesión con tu cuenta Findalo (o créala ahí mismo), elige el buscador y pulsa Conectar esta tienda. Vuelves al módulo ya conectado: la credencial viaja de servidor a servidor, nunca la ves ni la copias.

  3. 3 · Comprueba que todo llega

    Junto al botón verás ✓ Connected · tu-buscador. El módulo envía el catálogo solo (en multi-store, cada vista de tienda por separado) y lo mantiene al día; en tu panel → Sincronización aparecen los productos en unos minutos. Para forzar un envío: pestaña Status → Mark as pending (force next rebuild), o Sincronizar ahora en el panel. Si el widget no aparece en tu tienda, vacía cachés: bin/magento cache:flush.

Si no puedes usar el botón

Si la ventana del panel no se abre o la vuelta al módulo se corta (bloqueador de ventanas emergentes, redirección rota por el hosting), conecta a mano: en tu panel → Integración → pestaña Magento copia el ID del buscador y el Token de sincronización; en el módulo despliega Connection not working? Connect manually, pega los dos valores en sus campos y pulsa Save. El resultado es el mismo que con el botón.

Shopware — pasos esenciales

App nativa de Shopware (sin PHP) para 6.6 y 6.7. ~10 minutos. La tienda se vincula a tu cuenta Findalo desde el propio admin con un código por correo: sin tokens.

Admin de Shopware con la app Findalo abierta: ① Extensiones → Findalo y ② el correo de tu cuenta con el botón Enviar código
① Extensiones → Findalo · ② tu correo y Enviar código (el código de 6 dígitos llega por email).
  1. 1 · Instala la app

    Entra en tu panel de cliente (o date de alta gratis) → Integración → pestaña Shopware → Descargar ZIP. En tu admin de Shopware: Extensiones → Mis extensiones → Subir extensión, instala y activa aceptando los permisos (lectura del catálogo y de la configuración). Por CLI:

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

    Al activarse, la app se registra en Findalo automáticamente. Requisito: la tienda debe ser accesible por HTTPS desde internet (Findalo lee el catálogo por la Admin API).

  2. 2 · Vincula la tienda a tu cuenta

    Abre Extensiones → Findalo. Escribe el correo de tu cuenta Findalo y pulsa Enviar código; introduce el código de 6 dígitos que recibes y pulsa Verificar y vincular. En la tabla de canales, asocia cada sales channel Storefront a un buscador de tu cuenta (columna Buscador): solo el canal asociado se conecta e indexa. ¿Necesitas otro buscador? Créalo en el panel y pulsa ↻ Refrescar en la app.

  3. 3 · Comprueba que todo llega

    Verás Conectado a Findalo y, por canal, productos y último sync. El catálogo se sincroniza por la Admin API y los cambios llegan solos; Re-sincronizar fuerza un envío y Gestionar buscadores ↗ abre tu panel. El widget se inyecta en el Storefront automáticamente: recarga tu tienda y pulsa la lupa.

Si no llega el código o algo no cuadra

Revisa el correo no deseado y que la dirección sea la de tu cuenta Findalo; puedes pedir otro código con Enviar código. Desconectar pausa los buscadores sin borrar nada: reconectas con un clic, sin reinstalar. Si tu Shopware no deja subir extensiones desde el admin, usa el comando CLI del paso 1.

Recursos rápidos

Para desarrolladores

Tokens de theming, CSS avanzado, plantilla de card y eventos JS.

Demo en vivo

PrestaShop limpio con findalo activo. Prueba la lupa.

Demo con tu catálogo

Te montamos un buscador de prueba con tus productos, sin coste.

Precios

Free: prueba gratuita de 1 mes sin tarjeta. Starter y Pro: 14 días de prueba gratis. Sin permanencia.

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.