> 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

Twój recepcjonista może wyszukać zamówienie dzwoniącego w sklepie BigCommerce i podać jego status. [Narzędzie webhook](/docs/pl/reception-ai/integrations/webhooks) wyszukuje zamówienia według adresu e-mail klienta przez BigCommerce Orders API.

> **Warning**
>
> Zamówienia zawierają imiona i nazwiska klientów, adresy, numery telefonów i zakupy. Recepcjonista musi
> potwierdzić, że dzwoniący jest klientem, zanim przekaże jakiekolwiek informacje. Opis narzędzia poniżej
> nakazuje poprosić zarówno o numer zamówienia, jak i adres e-mail z zamówienia, oraz omawiać zamówienie
> tylko wtedy, gdy oba się zgadzają.

## Zanim zaczniesz

### Utwórz konto API tylko do odczytu

W panelu BigCommerce otwórz **Settings** → **Store-level API accounts** i utwórz konto API. Nadaj mu nazwę, np. „Reception”, ustaw zakres **Orders** na **read-only**, a wszystkie pozostałe zakresy na **None**. Później nie możesz zmienić zakresów.

### Skopiuj dane dostępu

Zapisz konto i skopiuj **Access token** oraz **API path**. Ścieżka API wygląda tak: `https://api.bigcommerce.com/stores/STORE_HASH/v3/`; część po `/stores/` to hash Twojego sklepu. Traktuj token dostępu jako sekret.

## Utwórz narzędzie webhook

Przejdź do **Integrations**, wybierz **Add integration**, a następnie **Webhook Tool**.

| Pole                 | Wartość                                                                                                                                                                                                                                                                                                                                                                      |
| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Name**             | `find_bigcommerce_order`                                                                                                                                                                                                                                                                                                                                                     |
| **Description**      | „Wyszukaj zamówienie, gdy dzwoniący o nie pyta. Najpierw poproś o numer zamówienia i adres e-mail z zamówienia oraz poproś o przeliterowanie adresu e-mail. Udostępniaj szczegóły tylko wtedy, gdy identyfikator i e-mail rozliczeniowy zamówienia zgadzają się z tym, co podał dzwoniący. W przeciwnym razie powiedz, że nie możesz go znaleźć, i zaproponuj oddzwonienie.” |
| **Method**           | GET                                                                                                                                                                                                                                                                                                                                                                          |
| **URL**              | `https://api.bigcommerce.com/stores/STORE_HASH/v2/orders`                                                                                                                                                                                                                                                                                                                    |
| **Request Headers**  | `X-Auth-Token`: Twój token dostępu  `Accept`: `application/json`                                                                                                                                                                                                                                                                                                             |
| **Query Parameters** | `email` (ciąg znaków, wymagane): „Adres e-mail podany przez dzwoniącego.”  `sort` (ciąg znaków, wymagane): „Zawsze dokładna wartość `date_created:desc`.”  `limit` (liczba, wymagane): „Zawsze dokładna wartość `5`.”                                                                                                                                                        |
| **Assign to agents** | **Receptionist**                                                                                                                                                                                                                                                                                                                                                             |

Wartości `sort` i `limit` zwracają najpierw najnowsze zamówienia klienta, a nie najstarsze.

Wybierz **Enable**, a potem [przetestuj recepcjonistę](/docs/pl/reception-ai/receptionist/testing) na zamówieniu testowym: zapytaj o nie, podając właściwy numer zamówienia i e-mail, a następnie błędny e-mail, i sprawdź, czy w drugim połączeniu nie są podawane żadne szczegóły.

> **Tip**
>
> Odpowiedź zawiera adres rozliczeniowy i dane płatności każdego zamówienia. Dodaj [regułę lub procedurę](/docs/pl/reception-ai/receptionist/rules-and-procedures), która określi, co recepcjonista może
> przekazać przez telefon, na przykład tylko status i datę zamówienia.

## Rozwiązywanie problemów

| Problem                | Co sprawdzić                                                                                            |
| ---------------------- | ------------------------------------------------------------------------------------------------------- |
| BigCommerce zwraca 401 | Nagłówek musi nazywać się `X-Auth-Token` i zawierać token dostępu, a nie ID klienta ani sekret klienta. |
| BigCommerce zwraca 403 | Konto API nie ma zakresu **Orders** tylko do odczytu. Utwórz nowe konto z tym zakresem.                 |
| BigCommerce zwraca 404 | Sprawdź hash sklepu w adresie URL oraz czy URL używa `/v2/orders`.                                      |
| Odpowiedź jest pusta   | Żadne zamówienie nie ma tego adresu e-mail. Sprawdź, czy dzwoniący podał e-mail użyty przy zakupie.     |