Référence des Actions AI
Lorsqu'il est connecté avec les permissions API appropriées, votre assistant AI peut effectuer les actions suivantes sur votre boutique PrestaShop en temps réel. Ces actions sont disponibles dans les flux de travail SmartFlow et peuvent également être utilisées par l'AI lors des conversations avec vos clients.
Produits
Obtenir un Produit
Récupérer les détails complets d'un produit par son ID.
- Entrée : ID du produit
- Retourne : Nom, description, description courte, référence, prix, quantité en stock, statut actif, champs SEO (titre méta, description méta, mots-clés méta)
- Permission API :
products(GET)
Mettre à Jour le Contenu du Produit
Mettre à jour la description et/ou la description courte d'un produit, avec un support multilingue complet.
- Entrées : ID du produit, description (facultatif), description courte (facultatif), ID de la langue (facultatif — par défaut à la langue principale de la boutique)
- Retourne : Confirmation avec la liste des champs mis à jour
- Permission API :
products(GET + PUT)
L'AI préserve le contenu dans d'autres langues lors de la mise à jour d'une langue spécifique. Par exemple, la mise à jour de la description en français n'affectera pas la version anglaise.
Mettre à Jour le SEO du Produit
Mettre à jour les champs SEO d'un produit, avec un support multilingue.
- Entrées : ID du produit, titre méta (facultatif), description méta (facultatif), mots-clés méta (facultatif), ID de la langue (facultatif)
- Retourne : Confirmation avec les valeurs SEO mises à jour
- Permission API :
products(GET + PUT)
Commandes
Obtenir une Commande par Référence
Rechercher une commande spécifique en utilisant son numéro de référence (par exemple, ABCDEF123).
- Entrée : Référence de la commande
- Retourne : Détails complets de la commande, y compris la date, le statut, le montant total, le mode de paiement, les informations d'expédition et la liste des produits
- Permission API :
orders(GET),order_details(GET),order_states(GET)
Obtenir des Commandes par Email
Récupérer toutes les commandes passées par un client spécifique.
- Entrées : Email du client, limite (facultatif — par défaut à 10)
- Retourne : Liste des commandes avec détails complets, nombre total
- Permission API :
orders(GET),order_details(GET),order_states(GET),customers(GET)
Obtenir la Dernière Commande
Obtenir la commande la plus récente pour un client spécifique.
- Entrée : Email du client
- Retourne : La dernière commande avec détails complets, ou null si aucune commande trouvée
- Permission API :
orders(GET),order_details(GET),order_states(GET),customers(GET)
Mettre à Jour le Statut de la Commande
Changer le statut d'une commande (par exemple, marquer comme expédiée, marquer comme livrée).
- Entrées : ID de la commande, nouvel ID d'état de commande, envoyer une notification par email (facultatif — par défaut à non)
- Retourne : Confirmation avec le nouveau statut et si un email a été envoyé
- Permission API :
order_histories(GET + POST)
Changer le statut d'une commande peut déclencher des notifications par email aux clients si l'option sendEmail est activée. Assurez-vous que le statut correct est appliqué.
Clients
Obtenir un Client
Rechercher un client par son adresse email.
- Entrée : Email du client
- Retourne : ID du client, prénom, nom, email, date de naissance, statut de la newsletter, date d'inscription, notes
- Permission API :
customers(GET)
Mettre à Jour un Client
Mettre à jour les informations de profil d'un client.
- Entrées : ID du client, prénom (facultatif), nom (facultatif), email (facultatif), notes (facultatif)
- Retourne : Confirmation avec la liste des champs mis à jour
- Permission API :
customers(GET + PUT)
Configuration
Obtenir les Langues
Lister toutes les langues configurées sur votre boutique PrestaShop.
- Aucune entrée requise
- Retourne : Liste des langues avec ID, nom et code ISO (par exemple,
fr,en,de) - Permission API :
languages(GET)
Cette action est utilisée en interne par l'AI lors de la mise à jour multilingue des produits, pour s'assurer que l'ID de langue correct est utilisé.
Tableau récapitulatif
| Action | Catégorie | Lecture | Écriture |
|---|---|---|---|
| Obtenir un Produit | Produits | Oui | — |
| Mettre à Jour le Contenu du Produit | Produits | Oui | Oui |
| Mettre à Jour le SEO du Produit | Produits | Oui | Oui |
| Obtenir une Commande par Référence | Commandes | Oui | — |
| Obtenir des Commandes par Email | Commandes | Oui | — |
| Obtenir la Dernière Commande | Commandes | Oui | — |
| Mettre à Jour le Statut de la Commande | Commandes | — | Oui |
| Obtenir un Client | Clients | Oui | — |
| Mettre à Jour un Client | Clients | Oui | Oui |
| Obtenir les Langues | Config | Oui | — |
Liens Connexes
- Permissions API — Configurer les permissions Webservice requises
- Webhooks & Compétences — Déclencher ces actions automatiquement lors des événements de la boutique