BigCommerce | ElevenLabs Documentation

Il tuo receptionist può cercare l’ordine di un chiamante nel tuo negozio BigCommerce e comunicarne lo stato. Uno strumento webhook trova gli ordini in base all’indirizzo email del cliente tramite l’API Orders di BigCommerce.

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

La risposta include l’indirizzo di fatturazione e i dettagli di pagamento di ogni ordine. Aggiungi una regola o procedura 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.