Quickstart

Esta guia 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 codigo, conviene tener claros tres terminos que vas a leer en toda la docs:

• Tenant: tu instancia de Mibizum. Tiene un slug unico (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 busqueda. Personalizable en el panel.

Mas 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_...): produccion. Tiene scope publico (lectura) y privado (escritura). NUNCA expongas la privada en JS del navegador.
• Test key (mb_test_...): staging. Aislada de produccion.

Tendras dos valores:

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

2. Indexar tu catalogo

Opcion A - Magento

Instala el modulo 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 guia completa en Adapter Magento (proximamente).

Opcion 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

Opcion 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 busqueda nativa.

Opcion B - SDK JS programatico

Si quieres mas 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 numero de busquedas y el porcentaje sin resultados de hoy.
• Top queries lista las palabras mas buscadas en tiempo real.
• Aprende del cliente te propone sinonimos 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 sinonimos automaticos sin aplicarlos sin tu OK. Ver Guia: Corpus fallido a exitoso.

• Tu primer indice - tips para indexar bien desde el dia uno.
• API Reference - todos los endpoints REST.
• Guias de produccion - lecciones aprendidas que ahorran horas.