Solución de problemas

El widget no aparece en mi web

El motivo más habitual es que el selector CSS configurado no coincide con el campo de búsqueda real de tu web. Por defecto el widget busca input[type=search]. Si tu buscador usa un selector diferente, configúralo:

window.KoplyConfig = {
  apiKey:   'TU_API_KEY',
  selector: '#search-input',  // ajusta al selector de tu web
};

Puedes encontrar el selector correcto inspeccionando el HTML de tu buscador con las herramientas de desarrollador del navegador (clic derecho → Inspeccionar).

Las búsquedas están bloqueadas (error CORS)

Koply restringe las peticiones al dominio registrado en el panel. Si el dominio configurado no coincide exactamente con el dominio desde el que se carga el widget, todas las peticiones serán bloqueadas.

Comprueba en Sitios → Editar sitio que el campo dominio es exactamente igual al dominio de tu web. Ten en cuenta:

• Con o sin www importa: mitienda.com ≠ www.mitienda.com
• El protocolo no se incluye: escribe mitienda.com, no https://mitienda.com
• Sin barra final: mitienda.com, no mitienda.com/

No aparecen resultados al buscar

Hay tres causas posibles:

• El feed no se ha indexado aún. Ve a Sitios → Ver logs y comprueba si hay una indexación completada recientemente.
• El feed tiene errores. En los logs aparecerá el motivo. Los problemas más frecuentes son precios a cero o URLs de imagen incorrectas.
• El sitio está pausado. En el listado de sitios comprueba que el estado es Activo y no Pausado.

Los productos tienen precio 0 o no se indexan

Koply descarta automáticamente productos con precio igual a cero o no numérico. Comprueba que tu feed exporta el precio en formato numérico limpio, por ejemplo 19.99, sin símbolo de moneda ni texto adicional.

<g:price>19.99 EUR</g:price>


<g:price>19.99</g:price>

Las imágenes no se muestran en el widget

Las URLs de imagen deben empezar por https://. URLs con http:// o rutas relativas son descartadas. Comprueba en el feed que todas las imágenes tienen URL absoluta con HTTPS.

El feed tiene problemas de encoding

Koply soporta feeds en UTF-8 e ISO-8859-1. Si tu feed tiene caracteres especiales mal codificados (tildes o ñ que aparecen como símbolos extraños), asegúrate de que el servidor sirve el feed con la cabecera correcta:

Content-Type: application/xml; charset=UTF-8

El botón "Añadir al carrito" no funciona (Magento 2)

Si usas el módulo oficial de Magento 2 y el botón no funciona, comprueba:

• Que el módulo está habilitado: php bin/magento module:status Koply_Search
• Que el campo API Key está configurado en Stores → Configuration → Koply → Search Widget
• Que has limpiado la caché después de guardar: php bin/magento cache:flush

Consulta la documentación del módulo Magento 2 para más detalle.

El widget carga pero está lento

El widget se carga con defer para no bloquear el render de la página. Si notas lentitud en los resultados, comprueba que el sitio tiene productos indexados recientemente en los logs y que el plan activo corresponde a la frecuencia de re-indexación esperada.

Sigo sin solución

Escríbenos a support@koply.eu con el dominio de tu sitio y una descripción del problema. Te respondemos en menos de 24 horas.