> 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.

# BigCommerce

Il tuo receptionist può cercare l'ordine di un chiamante nel tuo negozio BigCommerce e comunicarne lo stato. Uno [strumento webhook](/docs/it/reception-ai/integrations/webhooks) trova gli ordini in base all'indirizzo email del cliente tramite l'API Orders di BigCommerce.

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

## Prima di iniziare

### Crea un account API in sola lettura

Nel pannello di controllo BigCommerce, apri **Settings** → **Store-level API accounts** e crea un account API. Assegnagli un nome, ad esempio "Reception", e imposta l'ambito **Orders** su **read-only**, con ogni altro ambito impostato su **None**. Non potrai modificare gli ambiti in seguito.

### Copia le credenziali

Salva l'account e copia l'**Access token** e l'**API path**. L'API path ha un aspetto simile a `https://api.bigcommerce.com/stores/STORE_HASH/v3/`; la parte dopo `/stores/` è l'hash del tuo negozio. Tratta l'access token come un segreto.

## Crea lo strumento webhook

Vai a **Integrations**, seleziona **Add integration** e scegli **Webhook Tool**.

| Campo                | Valore                                                                                                                                                                                                                                                                                                                                                               |
| -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Name**             | `find_bigcommerce_order`                                                                                                                                                                                                                                                                                                                                             |
| **Description**      | "Cerca un ordine quando un chiamante lo richiede. Chiedi prima il numero dell'ordine e l'indirizzo email associato all'ordine e chiedi di scandire l'email. Condividi i dettagli solo di un ordine il cui ID e la cui email di fatturazione corrispondono entrambi a quanto detto dal chiamante. Altrimenti, di' che non riesci a trovarlo e proponi di richiamare." |
| **Method**           | GET                                                                                                                                                                                                                                                                                                                                                                  |
| **URL**              | `https://api.bigcommerce.com/stores/STORE_HASH/v2/orders`                                                                                                                                                                                                                                                                                                            |
| **Request Headers**  | `X-Auth-Token`: il tuo access token  `Accept`: `application/json`                                                                                                                                                                                                                                                                                                    |
| **Query Parameters** | `email` (string, obbligatorio): "L'indirizzo email fornito dal chiamante."  `sort` (string, obbligatorio): "Sempre l'esatto valore `date_created:desc`."  `limit` (number, obbligatorio): "Sempre l'esatto valore `5`."                                                                                                                                              |
| **Assign to agents** | **Receptionist**                                                                                                                                                                                                                                                                                                                                                     |

I valori `sort` e `limit` restituiscono prima gli ordini più recenti del cliente, anziché i più vecchi.

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

> **Tip**
>
> La risposta include l'indirizzo di fatturazione e i dettagli di pagamento di ogni ordine. Aggiungi una [regola o procedura](/docs/it/reception-ai/receptionist/rules-and-procedures) che specifichi cosa può condividere il tuo receptionist
> al telefono, ad esempio solo lo stato e la data dell'ordine.

## Risoluzione dei problemi

| Problema                    | Cosa verificare                                                                                         |
| --------------------------- | ------------------------------------------------------------------------------------------------------- |
| BigCommerce restituisce 401 | L'header deve chiamarsi `X-Auth-Token` e contenere l'access token, non il client ID o il client secret. |
| BigCommerce restituisce 403 | All'account API manca l'ambito **Orders** in sola lettura. Crea un nuovo account con questo ambito.     |
| BigCommerce restituisce 404 | Verifica l'hash del negozio nell'URL e che l'URL usi `/v2/orders`.                                      |
| La risposta è vuota         | Nessun ordine ha quell'email. Verifica che il chiamante abbia fornito l'email usata al checkout.        |