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

# Shopmonkey

Dzięki [narzędziu webhook](/docs/pl/reception-ai/integrations/webhooks) twój recepcjonista może dodać wizytę do kalendarza Shopmonkey, gdy osoba dzwoniąca chce przywieźć pojazd do serwisu.

> **Warning**
>
> Shopmonkey nie sprawdza konfliktów, gdy wizyta jest tworzona w ten sposób, więc twój
> recepcjonista może zarezerwować ten sam termin dwukrotnie. Powiedz dzwoniącym osobom, że termin jest prośbą,
> którą serwis potwierdzi, albo podaj recepcjoniście godziny otwarcia i limit stanowisk w jego instrukcjach.

## Konfiguracja

### Utwórz klucz API

W Shopmonkey administrator otwiera **Settings** → **Integration** → **API Keys** i wybiera **Get Started** lub **Add New Key**. Wybierz **Create API Key** i od razu skopiuj klucz: Shopmonkey wyświetla go tylko raz. Klucz ma te same uprawnienia co użytkownik, który go tworzy.

### Utwórz narzędzie webhook

W Reception.ai przejdź do **Integrations**, wybierz **Add integration**, a następnie **Webhook Tool**.

| Pole                    | Wartość                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Nazwa**               | `create_shopmonkey_appointment`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| **Opis**                | "Dodaj wizytę do kalendarza serwisu, gdy osoba dzwoniąca wybierze dzień i godzinę. Najpierw potwierdź z nią godzinę."                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| **Metoda**              | POST                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| **URL**                 | `https://api.shopmonkey.cloud/v3/appointment`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| **Nagłówki żądania**    | `Authorization`: `Bearer `, a potem twój klucz API                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| **Parametry body**      | `name` (string, wymagane): "Usługa i imię oraz nazwisko osoby dzwoniącej, na przykład: Wymiana oleju - Jan Kowalski."  `startDate` (string, wymagane): "Godzina rozpoczęcia w UTC, w formacie ISO 8601, na przykład 2026-11-04T15:00:00.000Z."  `endDate` (string, wymagane): "Godzina zakończenia w tym samym formacie. Ustaw godzinę po rozpoczęciu, chyba że usługa dzwoniącej osoby trwa dłużej."  `color` (string, wymagane): "Zawsze dokładna wartość `blue`."  `note` (string, wymagane): "Imię i nazwisko osoby dzwoniącej, numer telefonu, rok produkcji, marka i model pojazdu oraz potrzebna usługa." |
| **Przypisz do agentów** | **Receptionist**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |

Wybierz **Enable**.

### Przetestuj

[Przetestuj recepcjonistę](/docs/pl/reception-ai/receptionist/testing), rezerwując wymianę oleju. Sprawdź, czy wizyta pojawia się w kalendarzu Shopmonkey o prawidłowej lokalnej godzinie.

`color` musi mieć jedną z wartości: `aqua`, `black`, `blue`, `brown`, `gray`, `green`, `orange`, `purple`, `red` lub `yellow`. Użyj koloru, którego zespół nie stosuje do innych wizyt, aby rezerwacje telefoniczne się wyróżniały.

## Ograniczenia

* Wyszukiwanie klientów w Shopmonkey przyjmuje listę numerów telefonów, których narzędzia webhook nie mogą wysyłać. Dlatego recepcjonista nie może wyszukiwać osób dzwoniących ani łączyć wizyty z kartą klienta lub pojazdu. Zamiast tego dane dzwoniącej osoby są w notatce.
* Narzędzie nie może przekładać ani odwoływać wizyt. Wymaga to identyfikatora wizyty w adresie URL.

## Rozwiązywanie problemów

| Problem                           | Co sprawdzić                                                                                                          |
| --------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| 401 z Shopmonkey                  | Nagłówek musi zawierać `Bearer `, a po nim aktualny klucz, ze spacją po `Bearer`.                                     |
| Wizyty są o niewłaściwej godzinie | Godziny muszą być w UTC. Dodaj strefę czasową serwisu do instrukcji recepcjonisty, aby poprawnie je przeliczał.       |
| 400 dotyczący `color`             | Użyj jednej z nazw kolorów Shopmonkey, małymi literami.                                                               |
| Wizyta nie ma danych klienta      | Dopilnuj, by opis nakazywał recepcjoniście najpierw zebrać imię i nazwisko, numer oraz dane pojazdu osoby dzwoniącej. |