Hoppa till navigering

Shopmonkey

Lägg bokningsförfrågningar i din Shopmonkey-kalender med ett webhook-verktyg.

Med ett webhook-verktyg kan din receptionist lägga till en bokning i din Shopmonkey-kalender när en uppringare vill lämna in sitt fordon.

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

1

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.

2

Skapa webhook-verktyget

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

FältVärde
Namncreate_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.”
MetodPOST
URLhttps://api.shopmonkey.cloud/v3/appointment
BegärandehuvudenAuthorization: Bearer följt av din API-nyckel
Brödparametrarname (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 agenterReceptionist

Välj Enable.

3

Testa

Testa din receptionist 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

ProblemVad du ska kontrollera
401 från ShopmonkeyRubriken måste vara Bearer följt av en aktuell nyckel, med ett mellanslag efter Bearer.
Bokningar hamnar vid fel tidTider måste anges i UTC. Lägg till verkstadens tidszon i receptionistens instruktioner så att den konverterar rätt.
400 om colorAnvänd ett av Shopmonkeys färgnamn, med små bokstäver.
Bokningen saknar kunduppgifterSe till att beskrivningen instruerar receptionisten att först samla in uppringarens namn, nummer och fordonsuppgifter.