> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# WooCommerce

La tua receptionist può cercare l'ordine di un chiamante nel tuo store WooCommerce e comunicarne lo stato. Uno [strumento webhook](/docs/it/reception-ai/integrations/webhooks) cerca gli ordini del tuo store tramite la REST API di WooCommerce.

> **Warning**
>
> Gli ordini contengono nomi, indirizzi, numeri di telefono e acquisti dei clienti. La tua receptionist deve
> confermare che il chiamante sia il cliente prima di condividere qualsiasi informazione. La descrizione dello strumento qui sotto le fa
> chiedere sia il numero dell'ordine sia l'indirizzo email associato all'ordine e discutere di un ordine solo quando
> entrambi corrispondono.

## Prima di iniziare

### Controlla le impostazioni del tuo store

Il tuo store deve usare HTTPS e i permalink semplici devono essere attivati: in WordPress, apri **Impostazioni** → **Permalink** e scegli un'opzione diversa da **Semplice**.

### Crea una chiave API di sola lettura

In WordPress, apri **WooCommerce** → **Impostazioni** → **Avanzate** → **REST API** e seleziona **Aggiungi chiave**. Inserisci una descrizione, ad esempio "Reception", scegli un utente, imposta **Permessi** su **Lettura** e seleziona **Genera chiave API**. Copia la **Consumer key** e il **Consumer secret**; il secret viene mostrato una sola volta.

### Crea il valore dell'header

WooCommerce autentica le chiavi con l'autenticazione HTTP Basic. Crea il valore dell'header sul tuo computer:

```bash
printf 'CONSUMER_KEY:CONSUMER_SECRET' | base64
```

## Crea lo strumento webhook

Vai a **Integrazioni**, seleziona **Aggiungi integrazione** e scegli **Strumento webhook**.

| Campo                      | Valore                                                                                                                                                                                                                                                                                                                                                                                                        |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Nome**                   | `find_woocommerce_order`                                                                                                                                                                                                                                                                                                                                                                                      |
| **Descrizione**            | "Cerca un ordine quando un chiamante chiede informazioni al riguardo. Per prima cosa chiedi il numero dell'ordine e l'indirizzo email associato all'ordine, e fai scandire l'indirizzo email. Condividi i dettagli solo di un ordine il cui numero e indirizzo email di fatturazione corrispondono entrambi a quanto detto dal chiamante. Altrimenti, di' che non riesci a trovarlo e proponi di richiamare." |
| **Metodo**                 | GET                                                                                                                                                                                                                                                                                                                                                                                                           |
| **URL**                    | `https://YOUR-STORE.com/wp-json/wc/v3/orders`                                                                                                                                                                                                                                                                                                                                                                 |
| **Header della richiesta** | `Authorization` impostato su `Basic ` seguito dal valore codificato                                                                                                                                                                                                                                                                                                                                           |
| **Parametri query**        | `search` (stringa, obbligatorio): "L'indirizzo email fornito dal chiamante."  `per_page` (numero, obbligatorio): "Sempre l'esatto valore `5`."                                                                                                                                                                                                                                                                |
| **Assegna agli agenti**    | **Receptionist**                                                                                                                                                                                                                                                                                                                                                                                              |

Seleziona **Abilita**, quindi [testa la tua receptionist](/docs/it/reception-ai/receptionist/testing) con un ordine di prova: chiedi informazioni usando il numero d'ordine e l'email corretti, poi con un'email errata, e verifica che la seconda chiamata non riceva alcun dettaglio.

> **Tip**
>
> La risposta include ogni campo di ciascun ordine, compresi gli indirizzi. Aggiungi una [regola o procedura](/docs/it/reception-ai/receptionist/rules-and-procedures) che specifichi ciò che la tua receptionist può
> condividere al telefono, ad esempio solo lo stato, la data dell'ordine e il numero di tracking.

## Risoluzione dei problemi

| Problema                                       | Cosa controllare                                                                                                                                         |
| ---------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| WooCommerce restituisce 401                    | Codifica di nuovo il valore dell'header. Alcuni host rimuovono l'header `Authorization` prima che WordPress lo riceva; chiedi al tuo host di inoltrarlo. |
| 404 `rest_no_route`                            | Controlla l'indirizzo dello store nell'URL e che i permalink non siano impostati su **Semplice**.                                                        |
| Gli ordini noti non vengono trovati            | La ricerca corrisponde ai dati di fatturazione memorizzati nell'ordine. Verifica che il chiamante abbia fornito l'email usata al checkout.               |
| Un firewall o un plugin di sicurezza lo blocca | Consenti le richieste a `/wp-json/wc/` nel plugin o nel firewall del tuo host.                                                                           |