BigCommerce | ElevenLabs Documentation

Twój recepcjonista może wyszukać zamówienie dzwoniącego w sklepie BigCommerce i podać jego status. Narzędzie webhook wyszukuje zamówienia według adresu e-mail klienta przez BigCommerce Orders API.

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

Odpowiedź zawiera adres rozliczeniowy i dane płatności każdego zamówienia. Dodaj regułę lub procedurę, 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.