Privacidad, resolución de problemas y ganchos para desarrolladores – WebMCP

Datos y privacidad

El módulo guarda todo en la base de datos de su tienda. No se envía nada a PrestaChamps.

Una visita desde el enlace de un asistente se recuerda durante 30 días en la propia cookie de su tienda (ninguna cookie nueva): solo el canal, el asistente y la hora. Las valoraciones y opiniones se leen de su módulo de opiniones cuando un asistente las pide; nunca se copian.

Las solicitudes de devolución y de cancelación no guardan ningún registro propio en el módulo. Una solicitud de devolución es una devolución de mercancía de PrestaShop, como si el cliente hubiera usado el formulario de devolución de su página de pedido. Una solicitud de cancelación es un mensaje en el pedido en el Servicio al Cliente de PrestaShop, escrito desde la cuenta del cliente; a diferencia del formulario de mensajes de la página del pedido, no guarda ninguna dirección IP. Sus límites diarios son contadores como los límites de solicitudes de arriba.

El módulo elimina por sí mismo los registros caducados, como máximo cada 6 horas. Eliminar un cliente elimina sus conexiones, sus tokens, sus compras preparadas y sus pruebas; sus líneas del registro desaparecen tras los Días de conservación del registro. Las compras preparadas de una prueba con IA (Probar con un agente de IA) se conservan 30 días como cualquier otra. Mientras el módulo está desactivado no elimina nada, ni siquiera cuando se elimina un cliente: desinstálelo para eliminar sus datos.

Lo que debe mencionar en su política de privacidad: que los compradores pueden conectar un asistente de IA a su cuenta, lo que el módulo conserva de esas conexiones (arriba) y que el proveedor del asistente (OpenAI, Anthropic) decide lo que conserva de la conversación; y, si prueba como clientes reales en Probar con un agente de IA, que sus pedidos y precios se envían al proveedor de IA con el que prueba.

Desinstalación. Desinstalar el módulo elimina sus carritos de prueba abiertos y después todo lo anterior: todas las tablas y todos los ajustes del módulo. El robots.txt se deja como está (vuelva a generarlo en Parámetros de la tienda › Tráfico & SEO para quitar el grupo del módulo).

Enlaces de pago tras desactivar o desinstalar. Desactivar o desinstalar el módulo termina al instante todas las sesiones abiertas con un enlace de pago. Un navegador que abrió un enlace así puede seguir mostrando el nombre, el correo electrónico y las direcciones del comprador en los datos de su página hasta que caduque la cookie de la tienda, porque el propio PrestaShop lee el cliente de esa cookie (comunicado a PrestaShop).

↑ Volver arriba

Solución de problemas

Empiece por Diagnóstico: cada línea de abajo es una comprobación de su lista, con lo que significa y cómo corregirla. Mientras los asistentes del móvil están desactivados, las cinco líneas «Asistentes del móvil» son solo informativas.

