Shopmonkey | ElevenLabs Documentation

Mit einem Webhook-Tool kann Ihre Rezeption einen Termin in Ihrem Shopmonkey-Kalender hinzufügen, wenn ein Anrufer sein Fahrzeug vorbeibringen möchte.

Shopmonkey prüft beim Erstellen eines Termins auf diesem Weg nicht auf Konflikte. Ihre Rezeption kann daher ein Zeitfenster doppelt belegen. Teilen Sie Anrufern mit, dass die Uhrzeit eine Anfrage ist, die Ihre Werkstatt bestätigt, oder geben Sie Ihrer Rezeption in den Anweisungen Ihre Öffnungszeiten und die Kapazität Ihrer Arbeitsplätze an.

Einrichtung

API-Schlüssel erstellen

In Shopmonkey öffnet ein Administrator Settings → Integration → API Keys und wählt Get Started oder Add New Key. Wählen Sie Create API Key und kopieren Sie den Schlüssel sofort: Shopmonkey zeigt ihn nur einmal an. Der Schlüssel hat dieselben Berechtigungen wie der Benutzer, der ihn erstellt.

Webhook-Tool erstellen

Gehen Sie in Reception.ai zu Integrations, wählen Sie Add integration und dann Webhook Tool.

Feld	Wert
Name	`create_shopmonkey_appointment`
Beschreibung	”Fügen Sie einen Termin zum Werkstattkalender hinzu, sobald der Anrufer einen Tag und eine Uhrzeit gewählt hat. Bestätigen Sie die Uhrzeit zuerst mit ihm.”
Methode	POST
URL	`https://api.shopmonkey.cloud/v3/appointment`
Request Headers	`Authorization`: `Bearer` gefolgt von Ihrem API-Schlüssel
Body Parameters	`name` (String, erforderlich): “Die Dienstleistung und der Name des Anrufers, zum Beispiel: Ölwechsel - Jane Doe.” `startDate` (String, erforderlich): “Die Startzeit in UTC im ISO-8601-Format, zum Beispiel 2026-11-04T15:00:00.000Z.” `endDate` (String, erforderlich): “Die Endzeit im selben Format. Verwenden Sie eine Stunde nach der Startzeit, sofern die Dienstleistung des Anrufers nicht länger dauert.” `color` (String, erforderlich): “Immer genau der Wert `blue`.” `note` (String, erforderlich): “Name, Telefonnummer, Baujahr, Marke und Modell des Fahrzeugs des Anrufers sowie sein Anliegen.”
Agenten zuweisen	Rezeption

Wählen Sie Enable.

Testen

Testen Sie Ihre Rezeption, indem Sie einen Ölwechsel buchen. Prüfen Sie, ob der Termin zur richtigen Ortszeit in Ihrem Shopmonkey-Kalender erscheint.

color muss einer der Werte aqua, black, blue, brown, gray, green, orange, purple, red oder yellow sein. Verwenden Sie eine Farbe, die Ihr Team nicht für andere Termine nutzt, damit telefonische Buchungen auffallen.

Einschränkungen

Die Kundensuche von Shopmonkey erwartet eine Liste von Telefonnummern, die Webhook-Tools nicht senden können. Ihre Rezeption kann daher keine Anrufer suchen und den Termin nicht mit einem Kunden- oder Fahrzeugdatensatz verknüpfen. Stattdessen enthält die Notiz die Daten des Anrufers.
Das Tool kann Termine nicht verschieben oder stornieren. Dafür ist die Termin-ID in der URL erforderlich.

Fehlerbehebung

Problem	Prüfen
401 von Shopmonkey	Der Header muss `Bearer` gefolgt von einem aktuellen Schlüssel sein, mit einem Leerzeichen nach `Bearer`.
Termine werden zur falschen Zeit erstellt	Zeiten müssen in UTC angegeben werden. Fügen Sie die Zeitzone Ihrer Werkstatt zu den Anweisungen der Rezeption hinzu, damit sie korrekt umrechnet.
400 wegen `color`	Verwenden Sie einen der Shopmonkey-Farbnamen in Kleinbuchstaben.
Der Termin enthält keine Kundendaten	Stellen Sie in der Beschreibung klar, dass die Rezeption zuerst Name, Nummer und Fahrzeug des Anrufers erfassen soll.