> 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

Med [webhook-verktygen](/docs/sv/reception-ai/integrations/webhooks) 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](/docs/sv/reception-ai/receptionist/testing) 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](/docs/sv/reception-ai/integrations/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.                                    |