Configuración
Toda la configuración vive dentro de la app, en el admin de Shopify (Apps → Mibizum Search). El menú lateral de la app tiene las pantallas: Inicio, Ajustes, Badges, Mercados e Indexación.
1. Ajustes (conexión)
Es el único paso imprescindible para que la app empiece a trabajar.
| Campo | Qué poner |
|---|---|
| Clave de indexación (escritura, secreta) | Tu clave privada (publica el catálogo). Panel → tu catálogo → API keys. Se guarda cifrada en el servidor y nunca llega al navegador; si se expone, regenérala en el panel. |
| Clave de búsqueda (solo lectura, pública) | Clave pública que alimenta el widget del escaparate. Se puede exponer sin problema. |
| Slug del origen de datos (opcional) | El slug del catálogo (por ejemplo products). Vacío = el primer catálogo de la cuenta. |
Dos claves a propósito: la clave privada escribe el catálogo (debe permanecer secreta y en el servidor); la clave pública solo lee. La que viaja al navegador del cliente (la pública) nunca puede modificar nada.
Al guardar las claves, la app publica la clave pública en un metacampo de la tienda para que la extensión de tema la use, y queda lista para indexar.
2. Indexación
La pantalla Indexación controla la sincronización del catálogo:
- Sincronización completa: exporta todo el catálogo (con la API de operaciones masivas de Shopify) y lo publica en Mibizum. Se ejecuta en segundo plano.
- Procesar cola: vacía los cambios incrementales pendientes (los que llegan por webhook). Verás el contador de trabajos pendientes.
Los cambios del día a día (crear/editar/borrar producto, cambios de stock) llegan solos por webhooks y se procesan en segundo plano; no hace falta reindexar a mano salvo la primera vez o tras un cambio grande.
3. El widget del escaparate
El buscador instantáneo se entrega con una extensión de tema. El comerciante lo activa desde Tienda online → Temas → Personalizar → Insertados de apps y activa Mibizum Search. Opciones del bloque:
| Opción | Notas |
|---|---|
| Mibizum API URL | https://app.mibizum.io (valor por defecto). |
| Clave de búsqueda (pública) | Normalmente se rellena sola desde la app; para tiendas multimercado, las claves por mercado se gestionan en Mercados. |
| Selector CSS del campo de búsqueda | A qué caja de búsqueda se engancha. Vacío = la caja estándar del tema. |
| Abrir resultados al enviar la búsqueda | Al pulsar Enter, abre los resultados de Mibizum en vez de ir a la página nativa. |
El paracaídas. El widget consulta Mibizum con la clave pública. Si Mibizum no respondiera (error de red, 5xx) o no estuviera configurado, no inyecta nada y la búsqueda nativa del tema sigue funcionando. El cliente nunca ve un error.
4. Badges (opcional)
En la pantalla Badges configuras las etiquetas de los resultados (sistema, por colección y por atributo). Ver Badges.
5. Mercados (opcional)
En Mercados asignas cada mercado e idioma de Shopify a su propio catálogo de Mibizum. Ver Multi-mercado.
Notas
- La app es segura por defecto: no publica nada hasta que las claves están presentes. Ver Mantenimiento para pausar o desinstalar.
- La clave de indexación se guarda cifrada (AES-256-GCM) en el servidor.