> 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.

# Acuity Scheduling

Med [webhook-verktygen](/docs/sv/reception-ai/integrations/webhooks) 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:

```bash
printf 'USER_ID:API_KEY' | base64
```

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

> **Warning**
>
> 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](/docs/sv/reception-ai/receptionist/testing) genom att be om ett möte. Bokningen visas i din Acuity-kalender.

> **Tip**
>
> 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.           |