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

# Google Kalender

## Översikt

Anslut dina AI-agenter från ElevenLabs till [Google Calendar](https://calendar.google.com) för att hantera schemaläggning och kalenderbokningar. Med den här integrationen kan dina agenter kontrollera tillgänglighet, skapa händelser med deltagare och valfria Google Meet-möten, lista kommande händelser och hitta tillgängliga kalendrar genom naturliga samtal.

## Funktioner

| Funktion              | Stöd                                        |
| --------------------- | ------------------------------------------- |
| Nollagringsläge (ZRM) | Stöds inte                                  |
| Bilagor i verktyg     | Stöds inte — verktygen hanterar endast text |

## Konfiguration

Den här integrationen använder **Google OAuth 2.0** för autentisering. Du ger ElevenLabs behörighet att få åtkomst till din Google Calendar för din räkning.

#### Klicka på Connect i ElevenLabs

Klicka på **Connect** i integrationskonfigurationen i ElevenLabs. Du omdirigeras till Google för att godkänna åtkomst.

#### Välj ditt Google-konto

Välj det Google-konto vars kalenderdata din agent ska få åtkomst till. Om du är inloggad på flera Google-konton i webbläsaren väljer du rätt konto.

#### Godkänn kalenderåtkomst

Granska de begärda behörigheterna och klicka på **Allow**. Integrationen begär åtkomst för att hantera händelser i kalendrar du äger, visa din kalenderlista och kontrollera ledig/upptagen-information.

## OAuth-omfattningar

Integrationen begär följande Google OAuth 2.0-omfattningar:

| Omfattning                       | Syfte                                                                             |
| -------------------------------- | --------------------------------------------------------------------------------- |
| `calendar.events.owned`          | Skapa, läsa, uppdatera och ta bort händelser i kalendrar du äger.                 |
| `calendar.calendarlist.readonly` | Visa listan över kalendrar som ditt konto har åtkomst till (namn och ID:n).       |
| `calendar.freebusy`              | Kontrollera ledig/upptagen-tillgänglighet mellan kalendrar utan händelsedetaljer. |

## Så fungerar det

Agenten bokar möten genom att använda verktygsanrop för att gå igenom bokningsprocessen steg för steg. Flikarna nedan visar en övergripande sammanfattning och en detaljerad systemprompt.

#### Övergripande översikt

#### Hitta kalendrar

Agenten listar tillgängliga kalendrar för att hitta rätt kalender för schemaläggning. För de flesta användare är detta den primära kalendern.

#### Kontrollera tillgänglighet

Agenten kontrollerar ledig/upptagen-tillgänglighet genom att:

* Använda verktyget `google_calendar_check_availability` för att fråga efter upptagna tidsblock.
* Verifiera om den begärda tiden är ledig.
* Föreslå alternativ om den begärda tiden krockar med en befintlig händelse.
* Bekräfta den valda tiden med uppringaren.

#### Samla in deltagaruppgifter

När en tid har överenskommits gör agenten följande:

* Samlar in deltagarens fullständiga namn och e-postadress.
* Bekräftar e-postadressen genom att läsa upp den för uppringaren.
* Verifierar information om tidszon.

#### Skapa händelsen

Agenten:

* Anropar verktyget `google_calendar_create_event` med de bekräftade uppgifterna.
* Lägger vid behov till en Google Meet-länk om videomöte efterfrågas.
* Bekräftar att händelsen har skapats och informerar deltagaren om att de får en kalenderinbjudan.

#### Detaljerad systemprompt

```
You are a helpful scheduling assistant responsible for managing calendar bookings using Google Calendar. Be friendly, precise, and concise.

Begin by briefly asking for the purpose of the meeting and the caller's preferred date and time.
Then, ask about the desired meeting duration (15, 30, or 60 minutes), and wait for the user's response before proceeding.

Once you have the meeting details, check calendar availability:
- Call google_calendar_check_availability with the appropriate time range and calendar ID (use 'primary' for the main calendar)
- The tool returns busy time blocks — any time not listed as busy is available
- If the requested time overlaps with a busy block, suggest alternative times
- Continue until a suitable time is agreed upon

After confirming a time slot, gather the following contact details:
- The attendee's full name
- A valid email address. Note that the email address is transcribed from voice, so ensure it is formatted correctly.
- The attendee's time zone (in 'Continent/City' format like 'America/New_York')
- Read the email back to the caller to confirm accuracy

Once all details are confirmed, create the event:
- Call google_calendar_create_event with calendarId set to 'primary'
- Set summary to a descriptive meeting title
- Set start and end times in RFC 3339 format with the attendee's time zone
- Add the attendee's email to the attendees array
- If the caller requests a video call, include conferenceData with conferenceSolutionKey type 'hangoutsMeet' and set the conferenceDataVersion query parameter to 1
- Set sendUpdates to 'all' so attendees receive calendar invitations

Thank the attendee and inform them they will receive a calendar invitation shortly.

Clarifications:
- Do not inform the user that you are formatting the email; do it silently.
- If the caller asks you to proceed with booking, do so with the existing information.
- Use google_calendar_list_calendars if the caller asks to schedule on a specific calendar other than their primary one.
- Use google_calendar_list_events if the caller asks what meetings they have coming up.

Guardrails:
- Do not share any internal IDs or API details with the caller.
- If event creation fails, check for formatting issues in the email or time conflicts.
```

## Agentverktyg

När du lägger till Google Calendar-verktyg till en agent finns följande inbyggda verktyg:

| Verktyg                              | Beskrivning                                                                                                                                                                                                                    |
| ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `google_calendar_check_availability` | Kontrollera ledig/upptagen-tillgänglighet för en eller flera kalendrar inom ett tidsintervall. Returnerar upptagna tidsblock så att agenten kan hitta lediga tider. Använd före skapande av händelser för att undvika krockar. |
| `google_calendar_create_event`       | Skapa en ny händelse i Google Calendar med valfria deltagare, plats och Google Meet-möte. Skickar e-postnotiser till alla deltagare.                                                                                           |
| `google_calendar_list_events`        | Lista kommande händelser från en kalender inom ett tidsintervall, sorterade efter starttid. Stöder fritextsökning i händelsesammanfattningar, beskrivningar, platser och deltagaruppgifter.                                    |
| `google_calendar_list_calendars`     | Lista alla kalendrar som det anslutna Google-kontot har åtkomst till. Returnerar kalendernamn och ID:n. Använd för att hitta vilken kalender som ska användas innan du kontrollerar tillgänglighet eller skapar händelser.     |

## Användbara länkar

* [Google Calendar API-dokumentation](https://developers.google.com/calendar/api/v3/reference)
* [Google OAuth 2.0-omfattningar för Calendar](https://developers.google.com/identity/protocols/oauth2/scopes#calendar)
* [Snabbstart för Google Calendar API](https://developers.google.com/calendar/api/quickstart/python)
* [Översikt över ElevenLabs verktyg](/docs/sv/eleven-agents/customization/tools/server-tools)