BigCommerce | ElevenLabs Documentation

Je receptionist kan de bestelling van een beller opzoeken in je BigCommerce-winkel en de status vertellen. Een webhook tool zoekt bestellingen op aan de hand van het e-mailadres van de klant via de BigCommerce Orders API.

Bestellingen bevatten namen, adressen, telefoonnummers en aankopen van klanten. Je receptionist moet bevestigen dat de beller de klant is voordat er iets wordt gedeeld. De onderstaande toolbeschrijving laat de receptionist zowel om het bestelnummer als om het e-mailadres bij de bestelling vragen, en alleen een bestelling bespreken wanneer beide overeenkomen.

Voordat je begint

Een alleen-lezen-API-account maken

Open in je BigCommerce-configuratiescherm Settings → Store-level API accounts en maak een API-account. Geef het een naam, zoals “Reception”, en stel het bereik Orders in op read-only, met elk ander bereik ingesteld op None. Je kunt bereiken later niet wijzigen.

De inloggegevens kopiëren

Sla het account op en kopieer de Access token en het API path. Het API-pad ziet er zo uit: https://api.bigcommerce.com/stores/STORE_HASH/v3/; het deel na /stores/ is je store hash. Behandel de access token als een geheim.

De webhook tool maken

Ga naar Integrations, selecteer Add integration en kies Webhook Tool.

Veld	Waarde
Name	`find_bigcommerce_order`
Description	”Zoek een bestelling op wanneer een beller ernaar vraagt. Vraag eerst om het bestelnummer en het e-mailadres bij de bestelling, en laat de beller het e-mailadres spellen. Deel alleen gegevens van een bestelling waarvan zowel het id als het factuuradres per e-mail overeenkomt met wat de beller zei. Zeg anders dat je de bestelling niet kunt vinden en bied aan terug te bellen.”
Method	GET
URL	`https://api.bigcommerce.com/stores/STORE_HASH/v2/orders`
Request Headers	`X-Auth-Token`: je access token `Accept`: `application/json`
Query Parameters	`email` (string, verplicht): “Het e-mailadres dat de beller gaf.” `sort` (string, verplicht): “Altijd exact de waarde `date_created:desc`.” `limit` (number, verplicht): “Altijd exact de waarde `5`.”
Assign to agents	Receptionist

De waarden sort en limit geven eerst de meest recente bestellingen van de klant terug, in plaats van de oudste.

Selecteer Enable en test vervolgens je receptionist met een testbestelling: vraag ernaar met het juiste bestelnummer en e-mailadres, daarna met een onjuist e-mailadres, en controleer of de tweede oproep geen gegevens oplevert.

De response bevat het factuuradres en de betaalgegevens van elke bestelling. Voeg een regel of procedure toe voor wat je receptionist telefonisch mag delen, bijvoorbeeld alleen de status en besteldatum.

Problemen oplossen

Probleem	Wat je moet controleren
BigCommerce geeft 401 terug	De header moet `X-Auth-Token` heten en de access token bevatten, niet de client-ID of client secret.
BigCommerce geeft 403 terug	Het API-account heeft niet het alleen-lezen-bereik Orders. Maak een nieuw account met dit bereik.
BigCommerce geeft 404 terug	Controleer de store hash in de URL en of de URL `/v2/orders` gebruikt.
De response is leeg	Geen bestelling heeft dat e-mailadres. Controleer of de beller het e-mailadres heeft gegeven dat bij het afrekenen is gebruikt.