E-commerce e pagamenti
Shopify
Ordini, prodotti, clienti e scorte del negozio Shopify (sola lettura).
- Token o credenziali
- Sola lettura
Strumenti per l’agente
L’agente sceglie da solo lo strumento adatto alla domanda. Nella scheda MCP e database dell’agente puoi disattivare quelli che non servono.
| Strumento | Cosa fa | Tipo |
|---|---|---|
list_orders | Ordini del negozio con ricerca e filtri; tabella per grafici ed export. | Lettura |
list_products | Prodotti con prezzo, scorte e stato (ricerca Shopify, es. "title:*sedia* status:active"). | Lettura |
list_customers | Clienti con numero di ordini e spesa totale. | Lettura |
Configurazione passo per passo
In Kaiross apri Integrazioni, scegli Shopify e premi Nuova connessione. Il modulo mostra la stessa guida sotto Guida e permessi consigliati.
- Shopify Admin → Impostazioni → App e canali di vendita → Sviluppa app → Crea un’app.
- Configurazione Admin API: scope
read_orders,read_products,read_customers,read_inventory. - Installa l’app e copia l’Admin API access token (mostrato una sola volta).
Campi del modulo: Negozio.
Da incollare (cifrato nel Vault, poi non più visibile): Admin API access token.
Collegarla a un agente
- Apri Agenti, scegli l’agente e vai alla scheda MCP e database.
- In Aggiungi scegli Collega un’integrazione esistente e seleziona la connessione, oppure Dal catalogo per crearne una nuova (il pulsante diventa Salva e collega).
- Controlla gli Strumenti abilitati e, in Conferma delle azioni, quali azioni devono chiedere conferma.
- Premi Prova in chat e fai una domanda che richiede i dati del servizio.
Errori frequenti
- Credenziali non valide
- Controlla token, password o chiave API: spesso manca un carattere o il token è scaduto. Creane uno nuovo e aggiorna la connessione.
- Permessi insufficienti
- All’account o al token mancano i permessi necessari: confrontali con la configurazione qui sopra (Guida e permessi consigliati nell’app) e, se serve, crea un token nuovo.
- Troppe richieste
- Il servizio limita la frequenza delle chiamate: riprova tra qualche minuto.