Shopmonkey | ElevenLabs Documentation

Grâce à un outil webhook, votre réceptionniste peut ajouter un rendez-vous à votre calendrier Shopmonkey lorsqu’un appelant souhaite amener son véhicule.

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