> 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

Met een [webhooktool](/docs/nl/reception-ai/integrations/webhooks) kan je receptionist een afspraak toevoegen aan je Shopmonkey-agenda wanneer een beller een voertuig wil langsbrengen.

> **Warning**
>
> Shopmonkey controleert niet op conflicten wanneer een afspraak op deze manier wordt gemaakt, dus je
> receptionist kan een tijdslot dubbel boeken. Vertel bellers dat de tijd een verzoek is dat je garage
> zal bevestigen, of geef je receptionist de openingstijden en limieten voor werkplekken in de instructies.

## Instellen

### Een API-sleutel maken

In Shopmonkey opent een beheerder **Settings** → **Integration** → **API Keys** en selecteert **Get Started** of **Add New Key**. Selecteer **Create API Key** en kopieer de sleutel meteen: Shopmonkey toont deze slechts één keer. De sleutel heeft dezelfde rechten als de gebruiker die deze maakt.

### De webhooktool maken

Ga in Reception.ai naar **Integrations**, selecteer **Add integration** en kies **Webhook Tool**.

| Veld                     | Waarde                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Naam**                 | `create_shopmonkey_appointment`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| **Beschrijving**         | "Voeg een afspraak toe aan de garageagenda zodra de beller een dag en tijd heeft gekozen. Bevestig de tijd eerst met de beller."                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| **Methode**              | POST                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| **URL**                  | `https://api.shopmonkey.cloud/v3/appointment`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| **Request Headers**      | `Authorization`: `Bearer ` gevolgd door je API-sleutel                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| **Body Parameters**      | `name` (string, verplicht): "De service en de naam van de beller, bijvoorbeeld: Olie verversen - Jane Doe."  `startDate` (string, verplicht): "De starttijd in UTC, in ISO 8601-indeling, bijvoorbeeld 2026-11-04T15:00:00.000Z."  `endDate` (string, verplicht): "De eindtijd in dezelfde indeling. Gebruik een uur na de start, tenzij de service van de beller langer duurt."  `color` (string, verplicht): "Altijd exact de waarde `blue`."  `note` (string, verplicht): "De naam, het telefoonnummer, het bouwjaar, merk en model van het voertuig van de beller, en wat die nodig heeft." |
| **Toewijzen aan agents** | **Receptionist**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |

Selecteer **Enable**.

### Testen

[Test je receptionist](/docs/nl/reception-ai/receptionist/testing) door een afspraak te maken voor olie verversen. Controleer of de afspraak op het juiste lokale tijdstip in je Shopmonkey-agenda verschijnt.

`color` moet een van de volgende waarden zijn: `aqua`, `black`, `blue`, `brown`, `gray`, `green`, `orange`, `purple`, `red` of `yellow`. Gebruik een kleur die je team niet voor andere afspraken gebruikt, zodat telefonische boekingen opvallen.

## Beperkingen

* De klantzoekfunctie van Shopmonkey gebruikt een lijst met telefoonnummers, die webhooktools niet kunnen verzenden. Je receptionist kan bellers dus niet opzoeken of de afspraak koppelen aan een klant- of voertuigrecord. De notitie bevat in plaats daarvan de gegevens van de beller.
* De tool kan afspraken niet verplaatsen of annuleren. Daarvoor is de afspraak-ID in de URL nodig.

## Problemen oplossen

| Probleem                                | Wat je moet controleren                                                                                                          |
| --------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| 401 van Shopmonkey                      | De header moet `Bearer ` gevolgd door een huidige sleutel zijn, met een spatie na `Bearer`.                                      |
| Afspraken hebben het verkeerde tijdstip | Tijden moeten in UTC zijn. Voeg de tijdzone van je garage toe aan de instructies voor de receptionist, zodat deze correct omzet. |
| 400 over `color`                        | Gebruik een van de kleurnamen van Shopmonkey, in kleine letters.                                                                 |
| De afspraak bevat geen klantgegevens    | Zorg dat de beschrijving de receptionist opdraagt eerst de naam, het nummer en het voertuig van de beller te verzamelen.         |