Shopmonkey | ElevenLabs Documentation

Met een webhooktool kan je receptionist een afspraak toevoegen aan je Shopmonkey-agenda wanneer een beller een voertuig wil langsbrengen.

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