ServiceM8 | ElevenLabs Documentation

Met de onderstaande webhooktools 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 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 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.