Shopmonkey | ElevenLabs Documentation

Con uno strumento webhook, il tuo receptionist può aggiungere un appuntamento al tuo calendario Shopmonkey quando chi chiama vuole portare il proprio veicolo in officina.

Shopmonkey non controlla i conflitti quando un appuntamento viene creato in questo modo, quindi il tuo receptionist può prenotare due volte la stessa fascia oraria. Comunica a chi chiama che l’orario è una richiesta che la tua officina confermerà, oppure indica al tuo receptionist gli orari di apertura e i limiti delle postazioni nelle sue istruzioni.

Configurazione

Crea una chiave API

In Shopmonkey, un amministratore apre Settings → Integration → API Keys e seleziona Get Started oppure Add New Key. Seleziona Create API Key e copia subito la chiave: Shopmonkey la mostra una sola volta. La chiave ha le stesse autorizzazioni dell’utente che la crea.

Crea lo strumento webhook

In Reception.ai, vai su Integrations, seleziona Add integration e scegli Webhook Tool.

Campo	Valore
Nome	`create_shopmonkey_appointment`
Descrizione	”Aggiungi un appuntamento al calendario dell’officina dopo che chi chiama ha scelto giorno e ora. Prima conferma l’orario con la persona.”
Metodo	POST
URL	`https://api.shopmonkey.cloud/v3/appointment`
Request Headers	`Authorization`: `Bearer` seguito dalla tua chiave API
Body Parameters	`name` (string, obbligatorio): “Il servizio e il nome di chi chiama, ad esempio: Cambio dell’olio - Jane Doe.” `startDate` (string, obbligatorio): “L’orario di inizio in UTC, in formato ISO 8601, ad esempio 2026-11-04T15:00:00.000Z.” `endDate` (string, obbligatorio): “L’orario di fine nello stesso formato. Usa un’ora dopo l’inizio, a meno che il servizio richiesto non duri di più.” `color` (string, obbligatorio): “Usa sempre il valore esatto `blue`.” `note` (string, obbligatorio): “Il nome e il numero di telefono di chi chiama, anno, marca e modello del veicolo e ciò di cui ha bisogno.”
Assegna agli agenti	Receptionist

Seleziona Enable.

Provalo

Testa il tuo receptionist prenotando un cambio dell’olio. Controlla che l’appuntamento appaia nel tuo calendario Shopmonkey all’ora locale corretta.

color deve essere uno tra aqua, black, blue, brown, gray, green, orange, purple, red o yellow. Usa un colore che il tuo team non usa per altri appuntamenti, così le prenotazioni telefoniche risalteranno.

Limitazioni

La ricerca clienti di Shopmonkey richiede un elenco di numeri di telefono, che gli strumenti webhook non possono inviare. Di conseguenza, il tuo receptionist non può cercare chi chiama né collegare l’appuntamento a una scheda cliente o veicolo. La nota contiene invece i dettagli di chi chiama.
Lo strumento non può riprogrammare o annullare appuntamenti. Per farlo è necessario l’ID dell’appuntamento nell’URL.

Risoluzione dei problemi

Problema	Cosa controllare
401 da Shopmonkey	L’header deve essere `Bearer` seguito da una chiave valida, con uno spazio dopo `Bearer`.
Gli appuntamenti sono all’orario sbagliato	Gli orari devono essere in UTC. Aggiungi il fuso orario della tua officina alle istruzioni del receptionist affinché effettui la conversione correttamente.
400 relativo a `color`	Usa uno dei nomi dei colori di Shopmonkey, in minuscolo.
L’appuntamento non contiene i dettagli del cliente	Assicurati che la descrizione chieda al receptionist di raccogliere prima nome, numero e dati del veicolo di chi chiama.