Azioni Shopify
Collega un negozio Shopify così il tuo agente può cercare nel catalogo e verificare lo stato di un ordine in chat.
Collega un negozio Shopify al tuo agente e potrà rispondere alle domande sui prodotti usando il tuo catalogo live e verificare lo stato di un ordine durante una conversazione. Questo è separato dall'inserire il widget della chat sul tuo storefront — vedi Embed Shopify per quello.
Collega Prima il Tuo Negozio
Entrambe le azioni richiedono un negozio collegato.
- Vai alla scheda Azioni del tuo agente
- Apri Integrazioni e trova la scheda Shopify
- Inserisci il dominio del tuo negozio nel formato
store-name.myshopify.com - Completa la schermata di consenso di Shopify
La scheda mostra quindi lo stato della connessione e ti permette di Riconnetti o Disconnetti. Se la connessione richiede attenzione, appare un banner ambra con un invito a riconnetterti.
La connessione è per singolo agente. Ogni agente collega il proprio negozio, quindi un agente che deve rispondere per un negozio diverso ottiene una propria connessione invece di condividerne una.
Quale Accesso Viene Richiesto
Nella schermata di consenso, Agentkit richiede esattamente due scope di lettura:
| Scope | Utilizzato per |
|---|---|
read_products | Cercare nel tuo catalogo |
read_orders | Verificare lo stato di un ordine |
Non viene richiesto nessuno scope di scrittura. La connessione usa inoltre il token offline predefinito di Shopify — la richiesta omette deliberatamente l'opzione di concessione per singolo utente — così l'agente continua a funzionare anche dopo che la persona che ha collegato il negozio effettua il logout.
Questi sono gli scope richiesti dall'implementazione attuale. Shopify decide separatamente quali dati un'app può ricevere: alcuni campi di clienti e ordini sono protetti, e ottenere read_orders non garantisce di per sé che ogni campo venga restituito.
Le Due Azioni
Ogni azione viene aggiunta e configurata separatamente in Azioni.
Cerca prodotti
Permette all'agente di cercare nel catalogo del negozio collegato quando un visitatore chiede informazioni su prodotti, prezzi o disponibilità. Può restringere i risultati per query, un prezzo massimo facoltativo e un limite di risultati.
I risultati includono solo i prodotti attivi pubblicati nel tuo negozio online. La disponibilità deriva dall'inventario complessivo del prodotto in Shopify e include i prodotti per cui l'inventario non viene monitorato.
L'istruzione predefinita "quando usarla" è "Use when the user wants to find products, compare prices, or check whether an item is available." Modificala per adattarla a come i tuoi visitatori formulano le domande.
Verifica stato ordine
Verifica lo stato di un singolo ordine. Il visitatore deve fornire sia il numero d'ordine sia l'email di checkout, ed entrambi devono corrispondere allo stesso ordine prima che venga restituito qualcosa.
Questo abbinamento è una misura di privacy: un numero d'ordine da solo è facile da indovinare o intercettare, quindi non è mai sufficiente. Se l'ordine non esiste, o l'email non corrisponde all'ordine, l'agente riceve la stessa risposta generica "We could not find an order matching those details." — non può stabilire quale dei due fosse sbagliato, e non può farlo nemmeno il visitatore.
Gli ordini più vecchi possono restituire la stessa risposta "non trovato" anche quando numero ed email sono corretti: Agentkit richiede lo scope standard read_orders di Shopify, che copre gli ordini recenti del negozio (all'incirca gli ultimi 60 giorni), non lo storico completo degli ordini, approvato separatamente. Se le ricerche su ordini storici sono importanti per il tuo negozio, aspettati di dover indirizzare i visitatori con ordini più vecchi al tuo canale di supporto.
L'istruzione predefinita "quando usarla" è "Use when the user asks for an order status or tracking details and can provide the order number and checkout email."
Due Condizioni per Attivare un'Azione
Entrambe devono essere vere prima che un'azione possa essere attivata:
- Un negozio collegato - senza di esso, l'interruttore di attivazione mostra un avviso in linea che rimanda a Azioni > Integrazioni
- Un piano a pagamento - lo stesso requisito di API Personalizzata, Ricerca Web, Leggi i link ai documenti e le azioni di prenotazione
Puoi comunque creare, modificare e salvare entrambe le azioni mentre sono disattivate, anche senza nessuno dei due prerequisiti. Le condizioni si applicano solo all'attivazione.
Risoluzione dei Problemi
OAuth completato, ma la ricerca ordini non restituisce nulla. Controlla il formato del numero d'ordine usato dal tuo negozio e conferma che l'email con cui stai facendo il test sia l'email di checkout di quell'ordine. Poi verifica l'idoneità dell'app all'accesso ai dati protetti di clienti e ordini sul negozio — l'accesso a quei dati deve essere necessario per l'app e può essere limitato da Shopify. Richiedere scope più ampi non cambia questo, e riconnettersi non garantisce l'approvazione.
L'agente risponde usando i contenuti di addestramento invece del catalogo. Affina l'istruzione "quando usarla" in modo che le domande su prodotti, prezzi e disponibilità vengano indirizzate chiaramente all'azione di ricerca.
La scheda mostra un avviso di riconnessione. L'autorizzazione salvata non è più utilizzabile. Clicca su Riconnetti e completa di nuovo la schermata di consenso. La riconnessione ripristina la connessione ma non le azioni: quando l'autorizzazione salvata smette di funzionare, entrambe le azioni Shopify vengono disattivate automaticamente, e la schermata di consenso non le riattiva. Dopo la riconnessione, torna su Azioni e riattiva ogni azione che vuoi mantenere attiva.