> 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

Je receptionist kan de bestelling van een beller opzoeken in je BigCommerce-winkel en de status vertellen. Een [webhook tool](/docs/nl/reception-ai/integrations/webhooks) zoekt bestellingen op aan de hand van het e-mailadres van de klant via de BigCommerce Orders API.

> **Warning**
>
> 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](/docs/nl/reception-ai/receptionist/testing) 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.

> **Tip**
>
> De response bevat het factuuradres en de betaalgegevens van elke bestelling. Voeg een [regel of procedure](/docs/nl/reception-ai/receptionist/rules-and-procedures) 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. |