> 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

Con gli [strumenti webhook](/docs/it/reception-ai/integrations/webhooks) qui sotto, la tua receptionist può creare un preventivo o un lavoro in ServiceM8 quando un chiamante ha bisogno di un intervento e aggiungere nuovi chiamanti come clienti.

## Prima di iniziare

In ServiceM8, apri **Settings** → **API Keys** e crea una chiave. Ogni strumento qui sotto la invia nell'header della richiesta `X-Api-Key`. Chiunque disponga della chiave può leggere e modificare i tuoi dati ServiceM8, quindi non inserirla in documenti condivisi.

## Crea gli strumenti

Per ogni strumento, vai su **Integrations**, seleziona **Add integration**, scegli **Webhook Tool** e imposta **Assign to agents** su **Receptionist**.

### Crea un lavoro

| Campo                      | Valore                                                                                                                                                                                                                                                                                                                                                  |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Nome**                   | `create_servicem8_job`                                                                                                                                                                                                                                                                                                                                  |
| **Descrizione**            | "Crea un lavoro quando un chiamante ha bisogno di un intervento o desidera un preventivo."                                                                                                                                                                                                                                                              |
| **Metodo**                 | POST                                                                                                                                                                                                                                                                                                                                                    |
| **URL**                    | `https://api.servicem8.com/api_1.0/job.json`                                                                                                                                                                                                                                                                                                            |
| **Header della richiesta** | `X-Api-Key`: la tua chiave API                                                                                                                                                                                                                                                                                                                          |
| **Parametri del body**     | `status` (string, obbligatorio): "Sempre il valore esatto `Quote`."  `job_address` (string, obbligatorio): "L'indirizzo completo in cui è necessario l'intervento, incluso il codice postale."  `job_description` (string, obbligatorio): "Il nome e il numero di telefono del chiamante, quindi ciò che deve essere fatto e tutti i dettagli forniti." |

Usa `Work Order` invece di `Quote` se le chiamate devono passare direttamente a lavori programmati.

### Aggiungi un nuovo cliente

| Campo                      | Valore                                                                                                                                                                  |
| -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Nome**                   | `create_servicem8_client`                                                                                                                                               |
| **Descrizione**            | "Aggiungi il chiamante come nuovo cliente se dice di non averci mai usato prima."                                                                                       |
| **Metodo**                 | POST                                                                                                                                                                    |
| **URL**                    | `https://api.servicem8.com/api_1.0/company.json`                                                                                                                        |
| **Header della richiesta** | `X-Api-Key`: la tua chiave API                                                                                                                                          |
| **Parametri del body**     | `name` (string, obbligatorio): "Il nome completo del chiamante o il nome della sua azienda."  `address` (string): "L'indirizzo del cliente, incluso il codice postale." |

Seleziona **Enable** su ogni strumento, poi [testa la tua receptionist](/docs/it/reception-ai/receptionist/testing) chiedendo un preventivo. Il nuovo preventivo comparirà in ServiceM8.

## Limitazioni

* ServiceM8 risponde a entrambi gli strumenti soltanto con `OK`. L'ID del nuovo record si trova in un header della risposta che la tua receptionist non può leggere, quindi non può collegare il lavoro al cliente. Il tuo team li collega in ServiceM8.
* ServiceM8 conserva i numeri di telefono e le email nei contatti di un cliente, un record separato che lo strumento cliente non può creare. Il numero del chiamante viene invece conservato nella descrizione del lavoro.
* La ricerca di un cliente esistente richiede un parametro `$filter` e i nomi dei parametri degli strumenti webhook non possono contenere `$`, quindi la tua receptionist non può cercare i chiamanti.

Per creare clienti e lavori collegati, usa le azioni **Create Client** e **Create Job** di ServiceM8 tramite [Zapier](/docs/it/reception-ai/integrations/zapier).

## Risoluzione dei problemi

| Problema                   | Cosa verificare                                                                                                     |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| 401 da ServiceM8           | L'header deve chiamarsi `X-Api-Key` e contenere una chiave attuale.                                                 |
| 400 relativo allo stato    | `status` deve essere esattamente `Quote`, `Work Order`, `Unsuccessful` o `Completed`.                               |
| Il lavoro non ha indirizzo | Assicurati che la descrizione indichi alla receptionist di chiedere l'indirizzo completo prima di creare il lavoro. |
| 429 da ServiceM8           | Hai raggiunto il limite di richieste di ServiceM8. Attendi un minuto e riprova.                                     |