> 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

Med ett [webhook-verktyg](/docs/sv/reception-ai/integrations/webhooks) kan din receptionist lägga till en bokning i din Shopmonkey-kalender när en uppringare vill lämna in sitt fordon.

> **Warning**
>
> Shopmonkey kontrollerar inte konflikter när en bokning skapas på det här sättet, så din
> receptionist kan dubbelboka en tid. Berätta för uppringare att tiden är en förfrågan som din verkstad
> bekräftar, eller ange era öppettider och gränser för antal arbetsplatser i receptionistens instruktioner.

## Konfiguration

### Skapa en API-nyckel

I Shopmonkey öppnar en administratör **Settings** → **Integration** → **API Keys** och väljer **Get Started** eller **Add New Key**. Välj **Create API Key** och kopiera nyckeln direkt: Shopmonkey visar den bara en gång. Nyckeln har samma behörigheter som användaren som skapar den.

### Skapa webhook-verktyget

Gå till **Integrations** i Reception.ai, välj **Add integration** och sedan **Webhook Tool**.

| Fält                      | Värde                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Namn**                  | `create_shopmonkey_appointment`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| **Beskrivning**           | "Lägg till en bokning i verkstadskalendern när uppringaren har valt en dag och tid. Bekräfta tiden med personen först."                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| **Metod**                 | POST                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| **URL**                   | `https://api.shopmonkey.cloud/v3/appointment`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| **Begärandehuvuden**      | `Authorization`: `Bearer ` följt av din API-nyckel                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| **Brödparametrar**        | `name` (sträng, obligatoriskt): "Tjänsten och uppringarens namn, till exempel: Oljebyte - Jane Doe."  `startDate` (sträng, obligatoriskt): "Starttiden i UTC, i ISO 8601-format, till exempel 2026-11-04T15:00:00.000Z."  `endDate` (sträng, obligatoriskt): "Sluttiden i samma format. Använd en timme efter starttiden om inte uppringarens tjänst tar längre tid."  `color` (sträng, obligatoriskt): "Alltid exakt värdet `blue`."  `note` (sträng, obligatoriskt): "Uppringarens namn, telefonnummer, fordonets årsmodell, märke och modell samt vad personen behöver." |
| **Tilldela till agenter** | **Receptionist**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |

Välj **Enable**.

### Testa

[Testa din receptionist](/docs/sv/reception-ai/receptionist/testing) genom att boka ett oljebyte. Kontrollera att bokningen visas i din Shopmonkey-kalender vid rätt lokal tid.

`color` måste vara ett av följande: `aqua`, `black`, `blue`, `brown`, `gray`, `green`, `orange`, `purple`, `red` eller `yellow`. Använd en färg som ditt team inte använder för andra bokningar, så att telefonbokningar sticker ut.

## Begränsningar

* Shopmonkeys kundsökning tar emot en lista med telefonnummer, vilket webhook-verktyg inte kan skicka. Din receptionist kan därför inte slå upp uppringare eller koppla bokningen till en kund- eller fordonspost. Anteckningen innehåller i stället uppringarens uppgifter.
* Verktyget kan inte boka om eller avboka tider. Det kräver boknings-ID:t i URL:en.

## Felsökning

| Problem                        | Vad du ska kontrollera                                                                                                 |
| ------------------------------ | ---------------------------------------------------------------------------------------------------------------------- |
| 401 från Shopmonkey            | Rubriken måste vara `Bearer ` följt av en aktuell nyckel, med ett mellanslag efter `Bearer`.                           |
| Bokningar hamnar vid fel tid   | Tider måste anges i UTC. Lägg till verkstadens tidszon i receptionistens instruktioner så att den konverterar rätt.    |
| 400 om `color`                 | Använd ett av Shopmonkeys färgnamn, med små bokstäver.                                                                 |
| Bokningen saknar kunduppgifter | Se till att beskrivningen instruerar receptionisten att först samla in uppringarens namn, nummer och fordonsuppgifter. |