Saltar al contenido principal

Quickstart

Esta guía te lleva del cero al widget renderizado en tu tienda en 10 minutos. Sin teoría, sin internals. Copy-paste y listo.

Antes de empezar​

Necesitas una sola cosa: tu Shop API Key (sk_…). Si aún no la tienes, ve a Cómo obtener tu Shop API Key (3 minutos) y vuelve aquí.

export NEUROON_API_URL=https://api.neuroon.ai
export NEUROON_API_KEY=sk_tu_clave_aqui
export NEUROON_SHOP_ID=shop_tu_id_aqui

1. Sincroniza tu primer producto​

Desde tu servidor:

curl -X POST https://api.neuroon.ai/api/plugin/shops/$NEUROON_SHOP_ID/products/sync \
-H "X-Shop-API-Key: $NEUROON_API_KEY" \
-H "Content-Type: application/json" \
-d '{
  "syncType": "INCREMENTAL",
  "products": [{
    "externalId": "demo-001",
    "name": "Camiseta básica negra",
    "price": 19.99,
    "currency": "EUR",
    "url": "https://tutienda.com/p/demo-001"
  }]
}'

Respuesta (200):

{ "totalReceived": 1, "newProducts": 1, "updatedProducts": 0, "failed": 0 }

El producto está disponible para búsqueda en 2 a 5 segundos. Repite el POST con tu catálogo en lotes de hasta 500 productos.

2. Firma un Widget Token​

El Widget Token lo firma tu propio servidor localmente con la Shop API Key como secreto HMAC. No llamas a Neuroon para emitirlo. Ejemplo en Node:

import { createHmac } from 'node:crypto';

const ts = Math.floor(Date.now() / 1000);
const payload = `${process.env.NEUROON_SHOP_ID}:${ts}`;
const sig = createHmac('sha256', process.env.NEUROON_API_KEY).update(payload).digest('hex');
const token = Buffer.from(`${payload}:${sig}`, 'utf8').toString('base64url');

console.log(token); // c2hvcF9hYmM6MTcxNTAwMDAwMDoxYTJiM2M...

Cachea este token en tu servidor durante 24 horas. Pasado ese tiempo, vuelve a firmar. Implementaciones copy-paste en .NET, Python y PHP en Recipe · Server-to-server token.

3. Embebe el widget en tu tienda​

En la plantilla HTML de tu tienda (cualquier framework: Next.js, ASP.NET, PHP, Express, Rails…):

<div id="neuroon-search"></div>
<script
src="https://cdn.neuroon.ai/widget@0.9.10/widget.js"
data-token="EL_TOKEN_DEL_PASO_2"
data-container="#neuroon-search"
data-api-url="https://api.neuroon.ai"
data-theme="auto"
data-locale="es">
</script>

Sustituye EL_TOKEN_DEL_PASO_2 por la sintaxis de tu motor de plantillas.

4. Prueba​

Abre tu tienda. Haz click en <div id="neuroon-search">. El widget abre. Busca "camiseta". Aparece tu producto.

Si algo no funciona, ve a Troubleshooting.

Siguientes pasos​

Última actualización en