Shopmonkey | ElevenLabs Documentation

Dzięki narzędziu webhook twój recepcjonista może dodać wizytę do kalendarza Shopmonkey, gdy osoba dzwoniąca chce przywieźć pojazd do serwisu.

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