> 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

Mit einem [Webhook-Tool](/docs/de/reception-ai/integrations/webhooks) kann Ihre Rezeption einen Termin in Ihrem Shopmonkey-Kalender hinzufügen, wenn ein Anrufer sein Fahrzeug vorbeibringen möchte.

> **Warning**
>
> 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](/docs/de/reception-ai/receptionist/testing), 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.                              |