ServiceM8 | ElevenLabs Documentation

Con gli strumenti webhook 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 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.

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.