Acuity Scheduling | ElevenLabs Documentation

Med webhook-verktygen nedan kan din receptionist kontrollera när en mötestyp är ledig och boka in uppringaren på en ledig tid. Acuity skickar sin vanliga bekräftelse via e-post till kunden.

Innan du börjar

Kontrollera ditt abonnemang

Acuity inkluderar bara API-åtkomst i sitt högsta abonnemang (Premium, tidigare kallat Powerhouse). I andra abonnemang misslyckas verktygen nedan med ett 403-fel.

Hämta dina API-uppgifter

Öppna Integrations i Acuity, hitta API och kopiera ditt User ID och din API Key.

Skapa autentiseringshuvudet

Acuity använder ditt User ID som användarnamn och API-nyckeln som lösenord. Koda dem i en terminal och ersätt båda platshållarna:

printf 'USER_ID:API_KEY' | base64

Huvudvärdet är Basic följt av resultatet.

Klistra inte in din API-nyckel i en onlinekodare. Den som har den kan läsa och ändra dina möten och kunduppgifter.

Hitta mötestypens ID

Kopiera den direkta bokningslänken för den mötestyp du vill att din receptionist ska boka. Numret efter appointmentType= i länken är dess ID. Verktygen nedan använder det i stället för APPOINTMENT_TYPE_ID.

Skapa verktygen

För varje verktyg går du till Integrations, väljer Add integration, väljer Webhook Tool och anger Assign to agents till Receptionist.

Kontrollera lediga tider

Fält	Värde
Name	`check_acuity_availability`
Description	”Lista de lediga mötestiderna på ett datum. Använd detta innan du erbjuder uppringaren en tid.”
Method	GET
URL	`https://acuityscheduling.com/api/v1/availability/times`
Request Headers	`Authorization`: `Basic` följt av de kodade uppgifterna
Query Parameters	`appointmentTypeID` (nummer, krävs): “Alltid det exakta värdet `APPOINTMENT_TYPE_ID`.” `date` (sträng, krävs): “Datumet som ska kontrolleras, i formatet ÅÅÅÅ-MM-DD.”

Boka ett möte

Fält	Värde
Name	`book_acuity_appointment`
Description	”Boka in uppringaren på en ledig tid när de har valt en. Bekräfta först datum och tid med dem.”
Method	POST
URL	`https://acuityscheduling.com/api/v1/appointments`
Request Headers	`Authorization`: `Basic` följt av de kodade uppgifterna
Body Parameters	`datetime` (sträng, krävs): “Den valda tiden, exakt som den returneras i ett `time`-värde av `check_acuity_availability`.” `appointmentTypeID` (nummer, krävs): “Alltid det exakta värdet `APPOINTMENT_TYPE_ID`.” `firstName` (sträng, krävs): “Uppringarens förnamn.” `lastName` (sträng, krävs): “Uppringarens efternamn.” `email` (sträng, krävs): “Uppringarens e-postadress. Be dem bokstavera den.” `phone` (sträng): “Uppringarens telefonnummer.”

Välj Enable för varje verktyg och testa din receptionist genom att be om ett möte. Bokningen visas i din Acuity-kalender.

Om du vill boka flera mötestyper ersätter du “Alltid det exakta värdet” i båda verktygen med en lista, till exempel: “Använd 111 för en 30-minuterskonsultation och 222 för ett 60-minutersmöte.”

Begränsningar

Acuity kräver en e-postadress för varje bokning, så din receptionist ber uppringare att bokstavera sin.
Svar på intagsformulär skickas som en lista, vilket webhook-verktyg inte kan skicka. Bokningsanteckningar kan bara anges av en administratörsbokning, som hoppar över Acuitys tillgänglighetskontroller, så verktygen ovan anger inget av dem.
Verktygen kan inte avboka eller boka om möten. För det behövs mötes-ID:t i URL:en.

Felsökning

Problem	Vad du ska kontrollera
401 från Acuity	Koda `USER_ID:API_KEY` med kolon och börja huvudvärdet med `Basic` och ett mellanslag.
403 från Acuity	Ditt abonnemang inkluderar inte API-åtkomst.
Inga tider returneras	Kontrollera mötestypens ID och att typen har lediga tider det datumet.
Bokningen misslyckas med `not_available`	Tiden är bokad eller inte ledig. Be receptionisten kontrollera lediga tider igen före bokningen.
Bokningen misslyckas eftersom ett fält saknas	Ditt konto kan kräva ett telefonnummer. Gör `phone` obligatoriskt i bokningsverktyget.