• Módulo activado en esta tienda – falla cuando el módulo no está activado para esta tienda en el Gestor de módulo (Abrir el Gestor de módulo), está desactivado en sus ajustes (Abrir los ajustes) o cuando la tienda está en modo mantenimiento (los visitantes y los asistentes ven entonces la página de mantenimiento; Abrir los ajustes de mantenimiento).
• Herramientas ofrecidas – falla cuando no hay ninguna herramienta activada («los asistentes no encuentran nada que usar en su tienda»), requiere atención cuando solo están activados los cambios del carrito (los asistentes no pueden buscar ni leer su catálogo para encontrar qué añadir). Solución: Elegir las herramientas.
• Páginas seguras (HTTPS) – falla sin HTTPS: los navegadores solo ofrecen WebMCP en páginas seguras. «HTTPS solo está activado en algunas páginas»: active HTTPS en todas las páginas (Abrir la configuración general). Una tienda en su propio ordenador muestra «Seguro solo para desarrollo».
• Conexión con las páginas de su tienda – «El módulo no está del todo conectado a las páginas de su tienda, por lo que es posible que no ofrezcan las herramientas.» Solución: Reparar los ganchos en la misma tarjeta.
• Tokens de Origin Trial – informativa sin token: «Sin token, solo los navegadores con la opción de prueba (flag) de WebMCP ven sus herramientas.» (Añadir un token). Avisa cuando un token es para otra dirección, no es de la prueba de WebMCP, ha caducado o caduca en los próximos 14 días.
• Índice de búsqueda – vea El índice de búsqueda.
• La tienda responde – el módulo llama a la dirección de su propia tienda desde su servidor. «Su servidor no ha podido abrir la dirección de su propia tienda (es habitual detrás de cortafuegos y en Docker)»: use Abrir la comprobación de la tienda en su navegador. «La tienda redirige esta dirección a otro sitio en lugar de responder»: revise la dirección de su tienda y sus reglas de redirección. «La tienda responde «no disponible»»: normalmente, por el modo mantenimiento. Después de una corrección, Borrar la caché.
• Motor de búsqueda de la tienda – informativa: qué módulo responde a las búsquedas de su tienda («Las búsquedas de la tienda usan la búsqueda propia de PrestaShop.» o «Las búsquedas de la tienda las responde …»); «El módulo de búsqueda terminó la solicitud en lugar de responder»: su alternativa redirige a la página de búsqueda de la tienda; los asistentes reciben entonces la búsqueda propia de PrestaShop.
• Asistentes del móvil: dirección segura (HTTPS) – falla sin SSL: ChatGPT y Claude solo se conectan a tiendas con HTTPS (Abrir la configuración general). Una tienda en su propio ordenador la supera como «Solo para desarrollo».
• Asistentes del móvil: URL amigables – falla cuando las URL amigables están desactivadas (Abrir los ajustes de SEO y URL).
• Asistentes del móvil: direcciones de descubrimiento – la tienda obtiene sus propios documentos /.well-known/oauth-…, donde los asistentes averiguan cómo inician sesión los compradores. Requiere atención cuando solo responden las copias propias del módulo (la mayoría de los asistentes se conectan igualmente); falla cuando no responde ninguno o cuando indican otra dirección (revise el dominio de la tienda y el ajuste SSL). Solución: su servidor web debe enviar a PrestaShop las direcciones que empiezan por /.well-known/oauth-; en Apache, ninguna regla del .htaccess debe detener /.well-known/ antes de las reglas de PrestaShop; en Nginx, añada una location para /.well-known/oauth- que pase a index.php. Detrás de un cortafuegos, puede que el servidor no llegue a su propia dirección: use en su lugar Abrir el documento en su navegador.
• Asistentes del móvil: cabecera de inicio de sesión – falla cuando su servidor descarta el inicio de sesión que envían los asistentes conectados (la cabecera Authorization): entonces no pueden usar el carrito, los pedidos ni la compra. Solución: Apache con PHP como CGI o FastCGI: añada CGIPassAuth On al .htaccess de la tienda, o conserve la línea de PrestaShop que copia la cabecera en HTTP_AUTHORIZATION; Nginx: añada fastcgi_param HTTP_AUTHORIZATION $http_authorization a la location de PHP.
• Asistentes en el móvil: el mismo carrito en la web – informativa cuando Volver a mostrar el carrito al iniciar sesión está desactivado: un comprador que inicia sesión en su sitio web recibe entonces un carrito nuevo y vacío en lugar del del asistente (el enlace de pago sigue abriendo el carrito del asistente). Solución: elija Abrir Ajustes sobre clientes y active el ajuste.
• Directorios de agentes de IA – informativa mientras Describir esta tienda para los directorios de agentes de IA está desactivado; requiere atención si el robots.txt todavía envía a los directorios a la descripción (abra Ajustes › Ajustes avanzados › Directorios de agentes de IA y guarde). Falla cuando las URL amigables están desactivadas (Parámetros de la tienda › Tráfico & SEO), cuando la descripción o la guía para agentes de IA no responde (compruebe que el módulo está activado para esta tienda y después borre la caché de la tienda) o cuando la descripción no cumple el formato (los detalles indican cada problema). Requiere atención cuando su servidor no pudo abrir su propia dirección (use en su lugar Abrir la descripción en su navegador); cuando su servidor no pasa /.well-known/ard.json y /.well-known/ai-catalog.json a PrestaShop (Apache: ninguna regla del .htaccess debe detener /.well-known/ antes de las reglas de PrestaShop; Nginx: una location para estas dos direcciones que pase a index.php); cuando /llms.txt no responde con el resumen del módulo (Nginx: haga que la location de los archivos .txt recurra a index.php); cuando el robots.txt aún no tiene ninguna línea Agentmap: o tiene una desactualizada (abra Ajustes › Ajustes avanzados › Directorios de agentes de IA y guarde); o cuando su línea Agentmap: indica otro dominio (quite esa línea si no es suya). Vea Directorios de agentes de IA y llms.txt.
• Formularios para agentes de IA – informativa cuando Marcar formularios para agentes de IA está desactivado («Chrome Lighthouse indica que los formularios de su tienda no están marcados para agentes de IA»; Abrir los ajustes) o cuando Ofrecer herramientas en esta tienda está desactivado. Requiere atención cuando las páginas de la tienda informaron en los últimos 7 días de formularios que Chrome cuenta como problemas de WebMCP (solo con el Modo de diagnóstico activado): un formulario del tema o de otro módulo con solo uno de los atributos toolname y tooldescription (dele los dos, o ninguno), un formulario que usa el nombre de una de las herramientas del módulo (cámbiele el nombre), dos formularios con el mismo nombre en una misma página, un formulario marcado con un campo sin nombre o sin etiqueta, o botones de opción fuera de un fieldset (corrija esto en el tema), o formularios marcados como no destinados a agentes que el navegador ofreció igualmente (desactive Marcar formularios para agentes de IA y busque una actualización del módulo). Vea Herramientas de formulario en sus páginas.
• Valoraciones y opiniones – qué módulo de opiniones leen las respuestas sobre productos («Las respuestas sobre productos incluyen las valoraciones y opiniones recientes de …»). Informativa cuando Mostrar valoraciones y opiniones a los agentes de IA está desactivado (Abrir los ajustes), cuando no hay activo ningún módulo de opiniones que esta versión sepa leer, o cuando el activo guarda sus opiniones en sus propios servidores, recoge opiniones sobre la tienda y no sobre los productos, o esta versión aún no sabe leerlo; requiere atención cuando el módulo está activo pero sus tablas de opiniones no se pueden leer. Vea Valoraciones y opiniones.
• Envío a sus países principales – requiere atención cuando ningún transportista envía a su país por defecto o a uno de los países de los que recibió más pedidos en los últimos 90 días («Ningún transportista envía a: …. Los clientes y los asistentes no encuentran ninguna opción de envío allí.»). Solución: elija Abrir los transportistas y añada la zona del país a un transportista.
• Agentes de IA verificados – informativa mientras Reconocer a los agentes de IA verificados está desactivado (Abrir los ajustes) o mientras ningún agente de IA ha enviado una solicitud firmada en la última semana (todavía pocos agentes firman). Se supera con el número de solicitudes de agentes verificados. Requiere atención cuando su PHP no tiene la extensión sodium (pida a su proveedor de alojamiento que la active), o cuando la mayoría de las firmas de agentes conocidos no se pudieron verificar: un proxy o una CDN que cambia la dirección de la tienda, o un reloj del servidor incorrecto, pueden causarlo; los Detalles indican los motivos.
• Cortafuegos y agentes de IA – su servidor abre su tienda como un navegador, después como ChatGPT y otros agentes de IA, y su servidor MCP como ChatGPT. Se supera cuando los agentes reciben su tienda como la recibe un navegador. Falla cuando una regla de cortafuegos o de bots los rechaza o les plantea un desafío, y la nombra con lo que hay que cambiar: Cloudflare (políticas de bots de IA: ponga Agent y Search en Allow; Bot Fight Mode no se puede omitir con reglas), Imunify360, ModSecurity, LiteSpeed, Sucuri, Akamai, BitNinja, o un límite del alojamiento que responde «demasiadas solicitudes». Requiere atención cuando su servidor no puede abrir su propia dirección (frecuente detrás de cortafuegos y en Docker) o recibe él mismo un desafío, de modo que no puede saberlo desde aquí.
• Solicitudes de devolución y de cancelación – informativa mientras las dos herramientas están desactivadas (Abrir las herramientas). Requiere atención cuando Solicitar una devolución está activada pero su tienda no acepta devoluciones de mercancía, por lo que se rechaza cada solicitud de devolución: active las devoluciones en Servicio al Cliente › Devoluciones de mercancía (Abrir las devoluciones de mercancía). Muestra su plazo de devolución.
• Feed de productos para ChatGPT – informativa cuando el módulo independiente «OpenAI / ChatGPT Ads» no está instalado. Requiere atención cuando está instalado pero no activo en esta tienda, cuando su feed de productos está desactivado, o cuando aún no se ha elegido su entrega (dirección del feed alojado o SFTP) (Abrir sus ajustes). Se supera cuando gestiona su feed.
• WebMCP en este navegador – información sobre el navegador que usa ahora (vea Este navegador y los informes de la tienda).

