> 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.

# Shopmonkey

Con uno [strumento webhook](/docs/it/reception-ai/integrations/webhooks), il tuo receptionist può aggiungere un appuntamento al tuo calendario Shopmonkey quando chi chiama vuole portare il proprio veicolo in officina.

> **Warning**
>
> 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](/docs/it/reception-ai/receptionist/testing) 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.                                    |