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
Konfiguration
Den här integreringen använder en Cal.com API-nyckel för autentisering (inte en OAuth-app).
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.
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.
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.
Översikt
Detaljerad systemprompt
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.
Kontrollera kalendertillgänglighet
Agenten kontrollerar kalendertillgänglighet genom att:
- Använda verktyget
get_available_slotsfö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.
Manuell webhook-konfiguration
Om du använder den inbyggda Cal.com-integreringen konfigureras verktygen automatiskt. Stegen nedan gäller endast manuell webhook-konfiguration.
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:
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.
Lägg till verktyg till agenten
Aktivera kalenderbokningar genom att skapa två verktyg:
-
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. -
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:
Verktyg 1: get_available_slots
Konfiguration
Headers
Frågeparametrar
Metadata som agenten använder för att avgöra när verktyget ska anropas:
Verktyg 2: book_meeting
Konfiguration
Headers
Body-parametrar
Metadata som agenten använder för att avgöra när verktyget ska anropas:
Testa agenten genom att trycka på knappen Test AI agent. Justera systemprompten vid behov.
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:
-
Skapa ett verktyg för att hämta tid: Lägg till ett verktyg som hämtar aktuellt datum och aktuell tid.
-
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.