WooCommerce | ElevenLabs Documentation

La tua receptionist può cercare l’ordine di un chiamante nel tuo store WooCommerce e comunicarne lo stato. Uno strumento webhook cerca gli ordini del tuo store tramite la REST API di WooCommerce.

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:

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

La risposta include ogni campo di ciascun ordine, compresi gli indirizzi. Aggiungi una regola o procedura 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.