---
title: "Crea un agente AI di assistenza clienti che consulta gli ordini"
description: "Crea un agente AI di assistenza clienti che legge le domande sugli ordini in Gmail, cerca ogni ordine in Shopify o WooCommerce e prepara la risposta."
canonical: "https://aisa.one/it/solutions/ai-customer-support-agent"
---

# Crea un agente di assistenza che risponde alle email su dove si trova l'ordine

> Crea un agente AI di assistenza clienti che legge le domande sugli ordini in Gmail, cerca ogni ordine in Shopify o WooCommerce e prepara la risposta.

I commercianti collegano una volta Gmail e il negozio, il tuo agente trova le domande sugli ordini nella casella, cerca ogni ordine in Shopify o WooCommerce e prepara la risposta che una persona invierà.

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

## Quattro richieste dalla casella alla bozza di risposta

Ogni richiesta parte dal tuo server per un commerciante, quindi Gmail, Shopify e WooCommerce rispondono solo con i dati di quel commerciante.

### 1. Il commerciante collega Gmail

Crea una sessione di collegamento per il commerciante e apri il suo connectUrl. La schermata di consenso di Google si apre dalla pagina ospitata da AIsa, e tu interroghi la sessione finché non si conclude. Il negozio si collega con le credenziali, come nella pagina dell'agente Shopify.

```
curl "https://api.aisa.one/apis/v1/connector/connect/gmail?externalUserId=store_8812" \
  -H "Authorization: Bearer $AISA_API_KEY"
```

### 2. Trova le domande sugli ordini nella casella

gmail.search_threads accetta una query di ricerca Gmail e restituisce le conversazioni corrispondenti. Poi gmail.fetch_message_by_thread_id legge la conversazione completa.

```
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": "gmail.search_threads",
    "externalUserId": "store_8812",
    "input": {
      "query": "newer_than:1d (order OR delivery OR refund)",
      "maxResults": 20
    }
  }'
```

### 3. Cerca l'ordine nel negozio

Cerca in base all'indirizzo email del mittente: shopify.list_orders accetta una query email: e woocommerce.list_orders accetta un termine di ricerca.

Shopify:

```
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": 5,
      "query": "email:jane@example.com"
    }
  }'
```

WooCommerce:

```
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": "woocommerce.list_orders",
    "externalUserId": "store_8812",
    "input": {
      "search": "jane@example.com",
      "perPage": 5
    }
  }'
```

### 4. Registra la risposta sull'ordine

Il tuo agente prepara la risposta nel tuo prodotto e una persona la invia. Poi woocommerce.add_order_note lascia una nota privata sull'ordine, una scrittura che il commerciante approva prima.

```
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": "woocommerce.add_order_note",
    "externalUserId": "store_8812",
    "input": {
      "orderId": 1043,
      "note": "Customer asked where the order is. Reply drafted with the tracking link.",
      "customerNote": false
    }
  }'
```

## Fallo creare al tuo agente di programmazione

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

```text
Aggiungi la consultazione degli ordini alla nostra casella di assistenza 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.

1. Fai collegare Gmail al commerciante: chiama GET /connect/gmail con il suo ID come externalUserId, apri il connectUrl completo e interroga la sessione di collegamento finché non si conclude.
2. Fai collegare Shopify (POST /connect/shopify/credentials) o WooCommerce (POST /connect/woocommerce/credentials) con i campi richiesti da ogni app.
3. Ogni 15 minuti esegui gmail.search_threads per trovare nuove domande sugli ordini e leggi ogni conversazione con gmail.fetch_message_by_thread_id.
4. Cerca gli ordini del mittente con shopify.list_orders (una query email:) o woocommerce.list_orders (search).
5. Prepara nella nostra app una bozza di risposta con lo stato dell'ordine, che un operatore controlla e invia. Non inviare email.

Leggi l'inputSchema di ogni azione prima di scrivere le chiamate e mostrami prima il piano.
```

Il tuo agente di programmazione ti mostra un piano prima di scrivere il codice. Gmail si collega in sola lettura, quindi le risposte partono dal tuo prodotto o dal client di posta del commerciante.

## Domande sulla creazione di un agente AI di assistenza clienti

### Che cosa fa un agente AI di assistenza clienti?

Un agente AI di assistenza clienti legge i messaggi in arrivo dai clienti, trova nei tuoi sistemi le informazioni che servono e prepara o invia una risposta. Con AIsa Connect legge la Gmail del commerciante e cerca gli ordini nel suo negozio Shopify o WooCommerce.

### Può rispondere alle domande su dove si trova un ordine?

Sì. Abbina l'indirizzo email del mittente ai suoi ordini e legge lo stato di evasione di ognuno, così la bozza può dire se l'ordine è in attesa, spedito in parte o spedito.

### L'agente può inviare la risposta da Gmail?

Per ora no. Gmail si collega in sola lettura, quindi l'agente prepara la risposta nel tuo prodotto e una persona la invia da lì o da Gmail.

### Quali caselle e negozi può collegare un commerciante?

Gmail per la posta, e Shopify o WooCommerce per gli ordini, tutti verificati in produzione. La scheda Connettori mostra altre app di assistenza e di negozio con le loro azioni.

### L'agente di un commerciante può vedere le email di un altro?

No. Ogni Connection appartiene a un externalUserId, l'ID del commerciante nel tuo sistema, e un'esecuzione usa solo le Connection di quel commerciante.

### Quanto costa far funzionare un agente di assistenza?

Ogni esecuzione riuscita costa $0.0003, quindi cercare nella casella, leggere una conversazione e consultare un ordine costa circa $0.0009 per domanda. Collegare gli account è gratuito.

## Attività correlate

- [Crea un agente AI per Shopify](https://aisa.one/it/solutions/shopify-ai-agent.md): I commercianti collegano il negozio una volta, e il tuo agente legge ordini e scorte e aggiunge tag agli ordini con AIsa Connect. Per Sviluppatori di agenti e Venditori cross-border
- [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
