Gestionar las imágenes de un producto
ps_manage_product_images
- ProSolo TellMyShop Pro
- Escritura · vista previa + aprobación
- Guarda: al momento
- Contenido y SEO, Catálogo · escribe al momento
- Visible nada más instalar
Añade fotos de producto desde enlaces web, elige la foto principal y fija el orden de las fotos.
TellMyShop Free: No. Esta herramienta solo está en TellMyShop Pro. TellMyShop Free solo tiene informes listos que leen tu tienda.
Pregunta al chat
«Añade estas dos fotos a la lámpara Nova y pon la primera como foto principal: https://example.com/nova-1.jpg https://example.com/nova-2.jpg»
Vista previa de ejemplo
Producto 245 Lámpara de jardín Nova, negra: añadir 2 imágenes desde example.com. La imagen 1 pasa a ser la portada. Texto alt en todos los idiomas: "Lámpara de jardín Nova, negra". El producto todavía no tiene imágenes.
Detalles técnicos
action=list muestra las imágenes del producto (ID, posición, portada, texto alt, URL). action=add añade hasta 10 imágenes desde enlaces https públicos (JPEG, PNG, GIF o WebP, máx. 10 MB cada una); legend es el texto alt (por defecto: el nombre del producto), cover=true convierte la primera imagen nueva en portada. action=set_cover fija la portada (image_id). action=reorder pone image_ids al principio en el orden indicado y el resto va detrás. action=delete borra imágenes (image_ids); esto NO SE PUEDE DESHACER y necesita confirm_delete=true. Textos alt de las imágenes existentes: ps_update_image_legends.
Parámetros
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| action | enum: list | add | set_cover | reorder | delete | sí | list | add | set_cover | reorder | delete. |
| product | string | sí | El producto tal como lo nombra una persona: "id:123", "ref:ABC-1", "ean:5901234123457", una URL de producto de la tienda, un ID suelto (de 1 a 7 dígitos), un EAN (8/12/13 dígitos) o una referencia. Máx. 300 caracteres. |
| shop_id | integer | no | ID de la tienda en una instalación multitienda. Por defecto, la tienda de la dirección del conector. ps_get_shop_info lista los ID. |
| lang | string | no | Código ISO del idioma, por ejemplo pl o en. Por defecto, el idioma predeterminado de la tienda. |
| image_urls | array of string | cuándo | add: URL de las imágenes. Máx. 10 elementos. |
| legend | string | no | add: texto alt de las imágenes nuevas, en todos los idiomas. Máx. 128 caracteres. |
| cover | boolean | no | add: convertir la primera imagen nueva en portada. Por defecto false. |
| image_id | integer | cuándo | set_cover: la imagen. |
| image_ids | array of integer | cuándo | reorder / delete: las imágenes. Máx. 100 elementos. |
| confirm_delete | boolean | cuándo | delete: confirma que el usuario sabe que el borrado no se puede deshacer. Por defecto false. |
| confirm | boolean | no | false (por defecto) devuelve una vista previa y no guarda nada. true ejecuta, solo después de que el usuario haya aprobado la vista previa, junto con change_token. |
| change_token | string | cuándo | Token de la vista previa. Obligatorio con confirm=true. Válido 30 minutos, de un solo uso, ligado a los argumentos y al estado de los datos de la vista previa. |
Límites
Un producto por llamada. add: hasta 10 imágenes, enlaces https públicos, JPEG/PNG/GIF/WebP, máx. 10 MB y 40 megapíxeles cada una. delete no se puede deshacer (confirm_delete=true); add, set_cover y reorder se pueden deshacer con ps_revert_change.
Lo que ves antes de que se guarde nada
El chat llama primero a la herramienta sin confirmar. El módulo devuelve una vista previa (valores actuales y nuevos) y un token de un solo uso válido durante 30 minutos. El chat te muestra la vista previa y guarda el cambio solo después de tu sí.
Herramientas relacionadas
- Crear o duplicar un producto ps_create_product
- Actualizar el texto alt de las imágenes ps_update_image_legends
- Obtener un producto ps_get_product
- Deshacer un cambio ps_revert_change
Casos de uso con esta herramienta
- Encuentra productos sin imágenes, sin EAN o sin fabricante
- Añade productos nuevos desde una lista del proveedor
- Añade, reordena o sustituye fotos de producto
Última actualización: 2026-10-11