Instalar Wavize en Wix

Wix requiere dos configuraciones: widget y tienda

El código personalizado de Wix muestra el widget en sitio. La conexión comercio Wix permite a Wavize leer catálogo y pedidos vía API con URL base, Site ID en formato UUID y clave API. Puedes instalar widget sin conectar Wix Stores, pero catálogo y seguimiento no estarán disponibles.

Wavize detecta si sitio usa catálogo Wix Stores v1 o v3 y guarda esta versión en conexión. La prueba debe pasar antes de interpretar ausencia de productos como problema IA.

Secretos separados
El token público del widget va en código personalizado. La clave API Wix queda solo en formulario servidor Wavize y jamás debe pegarse en código Wix.

Publicar widget con código personalizado

Tu plan Wix y dominio deben permitir código personalizado.

1. Copiar bloque Wavize

   En Asistente > Instalación, copia script completo ligado a dominio Wix público. No reemplaces token por clave API comercio.

2. Añadir en Wix

   En panel Wix, abre Configuración > Avanzado > Código personalizado, añade bloque en body y elige páginas. Publica sitio tras guardar.

3. Respetar consentimiento y dominio

   Dispara código según política cookies y prueba URL final. Dominio Wix gratuito y personalizado son hosts distintos para control Wavize.

Crear clave API Wix dedicada

En dashboard cuenta Wix, abre Configuración cuenta > Claves API y crea clave limitada a sitio y permisos.

1. Nombre y alcance

   Nómbrala Wavize y selecciona sitio. Evita clave global si alcance más restrictivo es posible.

2. Permisos lectura comercio

   Concede lectura catálogo/productos y pedidos ecommerce necesarios. Etiquetas Wix pueden cambiar entre catálogo v1 y v3; busca permisos Business Management / Wix Stores / eCommerce correspondientes.

3. Copia única y rotación

   Copia clave al crear en gestor seguro. Si se pierde o expone, crea nueva, actualiza Wavize, prueba y revoca antigua.

Encontrar Site ID exacto

Site ID no es nombre ni dominio. Wavize espera UUID.

• Desde herramientas desarrollador Wix

  Abre sitio en dashboard desarrollador o docs API cuenta y copia identificador del sitio. Tiene formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.

• Verificar asociación

  Site ID debe pertenecer a sitio autorizado por clave. Clave válida para otro sitio puede dar rechazo o catálogo vacío.

• URL base

  Introduce sitio público HTTPS en Wavize. Sirve para enlaces producto e identificar conexión; no pegues URL editor Wix.

Probar versión catálogo y pedidos

Guarda conexión, haz clic en Probar y actívala si validación es correcta.

1. Detección v1 / v3

   Wavize consulta API disponibles y guarda V1_CATALOG o V3_CATALOG. No modifiques valor manualmente: depende del sitio Wix.

2. Búsqueda producto

   Prueba producto publicado con nombre, precio y variante exacta. Producto oculto o no disponible puede faltar en recomendación.

3. Pedido y email

   Usa pedido test y email cliente. Respuesta es neutra si referencia o email no coincide aunque pedido exista.

Diagnóstico Wix rápido

Separar invisibilidad widget y fallo API comercio.

• Widget ausente — Revisa código personalizado, publicación, dominio y consentimiento.
• Prueba 401 / 403 — Verifica clave, permisos, sitio autorizado y Site ID.
• Catálogo vacío — Revisa versión detectada, productos publicados y alcance clave.