---
title: "Crea un agente AI per Shopify per i tuoi commercianti"
description: "Crea un agente AI per Shopify che legge ordini e scorte di ogni commerciante e aggiunge tag agli ordini controllati, con AIsa Connect che gestisce ogni negozio."
canonical: "https://aisa.one/it/solutions/shopify-ai-agent"
---

# Crea un agente AI per Shopify che lavora nel negozio di ogni commerciante

> Crea un agente AI per Shopify che legge ordini e scorte di ogni commerciante e aggiunge tag agli ordini controllati, con AIsa Connect che gestisce ogni negozio.

I commercianti collegano il negozio con un token Admin API, il tuo agente legge gli ordini da evadere e le scorte, aggiunge tag agli ordini che ha controllato, e AIsa tiene separata la Connection di ogni negozio.

- Pagina web: https://aisa.one/it/solutions/shopify-ai-agent
- A chi è adatta: Sviluppatori di agenti e Venditori cross-border
- Dominio di dati: AIsa Connect
- Funziona con AIsa Connect: [AIsa Connect](https://aisa.one/it/products/connect)

## Quattro richieste dal negozio collegato agli ordini con tag

Ogni passaggio è una richiesta dal tuo server per il negozio fittizio store_8812, con i nomi dei campi presi dallo schema pubblicato di ogni azione.

### 1. Il commerciante collega il negozio

Raccogli nel tuo prodotto il token Admin API e il dominio myshopify.com del negozio e inoltrali una volta. AIsa controlla i campi, Shopify verifica il token e la Connection appartiene all'externalUserId di quel commerciante.

```
curl -X POST "https://api.aisa.one/apis/v1/connector/connect/shopify/credentials" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "externalUserId": "store_8812",
    "apiKey": "shpat_...",
    "credentials": {
      "shopDomain": "acme.myshopify.com"
    }
  }'
```

### 2. Leggi gli ordini che richiedono attenzione

shopify.list_orders accetta una query di ricerca Shopify, come gli ordini da evadere, e restituisce numero, stato di evasione, totale e cliente di ogni ordine.

```
curl -X POST "https://api.aisa.one/apis/v1/connector/actions/run" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "actionKey": "shopify.list_orders",
    "externalUserId": "store_8812",
    "input": {
      "first": 50,
      "query": "fulfillment_status:unfulfilled"
    }
  }'
```

### 3. Controlla le scorte prima di promettere una data

shopify.get_inventory_quantities restituisce la quantità disponibile di un articolo in una sede, così il tuo agente distingue un ordine in ritardo da uno senza scorte.

```
curl -X POST "https://api.aisa.one/apis/v1/connector/actions/run" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "actionKey": "shopify.get_inventory_quantities",
    "externalUserId": "store_8812",
    "input": {
      "inventoryItemId": "gid://shopify/InventoryItem/4410283321",
      "locationId": "gid://shopify/Location/7731205",
      "names": [
        "available"
      ]
    }
  }'
```

### 4. Aggiungi un tag agli ordini controllati dal tuo agente

shopify.add_tags scrive nel negozio, quindi chiedi conferma al commerciante prima di eseguirla. AIsa la invia una volta e, se l'esito è sconosciuto, controlla l'ordine in Shopify prima di eseguirla di nuovo.

```
curl -X POST "https://api.aisa.one/apis/v1/connector/actions/run" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "actionKey": "shopify.add_tags",
    "externalUserId": "store_8812",
    "input": {
      "id": "gid://shopify/Order/5829113872",
      "tags": [
        "agent-reviewed"
      ]
    }
  }'
```

## Fallo creare al tuo agente di programmazione

Incolla questo testo in Claude Code, Codex o Cursor nel repository del tuo prodotto, e tieni la chiave AIsa nell'ambiente del server.

```text
Aggiungi un agente Shopify a questa app con AIsa Connect (https://aisa.one/docs/resources/aisa-connect).

Leggi prima la guida. Chiama AIsa solo dal server con AISA_API_KEY dall'ambiente e non inviare mai la chiave al browser.

1. Aggiungi un modulo nelle impostazioni dove il commerciante inserisce il token Admin API di Shopify e il dominio myshopify.com. Inoltra entrambi a POST /connect/shopify/credentials con l'ID del commerciante come externalUserId, spiega ogni errore 400 con parole semplici e non salvare il token.
2. Aggiungi un job che esegue shopify.list_orders con la query fulfillment_status:unfulfilled per un commerciante ed elenca gli ordini.
3. Controlla le scorte degli articoli di ogni ordine con shopify.get_inventory_quantities.
4. Fai approvare un elenco al commerciante prima di qualsiasi esecuzione di shopify.add_tags. Tratta outcome_unknown come sconosciuto e controlla l'ordine prima di riprovare.

Leggi l'inputSchema di ogni azione da GET /apps/shopify/actions prima di scrivere le chiamate, e mostrami il piano prima di scrivere il codice.
```

Il tuo agente di programmazione ti mostra un piano prima di scrivere il codice. Prova con un negozio di sviluppo prima che un commerciante colleghi il suo.

## Domande sulla creazione di un agente AI per Shopify

### Che cos'è un agente AI per Shopify?

Un agente AI per Shopify è un software che legge e agisce nel negozio di un commerciante al posto suo, per esempio elencando gli ordini da evadere, controllando le scorte o aggiungendo tag agli ordini. Con AIsa Connect, ogni commerciante collega il proprio negozio e il tuo agente esegue azioni Shopify solo per lui.

### Devo pubblicare un'app Shopify?

No, se usi il token. Ogni commerciante crea un token di accesso Admin API nel proprio negozio e lo inserisce nel tuo prodotto, e AIsa esegue le chiamate con quel token.

### Come collega il negozio un commerciante?

Inserisce nel tuo prodotto il token di accesso Admin API, che inizia con shpat_, e il dominio myshopify.com del negozio. Tu li inoltri una volta: un campo mancante restituisce invalid_request e un token rifiutato restituisce connect_failed.

### Quali azioni Shopify può eseguire il mio agente?

Quasi 100, tra ordini, prodotti, scorte, clienti, bozze di ordine ed evasione. Ogni azione pubblica il proprio schema di input e indica se legge, scrive o elimina.

### L'agente può modificare ordini o prodotti?

Sì. Azioni come shopify.add_tags e shopify.update_product scrivono nel negozio, quindi chiedi conferma al commerciante prima di eseguirle. AIsa non ripete mai un'esecuzione da sola.

### Quanto costa far funzionare un agente Shopify?

Ogni esecuzione riuscita costa $0.0003 con qualsiasi piano, e quelle non riuscite sono gratuite. Collegare un negozio e gestire le Connection non costa nulla.

## Attività correlate

- [Crea un agente AI di assistenza clienti](https://aisa.one/it/solutions/ai-customer-support-agent.md): Leggi le domande sugli ordini dalla Gmail del commerciante, cerca ogni ordine nel negozio e prepara la risposta che una persona invierà. Per Sviluppatori di agenti e Team Enterprise
- [Automatizza i report e-commerce](https://aisa.one/it/solutions/ecommerce-reporting.md): Raccogli ogni settimana gli ordini e le campagne email di ogni commerciante e scrivi il report nel suo Notion. Per Sviluppatori di agenti e Agenzie di marketing
