Saltar al contenido principal
Tu asistente lee los precios, las existencias y el estado de los pedidos de tu tienda Shopware 5. Nunca cambia nada en la tienda.
Shopware 5 ya no recibe actualizaciones de seguridad: el soporte de seguridad terminó el 31 de julio de 2024 y la última versión fue la 5.7.20. Planifica tu paso a Shopware 6. Esta conexión es para tiendas que, mientras tanto, siguen usando Shopware 5.

Conectar tu tienda

  1. Comprueba la versión. La conexión necesita Shopware 5.3.2 o posterior y se prueba con la 5.7. Tu tienda debe ser accesible por HTTPS desde internet.
  2. En el backend de Shopware, abre Settings → User administration (en alemán Einstellungen → Benutzerverwaltung), edita un usuario del backend y abre API access. Activa el acceso a la API y copia la clave de la API.
  3. Dale a ese usuario, mediante su rol, solo derechos de lectura para artículos y pedidos. El asistente puede leer todo lo que ese usuario puede leer.
  4. En Famulor, abre Agent Tools → Marketplace → Shopware 5. Introduce la dirección de la tienda, por ejemplo https://shop.example.com (añade la subcarpeta si la tienda funciona en una), el nombre de usuario de la API y la clave de la API. Deja Zona horaria de la tienda vacío para usar Europe/Berlin.
  5. Elige Agregar. La conexión se comprueba antes de guardarla. Después asígnala a tu asistente.
Para cambiar más adelante la dirección o las credenciales, elimina la herramienta y vuelve a conectarla.

Qué puede hacer el asistente

Las dos herramientas están activadas por defecto. Desactívalas en Editar.
  • Buscar productos: encuentra productos por nombre o número de artículo e indica a quien llama el precio con IVA para clientes estándar, las existencias y si el producto tiene variantes. Si un producto no tiene un tipo de IVA guardado, el asistente no dice ningún precio.
  • Estado del pedido: indica de un pedido el estado, el estado del pago, el contenido, el total, el método de envío y si existe un número de seguimiento.
Los nombres de estado proceden de los estados de pedido y de pago de tu tienda. Un estado que hayas creado tú se lee tal como lo nombraste.

Privacidad de los pedidos

Quien llama indica el número de pedido. El asistente pide el correo electrónico del pedido o el código postal de entrega y solo muestra el pedido si coincide. El número de pedido por sí solo nunca basta. Un dato incorrecto y un número de pedido desconocido reciben la misma respuesta, así que nadie descubre si existe un pedido. Tras tres intentos fallidos para el mismo número de pedido, el asistente deja de comprobar ese pedido. El asistente nunca lee en voz alta direcciones, correos electrónicos, teléfonos, comentarios ni números de seguimiento.

Qué no hace

  • No cambia nada: ni pedidos, ni estados, ni notas, ni clientes. Para el usuario de la API bastan derechos de lectura.
  • No reconoce a quien llama antes de que empiece la conversación.
  • No busca un pedido solo por el número de teléfono.
  • No lee los números de seguimiento. Solo dice si existe uno.
  • No admite la autenticación Digest.

Probar con seguridad

La conexión solo lee, así que una prueba no puede cambiar tu tienda. Prueba con un pedido tuyo: da el número de pedido y el correo electrónico del pedido. Comprueba que un código postal incorrecto recibe la misma respuesta que un número de pedido desconocido.

Canales

En todos los canales, el asistente pide el correo electrónico o el código postal de entrega.

Automatizaciones

Conecta Shopware 5 en Automatizaciones → Conexiones, o importa su conexión de Agent Tools. Las dos herramientas están disponibles como acciones. Una automatización iniciada por una llamada o una conversación de texto (SMS, WhatsApp) conoce el número de la otra persona por esa propia llamada. Las demás ejecuciones (webhook, programación) no tienen a nadie que llame, por eso Estado del pedido necesita allí siempre el correo electrónico o el código postal de entrega.

API, MCP, CLI & SDK

POST /api/v1/tools/integrations/shopware5 · MCP connect_integration · CLI famulor connect-integration shopware5. client.api.connectIntegration necesita famulor-sdk 0.2.12 o posterior. Actualiza la CLI con npm install --global famulor antes de usar connect-integration.

Solución de problemas

  • «Parece una tienda Shopware 6»: has introducido la dirección de una tienda Shopware 6. Usa en su lugar la conexión de Shopware 6.
  • «Shopware rechazó el usuario de la API o la clave»: comprueba el nombre de usuario y copia de nuevo la clave de la API. Asegúrate de que el acceso a la API esté activado para ese usuario.
  • «El usuario de la API necesita derechos de lectura para artículos y pedidos»: abre el rol del usuario de la API y permite leer artículos y pedidos.
  • «Esta dirección no lleva a la API de Shopware 5»: comprueba la dirección. Si la tienda funciona en una subcarpeta, inclúyela. No añadas /api.
  • «La tienda respondió con una página web en lugar de datos»: un cortafuegos, un plugin de seguridad o una página de mantenimiento bloquea la solicitud. Permite las solicitudes a /api para la conexión.
  • «Esta dirección redirige a otra»: la tienda redirige a los visitantes, por ejemplo de la dirección sin www a la que lleva www. Introduce la dirección que la tienda usa realmente.
  • «La tienda rechazó la solicitud a la API»: un cortafuegos o un módulo de seguridad (por ejemplo mod_security) bloquea /api. Permite las solicitudes a /api para la conexión.