Conectar una tienda Shopify
Instalar la aplicación, encender la búsqueda en la tienda, y los bloques de similares y recomendados, en el orden correcto.
En una tienda Shopify no hay código que pegar ni archivos que editar: se instala la aplicación Buskara, se aprueba el acceso de lectura, y se enciende un interruptor en el editor del tema. A partir de ahí el catálogo se sincroniza solo, cambios de productos y de stock incluidos, segundos después de guardarse en la tienda. Lo que la app de búsqueda para Shopify cambia en la tienda, lo que sigue igual y lo que cuesta está contado en el blog; esta guía es solo el camino, en el orden correcto.
1. Instalar la aplicación
El camino habitual empieza en Shopify:
- En la Shopify App Store, abra la página de Buskara y pulse Instalar. Shopify muestra la pantalla de consentimiento con los accesos pedidos, todos de lectura: productos, inventario, publicaciones, idiomas, mercados y pedidos. Pulse Instalar.
- La aplicación se abre dentro de la administración de la tienda. La cuenta Buskara se crea en ese momento con el email de la tienda, y la primera sincronización del catálogo arranca sola.
- Pulse Elegir un plan. Shopify muestra los planes y los días de prueba, y el plan elegido lo factura Shopify, en la misma factura de la tienda; cambiar de plan, cancelar y la prueba se gestionan desde ahí, en Aplicaciones → Buskara.
Quien ya tiene cuenta Buskara con el email de la tienda se queda con la tienda en esa cuenta. Quien empieza por Buskara, en /ativar, elige Shopify y es llevado a la página de Buskara en la Shopify App Store: la instalación empieza siempre en Shopify, nunca por una dirección escrita en Buskara, y el consentimiento es el mismo.
Y eso es todo: la tienda aparece en el panel, en Cuenta → Tiendas, y el botón Abrir el panel de Buskara dentro de la administración de la tienda entra en él sin contraseña. La primera pasada del catálogo suele tardar menos de un minuto, y un catálogo grande tarda algunos.
Buskara no pide ningún permiso de escritura sobre la tienda, y el acceso a los pedidos sirve solo para atribuir ventas a la búsqueda, en nombre del comerciante.
2. Mostrar la búsqueda en la tienda
La búsqueda solo aparece a los visitantes cuando el comerciante la enciende, y el interruptor vive en el editor del tema:
- En la administración de la tienda, abra Tienda online → Personalizar.
- En la barra de iconos del panel izquierdo, abra las integraciones de aplicaciones (el icono de los cuadrados, junto a la configuración del tema).
- Encienda el interruptor Buskara y pulse Guardar.
No cambie el campo "Dirección del servicio" dentro de la integración: el soporte de Buskara avisa si alguna vez hace falta.
Desde ahí, la barra y la lupa de búsqueda del tema pasan a abrir el panel de Buskara, con el cursor listo para escribir. Apagar el interruptor devuelve la búsqueda nativa del tema, al momento.
3. El botón "productos similares" en las fichas
Un botón discreto en la ficha de producto que abre el panel de similares, con filtros y comparación. Se coloca donde el comerciante quiera:
- En el editor del tema, abra una plantilla de producto (selector de páginas arriba → Productos → la plantilla en uso).
- En la sección de detalles del producto, pulse Añadir bloque y elija "Buskara: botón productos similares".
- Arrastre el bloque a su posición (debajo del botón de compra es el sitio habitual) y Guardar.
4. El bloque "también puede gustar"
El carrusel de recomendaciones, alimentado por lo que se ve y se compra en la tienda:
- En el mismo editor, en cualquier plantilla (fichas de producto incluidas), Añadir sección o bloque y elija "Buskara: bloque también puede gustar".
- En una ficha de producto, las sugerencias parten de ese producto; en otra página cualquiera, el carrusel muestra los recomendados generales de la tienda.
- Arrastre a su posición y Guardar.
Los dos bloques solo se dibujan cuando hay resultados que mostrar: un bloque sin nada que decir no ocupa sitio.
Los dos tienen guía propia, con el resto de la historia: el botón de similares y la franja "también puede gustar" cuenta qué muestra cada uno, qué se ajusta en el panel y qué hacer cuando no aparecen.
5. El día a día
Tras la primera sincronización, el catálogo se mantiene al día solo:
- En tiempo real: crear, cambiar o borrar un producto, o tocar el stock, llega al índice segundos después, desde la propia Shopify.
- Red periódica: en ciclos regulares, Buskara revisa lo que cambió desde la última pasada, para que nada quede atrás.
- Manual: el botón Reindexar todo en la ficha de la tienda, en el panel. Las sincronizaciones automáticas no cuestan nada; forzar una reindexación completa cuesta 1 bToken por cada 1.000 documentos, y el aviso con la cuenta aparece antes de confirmar.
El índice sigue el idioma y la moneda principales de la tienda, más los idiomas publicados: una tienda en dos idiomas queda con la búsqueda en los dos, con las traducciones de productos que existan en Shopify y el original donde no existan.
6. Conexión por token, para casos especiales
Las tiendas headless o los montajes fuera de lo común pueden conectarse sin la aplicación, con un token de acceso creado a mano: en la administración de la tienda, en Configuración → Aplicaciones y canales de ventas → Desarrollar aplicaciones, se crea una aplicación con los permisos de lectura (productos, inventario, publicaciones, idiomas, mercados), se instala, y se pega el token shpat_ en la pantalla de activación de Buskara, en el atajo "Montaje especial: conectar con un token de acceso". Todo lo demás se comporta igual.
7. Si algo no cuadra
- La búsqueda no aparece en la tienda: confirme el interruptor de las integraciones de aplicaciones (paso 2) y que guardó.
- Faltan productos: los borradores, los archivados y los no publicados en el canal de la tienda online quedan fuera del índice a propósito, porque no tienen página a la que apuntar. La guía de los productos que no aparecen recorre las demás causas.
- La sincronización se detuvo: la señal habitual de que la aplicación fue desinstalada o el acceso revocado. Vuelva a instalar por el paso 1; la tienda se reconecta a la misma cuenta y nada se pierde.
- Se alcanzó el límite de tiendas del plan: el mensaje dice el plan y el límite; volver a conectar una tienda que ya existe nunca se bloquea.