Quickstart

Esta guía te lleva de cero a tener Mibizum buscando en tu tienda en menos de 30 minutos. Asume que ya tienes una cuenta en mibizum.io y has creado un tenant.

Conceptos previos

Antes de pegar código, conviene tener claros tres terminos que vas a leer en toda la docs:

• Tenant: tu instancia de Mibizum. Tiene un slug único (tu-tienda) y vive aislado del resto de comercios.
• Data source: el catalogo indexado dentro de un tenant. Una tienda puede tener varios (productos, recetas, posts de blog).
• Widget: el componente visual que se monta en tu tienda y muestra el overlay de búsqueda. Personalizable en el panel.

Más en Conceptos.

1. Conseguir tu API key

En el panel de Mibizum, ve a Ajustes > API Keys y crea una clave nueva:

• Live key (mb_live_...): producción. Tiene scope publico (lectura) y privado (escritura). NUNCA expongas la privada en JS del navegador.
• Test key (mb_test_...): staging. Aislada de producción.

Tendras dos valores:

Public  : mb_pk_live_a1b2c3d4...
Private : mb_sk_live_x9y8z7w6... (no la pongas en frontend)

2. Indexar tu catalogo

Opción A - Magento

Instala el módulo oficial:

composer require mibizum/adapter-magento
bin/magento module:enable Mibizum_Adapter
bin/magento setup:upgrade

Configura las credenciales en Stores > Configuration > Mibizum. El primer reindex se dispara al guardar:

bin/magento mibizum:reindex

Ver la guía completa en Adapter Magento (proximamente).

Opción B - API REST directa

Si tu plataforma no es Magento, indexa con la API:

curl -X POST https://api.mibizum.io/v1/tu-tienda/items/bulk \
  -H "Authorization: Bearer mb_sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      {
        "id": "sku-001",
        "name": "Crema hidratante facial",
        "description": "Para piel seca con acido hialuronico",
        "price": 24.90,
        "image_url": "https://...",
        "in_stock": true,
        "categories": ["facial", "hidratacion"]
      }
    ]
  }'

Ver API > Items (proximamente).

3. Montar el widget en tu tienda

Opción A - script tag

Pega antes del </body> de tu plantilla:

<script
  async
  src="https://cdn.mibizum.io/widget/v1.js"
  data-mibizum-tenant="tu-tienda"
  data-mibizum-public-key="mb_pk_live_a1b2c3d4..."
></script>

El widget se auto-monta y reemplaza la barra de búsqueda nativa.

Opción B - SDK JS programatico

Si quieres más control:

import { Mibizum } from '@mibizum/sdk';

const mb = Mibizum.init({
  tenant: 'tu-tienda',
  publicKey: 'mb_pk_live_a1b2c3d4...',
});

document.getElementById('search-input')?.addEventListener('input', async (e) => {
  const q = (e.target as HTMLInputElement).value;
  const r = await mb.search(q);
  renderResults(r.hits);
});

Ver SDK Reference para el API completo.

4. Verificar

Abre tu tienda, escribe algo en el buscador y mira el panel de Mibizum:

• Resumen muestra el número de búsquedas y el porcentaje sin resultados de hoy.
• Top queries lista las palabras más buscadas en tiempo real.
• Aprende del cliente te propone sinónimos basados en clicks reiterados.

Si llegan eventos, todo funciona.

Siguiente paso

Recomendado

Configura Smart Mibizum (el aprendizaje IA) en modo hybrid para que te proponga sinónimos automáticos sin aplicarlos sin tu OK. Ver Guía: Corpus fallido a exitoso.

• Tu primer índice - tips para indexar bien desde el día uno.
• API Reference - todos los endpoints REST.
• Guías de producción - lecciones aprendidas que ahorran horas.