> 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

Je receptionist kan bellers opzoeken in ServiceTitan, nieuw werk als boeking sturen zodat je medewerkers die gesprekken aannemen het kunnen beoordelen, en bestaande klanten vertellen wanneer hun volgende afspraak is. De API van ServiceTitan wisselt een client-ID en secret uit voor tokens met een korte geldigheid en vereist ook een app-sleutel. Dat kunnen webhooktools niet, dus Reception maakt verbinding via [Zapier](/docs/nl/reception-ai/integrations/zapier).

## Voordat je begint

De Zapier-integratie van ServiceTitan bevindt zich in open bèta en ServiceTitan biedt deze aan zoals deze is. Om verbinding te maken:

1. Een ServiceTitan-beheerder dient het Zapier-registratieformulier van ServiceTitan in. ServiceTitan neemt contact met je op over de volgende stappen.
2. Ga in ServiceTitan naar **Settings** → **Integrations** → **API Application Access**, selecteer **Connect New App** en kies **Zapier 3.0.X**.
3. Controleer de scopes, kies een optie voor **Booking Provider** en selecteer **Allow Access**.
4. Genereer een client secret en kopieer deze, samen met de client-ID en je tenant-ID.

> **Warning**
>
> De client secret geeft toegang tot je ServiceTitan-gegevens. Bewaar deze veilig en deel hem niet.

## Instellen

### Zapier verbinden

Als je dat nog niet hebt gedaan, verbind je [Zapier](/docs/nl/reception-ai/integrations/zapier) in Reception.ai.

### De ServiceTitan-acties toevoegen

Voeg in je Zapier MCP-server op [mcp.zapier.com](https://mcp.zapier.com) de [onderstaande acties](#actions) toe uit de app **ServiceTitan (3.0.X)**. Voer je tenant-ID, client-ID en client secret in om verbinding te maken, en kies de productieomgeving. Stel voor elk veld een vaste waarde in of laat de AI het invullen, zoals aangegeven.

### De tools toewijzen

Open in Reception.ai het tabblad **Tools** van de Zapier-integratie, selecteer **Refresh tools** en wijs elke actie toe aan de **Client** (receptionist).

### Testen

[Test je receptionist](/docs/nl/reception-ai/receptionist/testing) als een nieuwe beller die een reparatie nodig heeft. De boeking verschijnt in ServiceTitan zodat je team deze kan beoordelen.

## Acties

### De beller zoeken

| Veld                          | Waarde                                            |
| ----------------------------- | ------------------------------------------------- |
| **Zapier-actie**              | **Search Customers**                              |
| **Instellen in Zapier**       | Niets.                                            |
| **Door de AI laten invullen** | **Phone** (het nummer van de beller) of **Name**. |
| **Toewijzen aan**             | **Client**                                        |

### Een boeking versturen

Een boeking is de veiligste manier om nieuw werk te versturen. Je medewerkers die gesprekken aannemen beoordelen deze in ServiceTitan en zetten hem om in een opdracht, zodat je receptionist nooit rechtstreeks in je planningsbord boekt.

| Veld                          | Waarde                                                                                                                                                                                                                |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Zapier-actie**              | **Create Booking**                                                                                                                                                                                                    |
| **Instellen in Zapier**       | **Booking Provider**, **Source** (bijvoorbeeld `Reception`), en optioneel **Business Unit**, **Job Type** en **Campaign**.                                                                                            |
| **Door de AI laten invullen** | **Name**, **Summary** (het probleem, het telefoonnummer van de beller en wanneer die beschikbaar is), **Is First Time Client**, het serviceadres, **Start** (het gewenste tijdstip van de beller) en **External Id**. |
| **Toewijzen aan**             | **Client**                                                                                                                                                                                                            |

**External Id** moet uniek zijn voor elke boeking. Voeg een [procedure](/docs/nl/reception-ai/receptionist/rules-and-procedures) toe die je receptionist vertelt het telefoonnummer van de beller te gebruiken, gevolgd door de huidige datum en tijd.

### De afspraken van een klant controleren

| Veld                          | Waarde                                     |
| ----------------------------- | ------------------------------------------ |
| **Zapier-actie**              | **Search Appointments**                    |
| **Instellen in Zapier**       | Niets.                                     |
| **Door de AI laten invullen** | **Customer Id**, uit **Search Customers**. |
| **Toewijzen aan**             | **Client**                                 |

## Beperkingen

* De ServiceTitan-app van Zapier kan capaciteit of beschikbaarheid van monteurs niet controleren, dus de tijd op een boeking is de voorkeur van de beller en geen bevestigd tijdslot.
* **Create Job** en **Create Appointment** vereisen ID's voor de locatie, business unit, het opdrachttype en de campagne, en boeken rechtstreeks in je planning. Laat deze aan je medewerkers die gesprekken aannemen over.
* De integratie bevindt zich in open bèta en ServiceTitan ondersteunt deze niet officieel.
* Elke actie die je receptionist uitvoert, gebruikt taken uit je Zapier-abonnement. Zapier telt momenteel twee taken per geslaagde aanroep; mislukte aanroepen tellen niet mee. Als het abonnement op is, stoppen de acties totdat het wordt gereset.

## Problemen oplossen

| Probleem                                               | Wat je moet controleren                                                                                                   |
| ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------- |
| Een ServiceTitan-actie verschijnt niet in Reception.ai | Selecteer **Refresh tools** in de Zapier-integratie nadat je acties in Zapier hebt toegevoegd.                            |
| Een actie toont **Changed** en wordt niet gebruikt     | Je hebt deze in Zapier bewerkt. Selecteer **Update** op het tabblad **Tools**.                                            |
| Zapier kan geen verbinding maken met ServiceTitan      | Controleer of je registratie is goedgekeurd en of je een 3.0.X-client-ID en -secret hebt gebruikt, geen oude API-sleutel. |
| Fout `UniqueConstraint` bij een boeking                | **External Id** herhaalde een eerdere boeking. Zorg dat deze de datum en tijd bevat.                                      |
| Bekende klanten worden niet gevonden                   | Probeer naast het telefoonnummer ook de naam van de beller.                                                               |