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

# ServiceM8

Dzięki poniższym [narzędziom webhook](/docs/pl/reception-ai/integrations/webhooks) recepcjonistka może tworzyć wyceny lub zlecenia w ServiceM8, gdy dzwoniący potrzebuje wykonania pracy, oraz dodawać nowych dzwoniących jako klientów.

## Zanim zaczniesz

W ServiceM8 otwórz **Settings** → **API Keys** i utwórz klucz. Każde narzędzie poniżej wysyła go w nagłówku żądania `X-Api-Key`. Każdy, kto ma ten klucz, może odczytywać i zmieniać dane ServiceM8, więc nie umieszczaj go we współdzielonych dokumentach.

## Utwórz narzędzia

Dla każdego narzędzia przejdź do **Integrations**, wybierz **Add integration**, wybierz **Webhook Tool** i ustaw **Assign to agents** na **Receptionist**.

### Utwórz zlecenie

| Pole                | Wartość                                                                                                                                                                                                                                                                                                                                            |
| ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Name**            | `create_servicem8_job`                                                                                                                                                                                                                                                                                                                             |
| **Description**     | "Utwórz zlecenie, gdy dzwoniący potrzebuje wykonania pracy lub chce otrzymać wycenę."                                                                                                                                                                                                                                                              |
| **Method**          | POST                                                                                                                                                                                                                                                                                                                                               |
| **URL**             | `https://api.servicem8.com/api_1.0/job.json`                                                                                                                                                                                                                                                                                                       |
| **Request Headers** | `X-Api-Key`: Twój klucz API                                                                                                                                                                                                                                                                                                                        |
| **Body Parameters** | `status` (ciąg znaków, wymagane): "Zawsze dokładna wartość `Quote`."  `job_address` (ciąg znaków, wymagane): "Pełny adres, pod którym potrzebna jest praca, wraz z kodem pocztowym."  `job_description` (ciąg znaków, wymagane): "Imię i nazwisko oraz numer telefonu dzwoniącego, a następnie opis potrzebnej pracy i wszelkie podane szczegóły." |

Użyj `Work Order` zamiast `Quote`, jeśli połączenia powinny od razu trafiać do zaplanowanej pracy.

### Dodaj nowego klienta

| Pole                | Wartość                                                                                                                                                     |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Name**            | `create_servicem8_client`                                                                                                                                   |
| **Description**     | "Dodaj dzwoniącego jako nowego klienta, gdy mówi, że wcześniej z nas nie korzystał."                                                                        |
| **Method**          | POST                                                                                                                                                        |
| **URL**             | `https://api.servicem8.com/api_1.0/company.json`                                                                                                            |
| **Request Headers** | `X-Api-Key`: Twój klucz API                                                                                                                                 |
| **Body Parameters** | `name` (ciąg znaków, wymagane): "Pełne imię i nazwisko dzwoniącego lub nazwa jego firmy."  `address` (ciąg znaków): "Adres klienta wraz z kodem pocztowym." |

Wybierz **Enable** przy każdym narzędziu, a następnie [przetestuj recepcjonistkę](/docs/pl/reception-ai/receptionist/testing), prosząc o wycenę. Nowa wycena pojawi się w ServiceM8.

## Ograniczenia

* ServiceM8 odpowiada na oba narzędzia tylko `OK`. ID nowego rekordu znajduje się w nagłówku odpowiedzi, którego recepcjonistka nie może odczytać, więc nie może połączyć zlecenia z klientem. Twój zespół połączy je w ServiceM8.
* ServiceM8 przechowuje numery telefonów i e-maile w kontaktach klienta — osobnym rekordzie, którego narzędzie klienta nie może utworzyć. Numer dzwoniącego jest więc zapisywany w opisie zlecenia.
* Wyszukiwanie istniejącego klienta wymaga parametru `$filter`, a nazwy parametrów narzędzi webhook nie mogą zawierać `$`, więc recepcjonistka nie może wyszukiwać dzwoniących.

Aby tworzyć połączonych klientów i zlecenia, użyj akcji **Create Client** i **Create Job** ServiceM8 przez [Zapier](/docs/pl/reception-ai/integrations/zapier).

## Rozwiązywanie problemów

| Problem                | Co sprawdzić                                                                                |
| ---------------------- | ------------------------------------------------------------------------------------------- |
| 401 z ServiceM8        | Nagłówek musi nazywać się `X-Api-Key` i zawierać aktualny klucz.                            |
| 400 dotyczący statusu  | `status` musi mieć dokładnie wartość `Quote`, `Work Order`, `Unsuccessful` lub `Completed`. |
| Zlecenie nie ma adresu | Dopilnuj, aby opis polecał recepcjonistce zapytać o pełny adres przed utworzeniem zlecenia. |
| 429 z ServiceM8        | Osiągnięto limit żądań ServiceM8. Poczekaj minutę i spróbuj ponownie.                       |