ServiceM8 | ElevenLabs Documentation

Med webhook-verktygen nedan kan din receptionist skapa en offert eller ett jobb i ServiceM8 när en uppringare behöver få arbete utfört, och lägga till nya uppringare som kunder.

Innan du börjar

I ServiceM8 öppnar du Settings → API Keys och skapar en nyckel. Alla verktyg nedan skickar den i begärandehuvudet X-Api-Key. Alla som har nyckeln kan läsa och ändra dina ServiceM8-data, så förvara den utanför delade dokument.

Skapa verktygen

För varje verktyg går du till Integrations, väljer Add integration, väljer Webhook Tool och anger Assign to agents till Receptionist.

Skapa ett jobb

Fält	Värde
Namn	`create_servicem8_job`
Beskrivning	”Skapa ett jobb när en uppringare behöver få arbete utfört eller vill ha en offert.”
Metod	POST
URL	`https://api.servicem8.com/api_1.0/job.json`
Begärandehuvuden	`X-Api-Key`: din API-nyckel
Brödtextparametrar	`status` (sträng, obligatoriskt): “Alltid exakt värdet `Quote`.” `job_address` (sträng, obligatoriskt): “Den fullständiga adressen där arbetet behövs, inklusive postnummer.” `job_description` (sträng, obligatoriskt): “Uppringarens namn och telefonnummer, följt av vad de behöver få gjort och eventuella uppgifter de har angett.”

Använd Work Order i stället för Quote om samtal ska gå direkt till planerat arbete.

Lägg till en ny kund

Fält	Värde
Namn	`create_servicem8_client`
Beskrivning	”Lägg till uppringaren som en ny kund när personen säger att den inte har anlitat oss tidigare.”
Metod	POST
URL	`https://api.servicem8.com/api_1.0/company.json`
Begärandehuvuden	`X-Api-Key`: din API-nyckel
Brödtextparametrar	`name` (sträng, obligatoriskt): “Uppringarens fullständiga namn eller företagsnamn.” `address` (sträng): “Kundens adress, inklusive postnummer.”

Välj Enable för varje verktyg och testa sedan din receptionist genom att be om en offert. Den nya offerten visas i ServiceM8.

Begränsningar

ServiceM8 svarar på båda verktygen med endast OK. Den nya postens ID finns i ett svarshuvud som din receptionist inte kan läsa, så den kan inte länka jobbet till kunden. Ditt team länkar dem i ServiceM8.
ServiceM8 lagrar telefonnummer och e-postadresser i en kunds kontakter, en separat post som kundverktyget inte kan skapa. Jobbbeskrivningen innehåller i stället uppringarens nummer.
För att söka efter en befintlig kund krävs parametern $filter, och namn på webhook-verktygsparametrar kan inte innehålla $, så din receptionist kan inte söka upp uppringare.

För att skapa länkade kunder och jobb använder du ServiceM8:s åtgärder Create Client och Create Job via Zapier.

Felsökning

Problem	Vad du ska kontrollera
401 från ServiceM8	Huvudet måste heta `X-Api-Key` och innehålla en aktuell nyckel.
400 om statusen	`status` måste vara exakt `Quote`, `Work Order`, `Unsuccessful` eller `Completed`.
Jobbet saknar adress	Se till att beskrivningen säger åt receptionisten att fråga efter den fullständiga adressen innan jobbet skapas.
429 från ServiceM8	Du har nått ServiceM8:s gräns för begäranden. Vänta en minut och försök igen.