Referencia de Acciones de IA

Cuando esté conectado con los permisos de API adecuados, su asistente de IA puede realizar las siguientes acciones en su tienda PrestaShop en tiempo real. Estas acciones están disponibles en los flujos de trabajo de SmartFlow y también pueden ser utilizadas por la IA durante las conversaciones con sus clientes.

---

Productos

Obtener Producto

Recuperar todos los detalles de un producto por su ID.

• Entrada: ID del producto
• Devuelve: Nombre, descripción, descripción corta, referencia, precio, cantidad en stock, estado activo, campos SEO (título meta, descripción meta, palabras clave meta)
• Permiso de API: products (GET)

Actualizar Contenido del Producto

Actualizar la descripción y/o la descripción corta de un producto, con soporte multilingüe completo.

• Entradas: ID del producto, descripción (opcional), descripción corta (opcional), ID de idioma (opcional — por defecto es el idioma principal de la tienda)
• Devuelve: Confirmación con la lista de campos actualizados
• Permiso de API: products (GET + PUT)

consejo

La IA preserva el contenido en otros idiomas al actualizar un idioma específico. Por ejemplo, actualizar la descripción en francés no afectará la versión en inglés.

Actualizar SEO del Producto

Actualizar los campos SEO de un producto, con soporte multilingüe.

• Entradas: ID del producto, título meta (opcional), descripción meta (opcional), palabras clave meta (opcional), ID de idioma (opcional)
• Devuelve: Confirmación con los valores SEO actualizados
• Permiso de API: products (GET + PUT)

---

Pedidos

Obtener Pedido por Referencia

Buscar un pedido específico usando su número de referencia (por ejemplo, ABCDEF123).

• Entrada: Referencia del pedido
• Devuelve: Detalles completos del pedido incluyendo fecha, estado, monto total, método de pago, información de envío y lista de productos
• Permiso de API: orders (GET), order_details (GET), order_states (GET)

Obtener Pedidos por Correo Electrónico

Recuperar todos los pedidos realizados por un cliente específico.

• Entradas: Correo electrónico del cliente, límite (opcional — por defecto es 10)
• Devuelve: Lista de pedidos con detalles completos, conteo total
• Permiso de API: orders (GET), order_details (GET), order_states (GET), customers (GET)

Obtener Último Pedido

Obtener el pedido más reciente para un cliente específico.

• Entrada: Correo electrónico del cliente
• Devuelve: El último pedido con detalles completos, o nulo si no se encontraron pedidos
• Permiso de API: orders (GET), order_details (GET), order_states (GET), customers (GET)

Actualizar Estado del Pedido

Cambiar el estado de un pedido (por ejemplo, marcar como enviado, marcar como entregado).

• Entradas: ID del pedido, nuevo ID de estado del pedido, enviar notificación por correo electrónico (opcional — por defecto es no)
• Devuelve: Confirmación con el nuevo estado y si se envió un correo electrónico
• Permiso de API: order_histories (GET + POST)

aviso

Cambiar el estado de un pedido puede activar notificaciones por correo electrónico al cliente si la opción sendEmail está habilitada. Asegúrese de que se esté aplicando el estado correcto.

---

Clientes

Obtener Cliente

Buscar un cliente por su dirección de correo electrónico.

• Entrada: Correo electrónico del cliente
• Devuelve: ID del cliente, nombre, apellido, correo electrónico, fecha de nacimiento, estado del boletín, fecha de registro, notas
• Permiso de API: customers (GET)

Actualizar Cliente

Actualizar la información del perfil de un cliente.

• Entradas: ID del cliente, nombre (opcional), apellido (opcional), correo electrónico (opcional), notas (opcional)
• Devuelve: Confirmación con la lista de campos actualizados
• Permiso de API: customers (GET + PUT)

---

Configuración

Obtener Idiomas

Listar todos los idiomas configurados en su tienda PrestaShop.

• No se requiere entrada
• Devuelve: Lista de idiomas con ID, nombre y código ISO (por ejemplo, fr, en, de)
• Permiso de API: languages (GET)

info

Esta acción es utilizada internamente por la IA al realizar actualizaciones de productos multilingües, para asegurar que se utilice el ID de idioma correcto.

---

Tabla de Resumen

Acción	Categoría	Leer	Escribir
Obtener Producto	Productos	Sí	—
Actualizar Contenido del Producto	Productos	Sí	Sí
Actualizar SEO del Producto	Productos	Sí	Sí
Obtener Pedido por Referencia	Pedidos	Sí	—
Obtener Pedidos por Correo Electrónico	Pedidos	Sí	—
Obtener Último Pedido	Pedidos	Sí	—
Actualizar Estado del Pedido	Pedidos	—	Sí
Obtener Cliente	Clientes	Sí	—
Actualizar Cliente	Clientes	Sí	Sí
Obtener Idiomas	Configuración	Sí	—

---

Relacionados

• Permisos de API — Configure los permisos de Webservice requeridos
• Webhooks y Habilidades — Active estas acciones automáticamente en eventos de la tienda