Riferimento delle Azioni AI
Quando connesso con i corretti permessi API, il tuo assistente AI può eseguire le seguenti azioni sul tuo negozio PrestaShop in tempo reale. Queste azioni sono disponibili nei flussi di lavoro SmartFlow e possono essere utilizzate anche dall'AI durante le conversazioni con i tuoi clienti.
Prodotti
Ottieni Prodotto
Recupera i dettagli completi di un prodotto tramite il suo ID.
- Input: ID prodotto
- Restituisce: Nome, descrizione, descrizione breve, riferimento, prezzo, quantità in stock, stato attivo, campi SEO (meta titolo, meta descrizione, meta parole chiave)
- Permesso API:
products(GET)
Aggiorna Contenuto Prodotto
Aggiorna la descrizione e/o la descrizione breve di un prodotto, con pieno supporto multilingue.
- Inputs: ID prodotto, descrizione (opzionale), descrizione breve (opzionale), ID lingua (opzionale — predefinito alla lingua principale del negozio)
- Restituisce: Conferma con l'elenco dei campi aggiornati
- Permesso API:
products(GET + PUT)
L'AI preserva il contenuto in altre lingue quando aggiorna una lingua specifica. Ad esempio, aggiornare la descrizione francese non influenzerà la versione inglese.
Aggiorna SEO Prodotto
Aggiorna i campi SEO di un prodotto, con supporto multilingue.
- Inputs: ID prodotto, meta titolo (opzionale), meta descrizione (opzionale), meta parole chiave (opzionale), ID lingua (opzionale)
- Restituisce: Conferma con i valori SEO aggiornati
- Permesso API:
products(GET + PUT)
Ordini
Ottieni Ordine per Riferimento
Cerca un ordine specifico utilizzando il suo numero di riferimento (ad es., ABCDEF123).
- Input: Riferimento ordine
- Restituisce: Dettagli completi dell'ordine inclusi data, stato, importo totale, metodo di pagamento, informazioni di spedizione e elenco dei prodotti
- Permesso API:
orders(GET),order_details(GET),order_states(GET)
Ottieni Ordini per Email
Recupera tutti gli ordini effettuati da un cliente specifico.
- Inputs: Email cliente, limite (opzionale — predefinito a 10)
- Restituisce: Elenco di ordini con dettagli completi, conteggio totale
- Permesso API:
orders(GET),order_details(GET),order_states(GET),customers(GET)
Ottieni Ultimo Ordine
Ottieni l'ordine più recente per un cliente specifico.
- Input: Email cliente
- Restituisce: L'ultimo ordine con dettagli completi, o null se non sono stati trovati ordini
- Permesso API:
orders(GET),order_details(GET),order_states(GET),customers(GET)
Aggiorna Stato Ordine
Cambia lo stato di un ordine (ad es., contrassegna come spedito, contrassegna come consegnato).
- Inputs: ID ordine, nuovo ID stato ordine, invia notifica email (opzionale — predefinito a no)
- Restituisce: Conferma con il nuovo stato e se è stata inviata un'email
- Permesso API:
order_histories(GET + POST)
Cambiare lo stato di un ordine può attivare le notifiche email ai clienti se l'opzione sendEmail è abilitata. Assicurati che lo stato corretto venga applicato.
Clienti
Ottieni Cliente
Cerca un cliente tramite il suo indirizzo email.
- Input: Email cliente
- Restituisce: ID cliente, nome, cognome, email, data di nascita, stato newsletter, data di registrazione, note
- Permesso API:
customers(GET)
Aggiorna Cliente
Aggiorna le informazioni del profilo di un cliente.
- Inputs: ID cliente, nome (opzionale), cognome (opzionale), email (opzionale), note (opzionale)
- Restituisce: Conferma con l'elenco dei campi aggiornati
- Permesso API:
customers(GET + PUT)
Configurazione
Ottieni Lingue
Elenca tutte le lingue configurate nel tuo negozio PrestaShop.
- Nessun input richiesto
- Restituisce: Elenco delle lingue con ID, nome e codice ISO (ad es.,
fr,en,de) - Permesso API:
languages(GET)
Questa azione è utilizzata internamente dall'AI quando esegue aggiornamenti di prodotto multilingue, per garantire che venga utilizzato il corretto ID lingua.
Tabella di Riepilogo
| Azione | Categoria | Leggi | Scrivi |
|---|---|---|---|
| Ottieni Prodotto | Prodotti | Sì | — |
| Aggiorna Contenuto Prodotto | Prodotti | Sì | Sì |
| Aggiorna SEO Prodotto | Prodotti | Sì | Sì |
| Ottieni Ordine per Riferimento | Ordini | Sì | — |
| Ottieni Ordini per Email | Ordini | Sì | — |
| Ottieni Ultimo Ordine | Ordini | Sì | — |
| Aggiorna Stato Ordine | Ordini | — | Sì |
| Ottieni Cliente | Clienti | Sì | — |
| Aggiorna Cliente | Clienti | Sì | Sì |
| Ottieni Lingue | Config | Sì | — |
Correlati
- Permessi API — Configura i permessi Webservice richiesti
- Webhook & Competenze — Attiva queste azioni automaticamente sugli eventi del negozio