Hoppa till navigering
KonfigureraIntegreringar

Cal.com

Koppla dina ElevenLabs-agenter till schemaläggning i Cal.com.

Översikt

Anslut dina AI-agenter från ElevenLabs till Cal.com för att hantera schemaläggning och kalenderbokningar. Med integreringen kan dina agenter kontrollera tillgänglighet, boka tider, avboka eller boka om möten och slå upp befintliga bokningar genom naturliga samtal.

Funktioner

FunktionStöd
Nollagringsläge (ZRM)Stöds inte
Bilagor i verktygStöds inte — verktygen arbetar endast med text

Konfiguration

Den här integreringen använder en Cal.com API-nyckel för autentisering (inte en OAuth-app).

1

Generera en API-nyckel i Cal.com

Gå till Settings > Developer > API Keys i ditt Cal.com-konto och klicka på New. Kopiera den genererade nyckeln direkt — den visas inte igen.

2

Använd en live-nyckel

Cal.com genererar två typer av nycklar — testnycklar (som börjar med cal_) och live-nycklar (som börjar med cal_live_). Använd en live-nyckel så att din agent kan komma åt riktig kalenderdata.

3

Anslut i ElevenLabs

Klistra in din Cal.com API-nyckel i fältet API Key i integrationskonfigurationen i ElevenLabs.

Demo

Den här demon använder äldre webhook-verktyg. Om du använder den inbyggda Cal.com-integreringen konfigureras verktygen automatiskt — ingen manuell webhook-konfiguration behövs.

Demo av Cal.com-integreringen

Så fungerar det

Agenten schemalägger möten genom att använda verktygsanrop steg för steg i bokningsprocessen. Flikarna nedan visar en övergripande sammanfattning och den detaljerade systemprompten.

1

Inledande förfrågan och mötesuppgifter

Agenten frågar efter mötets syfte, önskat datum och tid samt längd för att samla in schemaläggningsinformation.

2

Kontrollera kalendertillgänglighet

Agenten kontrollerar kalendertillgänglighet genom att:

  • Använda verktyget get_available_slots för att hämta lediga tider.
  • Kontrollera om den begärda tiden är tillgänglig.
  • Föreslå alternativ om den begärda tiden inte är tillgänglig.
  • Bekräfta den valda tiden med uppringaren.
3

Samla in kontaktuppgifter

När ni har kommit överens om en tid gör agenten följande:

  • Samlar in och validerar deltagarens fullständiga namn.
  • Kontrollerar att e-postadressen stämmer.
  • Bekräftar information om tidszon.
  • Samlar in ytterligare obligatoriska fält för Cal.com-händelsetypen.
4

Skapa möte

Agenten:

  • Anropar verktyget book_meeting efter att ha kontrollerat all information.
  • Följer bokningsmallens struktur.
  • Bekräftar att mötet har skapats med deltagaren.
  • Informerar personen om att hen får en kalenderinbjudan.

Manuell webhook-konfiguration

Om du använder den inbyggda Cal.com-integreringen konfigureras verktygen automatiskt. Stegen nedan gäller endast manuell webhook-konfiguration.

1

Spara din Cal.com-hemlighet

Spara din API-nyckel säkert innan du gör autentiserade förfrågningar. Generera en ny Cal.com API-nyckel om du inte redan har gjort det.

Cal.com API förväntar sig följande autentiseringsheader:

Cal-förfrågans headerstruktur
'Authorization': 'Bearer YOUR_API_KEY'

Spara nyckeln i agentens hemlighetslagring så att den är säker och tillgänglig när förfrågningar görs.

För att matcha Cal.coms förväntade autentiseringsstruktur, kom ihåg att lägga till Bearer före API-nyckeln när du skapar hemligheten.

Verktygshemligheter

2

Lägg till verktyg till agenten

Aktivera kalenderbokningar genom att skapa två verktyg:

  1. get_available_slots: När en användare frågar “Är Louis ledig klockan 10:30 på tisdag?” använder agenten Cal.coms slutpunkt “Get available slots” för att kontrollera lediga tider.

  2. book_meeting: Efter att ha hittat en lämplig tid bokar agenten mötet med Cal.coms slutpunkt “Create a booking”.

Gå till avsnittet Tools på instrumentpanelen och välj Add Tool. Välj Webhook som verktygstyp och fyll sedan i följande avsnitt:

Metadata som agenten använder för att avgöra när verktyget ska anropas:

FältVärde
Namnget_available_slots
BeskrivningDet här verktyget kontrollerar om en viss tid är tillgänglig i kalendern.
MetodGET
URLhttps://api.cal.com/v2/slots

Metadata som agenten använder för att avgöra när verktyget ska anropas:

FältVärde
Namnbook_meeting
BeskrivningDet här verktyget bokar ett möte i kalendern när en tid har avtalats.
MetodPOST
URLhttps://api.cal.com/v2/bookings

Testa agenten genom att trycka på knappen Test AI agent. Justera systemprompten vid behov.

3

Lägg till medvetenhet om datum och tid

Som standard känner agenten inte till aktuellt datum eller tid. Använd någon av följande metoder:

  1. Skapa ett verktyg för att hämta tid: Lägg till ett verktyg som hämtar aktuellt datum och aktuell tid.

  2. Overrides: Använd funktionen overrides för att lägga in aktuellt datum och aktuell tid i systemprompten i början av varje samtal.

Säkerhetsaspekter

  • Använd HTTPS-slutpunkter för alla webhook-anrop.
  • Spara känsliga värden som hemligheter med ElevenLabs Secrets Manager.
  • Kontrollera att alla auktoriseringsheaders följer det obligatoriska formatet (Bearer YOUR_API_KEY).
  • Exponera aldrig händelsetyp-ID:n eller API-information för uppringare.

Användbara länkar