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

# ServiceTitan

Twoja recepcjonistka może wyszukiwać dzwoniących w ServiceTitan, wysyłać nowe zlecenia jako rezerwacje do sprawdzenia przez osoby odbierające połączenia oraz informować obecnych klientów o terminie kolejnej wizyty. API ServiceTitan wymienia identyfikator klienta i sekret na krótkotrwałe tokeny, a także wymaga klucza aplikacji, czego narzędzia webhook nie obsługują, dlatego Reception łączy się przez [Zapier](/docs/pl/reception-ai/integrations/zapier).

## Zanim zaczniesz

Integracja ServiceTitan z Zapier jest w otwartej becie i ServiceTitan udostępnia ją w obecnej formie. Aby ją połączyć:

1. Administrator ServiceTitan przesyła formularz rejestracyjny Zapier ServiceTitan. ServiceTitan skontaktuje się z Tobą w sprawie kolejnych kroków.
2. W ServiceTitan przejdź do **Settings** → **Integrations** → **API Application Access**, wybierz **Connect New App** i wybierz **Zapier 3.0.X**.
3. Sprawdź zakresy, wybierz opcję **Booking Provider** i wybierz **Allow Access**.
4. Wygeneruj sekret klienta i skopiuj go wraz z identyfikatorem klienta oraz identyfikatorem tenanta.

> **Warning**
>
> Sekret klienta daje dostęp do danych ServiceTitan. Przechowuj go bezpiecznie i nikomu nie udostępniaj.

## Konfiguracja

### Połącz Zapier

Jeśli jeszcze tego nie zrobiono, połącz [Zapier](/docs/pl/reception-ai/integrations/zapier) w Reception.ai.

### Dodaj akcje ServiceTitan

Na serwerze MCP Zapier pod adresem [mcp.zapier.com](https://mcp.zapier.com) dodaj [akcje poniżej](#actions) z aplikacji **ServiceTitan (3.0.X)**. Aby się połączyć, wpisz identyfikator tenanta, identyfikator klienta i sekret klienta, a następnie wybierz środowisko produkcyjne. Dla każdego pola ustaw stałą wartość lub pozwól AI je uzupełnić, zgodnie z listą.

### Przypisz narzędzia

W Reception.ai otwórz kartę **Tools** integracji Zapier, wybierz **Refresh tools** i przypisz każdą akcję do **Client** (recepcjonistki).

### Przetestuj

[Przetestuj recepcjonistkę](/docs/pl/reception-ai/receptionist/testing) jako nowy dzwoniący, który potrzebuje naprawy. Rezerwacja pojawi się w ServiceTitan do sprawdzenia przez zespół.

## Akcje

### Znajdź dzwoniącego

| Pole                    | Wartość                                     |
| ----------------------- | ------------------------------------------- |
| **Akcja Zapier**        | **Search Customers**                        |
| **Ustaw w Zapier**      | Nic.                                        |
| **Pozwól AI uzupełnić** | **Phone** (numer dzwoniącego) lub **Name**. |
| **Przypisz do**         | **Client**                                  |

### Wyślij rezerwację

Rezerwacja to najbezpieczniejszy sposób przesyłania nowych zleceń. Osoby odbierające połączenia sprawdzają ją w ServiceTitan i zamieniają w zlecenie, więc recepcjonistka nigdy nie rezerwuje terminu bezpośrednio w Twoim harmonogramie dyspozycji.

| Pole                    | Wartość                                                                                                                                                                            |
| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Akcja Zapier**        | **Create Booking**                                                                                                                                                                 |
| **Ustaw w Zapier**      | **Booking Provider**, **Source** (na przykład `Reception`) oraz opcjonalnie **Business Unit**, **Job Type** i **Campaign**.                                                        |
| **Pozwól AI uzupełnić** | **Name**, **Summary** (problem, numer telefonu dzwoniącego i jego dostępność), **Is First Time Client**, adres usługi, **Start** (preferowany czas dzwoniącego) i **External Id**. |
| **Przypisz do**         | **Client**                                                                                                                                                                         |

**External Id** musi być unikalny dla każdej rezerwacji. Dodaj [procedurę](/docs/pl/reception-ai/receptionist/rules-and-procedures), która poleci recepcjonistce używać numeru telefonu dzwoniącego, a po nim bieżącej daty i godziny.

### Sprawdź wizyty klienta

| Pole                    | Wartość                                  |
| ----------------------- | ---------------------------------------- |
| **Akcja Zapier**        | **Search Appointments**                  |
| **Ustaw w Zapier**      | Nic.                                     |
| **Pozwól AI uzupełnić** | **Customer Id**, z **Search Customers**. |
| **Przypisz do**         | **Client**                               |

## Ograniczenia

* Aplikacja ServiceTitan w Zapier nie może sprawdzać przepustowości ani dostępności techników, więc czas w rezerwacji to preferencja dzwoniącego, a nie potwierdzony termin.
* **Create Job** i **Create Appointment** wymagają identyfikatorów lokalizacji, jednostki biznesowej, typu zlecenia i kampanii oraz rezerwują bezpośrednio w harmonogramie. Zostaw je osobom odbierającym połączenia.
* Integracja jest w otwartej becie i ServiceTitan oficjalnie jej nie wspiera.
* Każda akcja uruchomiona przez recepcjonistkę zużywa zadania z planu Zapier. Zapier obecnie liczy dwa zadania za każde udane wywołanie; nieudane wywołania nie są liczone. Gdy plan się wyczerpie, akcje zatrzymają się do jego odnowienia.

## Rozwiązywanie problemów

| Problem                                           | Co sprawdzić                                                                                                                   |
| ------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| Akcja ServiceTitan nie pojawia się w Reception.ai | Po dodaniu akcji w Zapier wybierz **Refresh tools** w integracji Zapier.                                                       |
| Akcja ma status **Changed** i nie jest używana    | Edytowano ją w Zapier. Wybierz **Update** na karcie **Tools**.                                                                 |
| Zapier nie może połączyć się z ServiceTitan       | Sprawdź, czy rejestracja została zatwierdzona oraz czy użyto identyfikatora klienta i sekretu 3.0.X, a nie starego klucza API. |
| Błąd `UniqueConstraint` przy rezerwacji           | **External Id** powtarza wcześniejszą rezerwację. Upewnij się, że zawiera datę i godzinę.                                      |
| Znani klienci nie są znajdowani                   | Spróbuj użyć imienia i nazwiska dzwoniącego oraz jego numeru telefonu.                                                         |