> 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

Grâce à un [outil webhook](/docs/fr/reception-ai/integrations/webhooks), votre réceptionniste peut ajouter un rendez-vous à votre calendrier Shopmonkey lorsqu’un appelant souhaite amener son véhicule.

> **Warning**
>
> Shopmonkey ne vérifie pas les conflits lors de la création d’un rendez-vous de cette façon. Votre
> réceptionniste peut donc attribuer deux rendez-vous au même créneau. Indiquez aux appelants que l’horaire constitue une demande que votre atelier
> confirmera, ou donnez à votre réceptionniste vos horaires d’ouverture et les limites de capacité de vos baies dans ses instructions.

## Configuration

### Créer une clé API

Dans Shopmonkey, un administrateur ouvre **Settings** → **Integration** → **API Keys** et sélectionne **Get Started** ou **Add New Key**. Sélectionnez **Create API Key** et copiez immédiatement la clé : Shopmonkey ne l’affiche qu’une seule fois. La clé possède les mêmes autorisations que l’utilisateur qui la crée.

### Créer l’outil webhook

Dans Reception.ai, accédez à **Integrations**, sélectionnez **Add integration**, puis choisissez **Webhook Tool**.

| Champ                    | Valeur                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Nom**                  | `create_shopmonkey_appointment`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| **Description**          | "Ajoutez un rendez-vous au calendrier de l’atelier une fois que l’appelant a choisi un jour et une heure. Confirmez d’abord l’horaire avec lui."                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| **Méthode**              | POST                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| **URL**                  | `https://api.shopmonkey.cloud/v3/appointment`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| **En-têtes de requête**  | `Authorization`: `Bearer ` suivi de votre clé API                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| **Paramètres du corps**  | `name` (chaîne, obligatoire) : "Le service et le nom de l’appelant, par exemple : Vidange - Jane Doe."  `startDate` (chaîne, obligatoire) : "L’heure de début en UTC, au format ISO 8601, par exemple 2026-11-04T15:00:00.000Z."  `endDate` (chaîne, obligatoire) : "L’heure de fin au même format. Utilisez une heure après le début, sauf si le service de l’appelant dure plus longtemps."  `color` (chaîne, obligatoire) : "Toujours la valeur exacte `blue`."  `note` (chaîne, obligatoire) : "Le nom, le numéro de téléphone, l’année, la marque et le modèle du véhicule de l’appelant, ainsi que ses besoins." |
| **Attribuer aux agents** | **Réceptionniste**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |

Sélectionnez **Enable**.

### Tester

[Testez votre réceptionniste](/docs/fr/reception-ai/receptionist/testing) en réservant une vidange. Vérifiez que le rendez-vous apparaît dans votre calendrier Shopmonkey à la bonne heure locale.

`color` doit correspondre à l’une des valeurs suivantes : `aqua`, `black`, `blue`, `brown`, `gray`, `green`, `orange`, `purple`, `red` ou `yellow`. Utilisez une couleur que votre équipe n’emploie pas pour d’autres rendez-vous, afin que les réservations par téléphone se distinguent.

## Limites

* La recherche de clients de Shopmonkey nécessite une liste de numéros de téléphone que les outils webhook ne peuvent pas envoyer. Votre réceptionniste ne peut donc pas rechercher les appelants ni associer le rendez-vous à une fiche client ou véhicule. La note contient les coordonnées de l’appelant à la place.
* L’outil ne peut pas reporter ou annuler les rendez-vous. Ces opérations nécessitent l’ID du rendez-vous dans l’URL.

## Dépannage

| Problème                                             | Vérifications à effectuer                                                                                                                                     |
| ---------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Erreur 401 de Shopmonkey                             | L’en-tête doit être `Bearer ` suivi d’une clé valide, avec un espace après `Bearer`.                                                                          |
| Les rendez-vous sont créés à la mauvaise heure       | Les heures doivent être en UTC. Ajoutez le fuseau horaire de votre atelier aux instructions du réceptionniste afin qu’il effectue correctement la conversion. |
| Erreur 400 concernant `color`                        | Utilisez l’un des noms de couleur de Shopmonkey, en minuscules.                                                                                               |
| Le rendez-vous ne contient aucune information client | Veillez à ce que la description indique au réceptionniste de recueillir d’abord le nom, le numéro et les informations du véhicule de l’appelant.              |