> 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

Met de onderstaande [webhooktools](/docs/nl/reception-ai/integrations/webhooks) kan je receptionist een offerte of opdracht maken in ServiceM8 wanneer een beller werk wil laten uitvoeren, en nieuwe bellers als klanten toevoegen.

## Voordat je begint

Open in ServiceM8 **Settings** → **API Keys** en maak een sleutel. Elke onderstaande tool verstuurt deze in de requestheader `X-Api-Key`. Iedereen met de sleutel kan je ServiceM8-gegevens lezen en wijzigen, dus bewaar deze niet in gedeelde documenten.

## De tools maken

Ga voor elke tool naar **Integrations**, selecteer **Add integration**, kies **Webhook Tool** en stel **Assign to agents** in op **Receptionist**.

### Een opdracht maken

| Veld                | Waarde                                                                                                                                                                                                                                                                                                                    |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Naam**            | `create_servicem8_job`                                                                                                                                                                                                                                                                                                    |
| **Beschrijving**    | "Maak een opdracht wanneer een beller werk wil laten uitvoeren of een offerte wil."                                                                                                                                                                                                                                       |
| **Methode**         | POST                                                                                                                                                                                                                                                                                                                      |
| **URL**             | `https://api.servicem8.com/api_1.0/job.json`                                                                                                                                                                                                                                                                              |
| **Request Headers** | `X-Api-Key`: je API-sleutel                                                                                                                                                                                                                                                                                               |
| **Body Parameters** | `status` (string, verplicht): "Altijd exact de waarde `Quote`."  `job_address` (string, verplicht): "Het volledige adres waar het werk nodig is, inclusief postcode."  `job_description` (string, verplicht): "De naam en het telefoonnummer van de beller, gevolgd door wat er moet gebeuren en alle opgegeven details." |

Gebruik `Work Order` in plaats van `Quote` als gesprekken direct naar gepland werk moeten gaan.

### Een nieuwe klant toevoegen

| Veld                | Waarde                                                                                                                                               |
| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Naam**            | `create_servicem8_client`                                                                                                                            |
| **Beschrijving**    | "Voeg de beller als nieuwe klant toe wanneer die zegt ons nog niet eerder te hebben gebruikt."                                                       |
| **Methode**         | POST                                                                                                                                                 |
| **URL**             | `https://api.servicem8.com/api_1.0/company.json`                                                                                                     |
| **Request Headers** | `X-Api-Key`: je API-sleutel                                                                                                                          |
| **Body Parameters** | `name` (string, verplicht): "De volledige naam van de beller of de bedrijfsnaam."  `address` (string): "Het adres van de klant, inclusief postcode." |

Selecteer **Enable** voor elke tool en [test je receptionist](/docs/nl/reception-ai/receptionist/testing) door om een offerte te vragen. De nieuwe offerte verschijnt in ServiceM8.

## Beperkingen

* ServiceM8 antwoordt op beide tools alleen met `OK`. De ID van het nieuwe record staat in een responseheader die je receptionist niet kan lezen, dus de opdracht kan niet aan de klant worden gekoppeld. Je team koppelt ze in ServiceM8.
* ServiceM8 slaat telefoonnummers en e-mailadressen op in de contacten van een klant, een afzonderlijk record dat de klanttool niet kan maken. De opdrachtbeschrijving bevat daarom het nummer van de beller.
* Zoeken naar een bestaande klant vereist een parameter `$filter`, en namen van parameters voor webhooktools kunnen geen `$` bevatten. Daarom kan je receptionist bellers niet opzoeken.

Gebruik de acties **Create Client** en **Create Job** van ServiceM8 via [Zapier](/docs/nl/reception-ai/integrations/zapier) om gekoppelde klanten en opdrachten te maken.

## Problemen oplossen

| Probleem                     | Wat je moet controleren                                                                                                |
| ---------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| 401 van ServiceM8            | De header moet `X-Api-Key` heten en een huidige sleutel bevatten.                                                      |
| 400 over de status           | `status` moet exact `Quote`, `Work Order`, `Unsuccessful` of `Completed` zijn.                                         |
| De opdracht heeft geen adres | Zorg dat de beschrijving de receptionist vertelt om vóór het maken van de opdracht naar het volledige adres te vragen. |
| 429 van ServiceM8            | Je hebt de requestlimiet van ServiceM8 bereikt. Wacht een minuut en probeer het opnieuw.                               |