API Permissions
Pour débloquer tout le potentiel d'AI SmartTalk — comme la recherche de commandes, la mise à jour des descriptions de produits ou la gestion des clients — vous devez configurer un jeton API de PrestaShop Webservice avec les bonnes autorisations.
Cette étape est requise si vous souhaitez utiliser AI Actions (SmartFlow). Sans cela, votre assistant AI peut toujours répondre à des questions basées sur des connaissances synchronisées, mais ne pourra pas accéder aux données de la boutique en temps réel.
1. Activation du Webservice
- Allez dans Paramètres avancés > Webservice
- Activez le webservice de PrestaShop
- Cliquez sur Enregistrer
2. Création d'une clé API
- Sur la page Webservice, cliquez sur Ajouter une nouvelle clé de webservice
- Remplissez le formulaire :
- Clé : Cliquez sur Générer pour créer un jeton sécurisé, ou entrez le vôtre
- Description de la clé :
AI SmartTalk - Statut : Activé
- Définissez les autorisations comme décrit ci-dessous
- Cliquez sur Enregistrer
Copiez et enregistrez la clé API — vous en aurez besoin lors de la configuration de l'intégration dans AI SmartTalk.
3. Autorisations requises
Dans la section des autorisations de votre clé API, activez les ressources suivantes :
| Ressource | GET | PUT | POST | Description |
|---|---|---|---|---|
| products | Oui | Oui | — | Lire les détails des produits, mettre à jour les descriptions et le SEO |
| orders | Oui | — | — | Rechercher des commandes par référence ou par client |
| order_details | Oui | — | — | Voir les produits dans une commande |
| order_states | Oui | — | — | Lire les étiquettes des statuts de commande |
| order_histories | Oui | — | Oui | Lire l'historique des statuts, ajouter des changements de statut |
| customers | Oui | Oui | — | Rechercher et mettre à jour les informations sur les clients |
| languages | Oui | — | — | Lister les langues disponibles de la boutique |
Ne cochez que les autorisations listées ci-dessus. Il n'est pas nécessaire d'accorder l'accès à d'autres ressources.
4. À quoi sert chaque ressource
Produits (lecture + écriture)
- Lire : Récupérer les détails des produits — nom, description, description courte, prix, référence, stock, champs SEO (titre méta, description méta, mots-clés méta)
- Écrire : Mettre à jour les descriptions de produits, les descriptions courtes et les champs SEO avec un support multilingue complet
Commandes (lecture seule)
- Rechercher une commande par son numéro de référence
- Lister les commandes pour un client spécifique (par e-mail)
- Obtenir la commande la plus récente pour un client
Détails de la commande (lecture seule)
- Voir les produits dans une commande : nom, référence, quantité, prix unitaire
États de la commande (lecture seule)
- Récupérer l'étiquette lisible par l'homme pour chaque statut de commande (par exemple, "Paiement accepté", "Expédié")
Historiques de commande (lecture + création)
- Lire : Voir l'historique des changements de statut d'une commande
- Créer : Ajouter un nouveau changement de statut à une commande (par exemple, marquer comme expédié), avec notification par e-mail optionnelle au client
Clients (lecture + écriture)
- Lire : Rechercher un client par e-mail ou ID — récupérer nom, e-mail, date d'inscription, statut de la newsletter, notes
- Écrire : Mettre à jour les informations sur le client (prénom, nom, e-mail, notes)
Langues (lecture seule)
- Lister toutes les langues configurées sur votre boutique (utilisées pour les mises à jour de produits multilingues)
5. Saisie de la clé API dans AI SmartTalk
Une fois votre clé Webservice créée et configurée :
- Allez dans la configuration du module AI SmartTalk dans PrestaShop
- La clé API est généralement transmise lors de la connexion OAuth
- Si vous devez la mettre à jour, allez dans votre tableau de bord AI SmartTalk > Intégration > PrestaShop et mettez à jour le jeton Webservice
Pour les configurations multi-sites, chaque site peut avoir sa propre clé API Webservice configurée indépendamment.
Prochaines étapes
- Synchronisez les données de votre boutique — Poussez votre catalogue de produits vers l'AI
- Découvrez ce que l'AI peut faire — Référence complète des actions disponibles