ServiceM8 | ElevenLabs Documentation

Dzięki poniższym narzędziom webhook 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ę, 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.

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.