API Permissions
Per sbloccare il pieno potenziale di AI SmartTalk — come cercare ordini, aggiornare descrizioni dei prodotti o gestire i clienti — è necessario configurare un token API del Webservice PrestaShop con i permessi appropriati.
Questo passaggio è obbligatorio se desideri utilizzare AI Actions (SmartFlow). Senza di esso, il tuo assistente AI può comunque rispondere a domande basate su conoscenze sincronizzate, ma non sarà in grado di accedere ai dati del negozio in tempo reale.
1. Abilitare il Webservice
- Vai su Parametri Avanzati > Webservice
- Abilita il webservice di PrestaShop
- Clicca su Salva
2. Creare una chiave API
- Nella pagina del Webservice, clicca su Aggiungi nuova chiave webservice
- Compila il modulo:
- Chiave: Clicca su Genera per creare un token sicuro, oppure inserisci il tuo
- Descrizione chiave:
AI SmartTalk - Stato: Abilitato
- Imposta i permessi come descritto di seguito
- Clicca su Salva
Copia e salva la chiave API — ne avrai bisogno quando configurerai l'integrazione in AI SmartTalk.
3. Permessi richiesti
Nella sezione dei permessi della tua chiave API, abilita le seguenti risorse:
| Risorsa | GET | PUT | POST | Descrizione |
|---|---|---|---|---|
| prodotti | Sì | Sì | — | Leggi i dettagli del prodotto, aggiorna descrizioni e SEO |
| ordini | Sì | — | — | Cerca ordini per riferimento o cliente |
| dettagli_ordine | Sì | — | — | Visualizza i prodotti all'interno di un ordine |
| stati_ordine | Sì | — | — | Leggi le etichette di stato dell'ordine |
| storie_ordine | Sì | — | Sì | Leggi la cronologia degli stati, aggiungi cambiamenti di stato |
| clienti | Sì | Sì | — | Cerca e aggiorna le informazioni sui clienti |
| lingue | Sì | — | — | Elenca le lingue disponibili nel negozio |
Controlla solo i permessi elencati sopra. Non è necessario concedere accesso ad altre risorse.
4. A cosa serve ciascuna risorsa
Prodotti (lettura + scrittura)
- Lettura: Recupera i dettagli del prodotto — nome, descrizione, descrizione breve, prezzo, riferimento, stock, campi SEO (meta titolo, meta descrizione, meta parole chiave)
- Scrittura: Aggiorna le descrizioni dei prodotti, le descrizioni brevi e i campi SEO con pieno supporto multilingue
Ordini (solo lettura)
- Cerca un ordine per il suo numero di riferimento
- Elenca gli ordini per un cliente specifico (per email)
- Ottieni l'ordine più recente per un cliente
Dettagli Ordine (solo lettura)
- Visualizza i prodotti all'interno di un ordine: nome, riferimento, quantità, prezzo unitario
Stati Ordine (solo lettura)
- Recupera l'etichetta leggibile dall'uomo per ciascuno stato dell'ordine (ad es., "Pagamento accettato", "Spedito")
Storie Ordine (lettura + creazione)
- Lettura: Visualizza la cronologia delle modifiche di stato di un ordine
- Creazione: Aggiungi un nuovo cambiamento di stato a un ordine (ad es., contrassegna come spedito), con notifica email opzionale al cliente
Clienti (lettura + scrittura)
- Lettura: Cerca un cliente per email o ID — recupera nome, email, data di registrazione, stato della newsletter, note
- Scrittura: Aggiorna le informazioni sui clienti (nome, cognome, email, note)
Lingue (solo lettura)
- Elenca tutte le lingue configurate nel tuo negozio (utilizzate per aggiornamenti di prodotto multilingue)
5. Inserire la chiave API in AI SmartTalk
Una volta che la tua chiave Webservice è stata creata e configurata:
- Vai alla configurazione del modulo AI SmartTalk in PrestaShop
- La chiave API viene tipicamente trasmessa durante la connessione OAuth
- Se hai bisogno di aggiornarla, vai al tuo dashboard di AI SmartTalk > Integrazione > PrestaShop e aggiorna il token del Webservice
Per configurazioni multi-sito, ogni sito può avere la propria chiave API del Webservice configurata in modo indipendente.
Prossimi passi
- Sincronizza i dati del tuo negozio — Invia il tuo catalogo prodotti all'AI
- Scopri cosa può fare l'AI — Riferimento completo delle azioni disponibili