Otras preguntas frecuentes:

• El asistente dice que la tienda no tiene herramientas. Ofrecer herramientas en esta tienda está desactivado, no hay ninguna herramienta activada en Herramientas, o una caché de página sigue sirviendo páginas de antes: vacíela.
• El asistente no puede añadir al carrito. Añadir al carrito está desactivada en Herramientas; en el móvil, el comprador no ha conectado su cuenta.
• Un comprador no puede conectarse. Su cuenta se creó en un pago como invitado (debe crear una con contraseña), o intenta conectarse una aplicación que no es ChatGPT ni Claude mientras Permitir cualquier aplicación de asistente está desactivado.
• El enlace de pago dice que ya no es válido. Ya se usó o caducó: el comprador pide uno nuevo al asistente.
• Un asistente dice que la tienda no tiene respuesta sobre el envío o las devoluciones. Escriba la respuesta en FAQ para agentes de IA, o añada una página sobre ello en Diseño › Páginas (vea FAQ para agentes de IA). Buscar información de la tienda debe estar activada en Herramientas.
• Un código de descuento se rechaza con «Demasiados intentos fallidos». Se probaron demasiados códigos que su tienda no conoce desde esa sesión o dirección: los intentos vuelven a funcionar al cabo de un tiempo (vea Códigos de descuento).
• Pedidos de asistentes de IA no muestra nada. Solo cuentan los pedidos válidos, y solo aquellos cuyo carrito tocó un asistente o que llegaron desde el enlace de un asistente en un plazo de 30 días; compruebe que Contar los pedidos de asistentes de IA está activado (Ajustes › Ajustes avanzados › Registro de llamadas). Detrás de una caché de página, vacíe la caché una vez después de una actualización (vea Visitas desde enlaces de IA detrás de una caché de página).
• Un asistente dice que no puede enviar una solicitud de devolución. Solicitar una devolución está desactivada en Herramientas, el cliente no ha iniciado sesión, su tienda no acepta devoluciones de mercancía, el pedido aún no se ha entregado o su plazo de devolución ha terminado, o el cliente ya envió 5 solicitudes hoy.
• Un enlace de carrito abre un carrito vacío. Enlaces de carrito para asistentes de IA está desactivado, o los productos no están disponibles o no tienen stock (la página del carrito los nombra). El enlace llena el carrito del navegador que lo abre, y un mismo enlace añade sus productos solo una vez en 10 minutos.
• Productos para agentes de IA muestra puntuaciones antiguas. Las puntuaciones son las de la última comprobación: elija Comprobar de nuevo.
• Los asistentes no mencionan su texto para agentes de IA. Compruebe que Dar sus textos de producto a los agentes de IA (Ajustes › Respuestas sobre productos) y la herramienta Consultar los detalles del producto están activados, y que el texto existe en el idioma del comprador o en su idioma por defecto.
• Los asistentes encuentran menos productos que su buscador. Vea El índice de búsqueda.
• Las llamadas se rechazan con «demasiadas solicitudes» detrás de una CDN. Los visitantes que llegan por un mismo nodo de la CDN comparten sus límites: rellene Proxies de confianza con los rangos de direcciones que publica su CDN (Ajustes › Ajustes avanzados › Límites).
• Probar con un agente de IA dice «Añada una clave de IA o elija la demostración.» Añada una clave en Claves de IA o elija la demostración. «Se ha alcanzado el límite de hoy para las pruebas con IA.» Aumente Presupuesto diario de las pruebas con IA o espere a mañana; la demostración sigue funcionando. «… no ha respondido a tiempo.» / «La tienda no ha podido conectar con ….» Su servidor no puede abrir conexiones HTTPS hacia el proveedor: pida a su proveedor de alojamiento que permita las conexiones HTTPS salientes hacia el proveedor de IA que usa (Anthropic, OpenAI o Google).
• La auditoría dice «Su servidor no ha podido abrir las páginas de su propia tienda.» Use Comprobar desde este navegador.
• La puntuación no cambió después de una corrección. Las barras y las respuestas son las de la última ejecución completa: vuelva a ejecutar la auditoría completa.
• La auditoría «Agentic browsing» de Chrome Lighthouse indica elementos sin nombre. Ejecute la auditoría completa y abra Accesibilidad para agentes de IA: sus detalles indican cada elemento, su página y la parte de la plantilla que lo imprime (vea Accesibilidad para agentes de IA). Los elementos creados por scripts solo los ve Lighthouse.
• /llms.txt muestra otro texto que no es el resumen del módulo. En su lugar se sirve un archivo llamado llms.txt que está en la raíz de la tienda: bórrelo o cámbiele el nombre para que responda el resumen del módulo.
• Un enlace de pago abierto en un móvil responde «Página no encontrada». En PrestaShop 8, la opción Desactivar en móviles del Gestor de módulo está activada para el módulo: los enlaces de pago no se abren entonces en los móviles (no se inicia ninguna sesión). Desactívela para este módulo.

Cuando contacte con el soporte de PrestaChamps, indique qué líneas de Diagnóstico requieren atención y, si el registro está activado, la hora y la herramienta de una llamada fallida.

↑ Volver arriba

Para desarrolladores

Otros módulos pueden ofrecer sus propias herramientas a los asistentes mediante el hook del módulo actionPchwebmcpRegisterTools: aparecen entonces en Herramientas como «Añadida por otro módulo», desactivadas hasta que usted las active, y solo se ofrecen a los asistentes del móvil cuando Ofrecer herramientas de otros módulos a los asistentes del móvil está activado. La guía para desarrolladores (disponible a través de PrestaChamps) describe el hook, el formato de las herramientas, los niveles de acceso, la API de la tienda y el servidor MCP.

↑ Volver arriba