Skip to navigation
ConfigurerenIntegraties

Cal.com

Koppel je ElevenLabs-agents aan de planning van Cal.com.

Overzicht

Koppel je ElevenLabs AI-agents aan Cal.com om planning en agendaboekingen te beheren. Met deze integratie kunnen je agents beschikbaarheid controleren, afspraken boeken, vergaderingen annuleren of verzetten en bestaande boekingen opzoeken via een natuurlijk gesprek.

Mogelijkheden

MogelijkheidOndersteuning
Zero retention mode (ZRM)Niet ondersteund
Bijlagen in toolsNiet ondersteund — tools werken alleen met tekst

Installatie

Deze integratie gebruikt een Cal.com API-sleutel voor authenticatie (geen OAuth-app).

1

Genereer een API-sleutel in Cal.com

Ga in je Cal.com-account naar Settings > Developer > API Keys en klik op New. Kopieer de gegenereerde sleutel meteen — deze wordt niet opnieuw getoond.

2

Gebruik een live-sleutel

Cal.com genereert twee typen sleutels — testsleutels (die beginnen met cal_) en live-sleutels (die beginnen met cal_live_). Gebruik een live-sleutel, zodat je agent toegang heeft tot echte agendagegevens.

3

Koppel in ElevenLabs

Plak je Cal.com API-sleutel in de ElevenLabs-integratieconfiguratie in het veld API Key.

Demo

Deze demo gebruikt verouderde webhooktools. Als je de native Cal.com-integratie gebruikt, worden de tools automatisch geconfigureerd — handmatige webhookconfiguratie is niet nodig.

Demo van Cal.com-integratie

Zo werkt het

De agent plant vergaderingen door tool calls te gebruiken om het boekingsproces stap voor stap te doorlopen. De tabbladen hieronder tonen een overzicht op hoofdlijnen en de gedetailleerde systeemprompt.

1

Eerste aanvraag en vergadergegevens

De agent vraagt naar het doel van de vergadering, de gewenste datum/tijd en de duur om planningsinformatie te verzamelen.

2

Beschikbaarheid in de agenda controleren

De agent controleert de beschikbaarheid in de agenda door:

  • De tool get_available_slots te gebruiken om beschikbare tijdslots op te halen.
  • Te controleren of de aangevraagde tijd beschikbaar is.
  • Alternatieven voor te stellen als de aangevraagde tijd niet beschikbaar is.
  • De geselecteerde tijd met de beller te bevestigen.
3

Contactgegevens verzamelen

Zodra een tijd is overeengekomen, doet de agent het volgende:

  • De volledige naam van de deelnemer verzamelen en valideren.
  • Controleren of het e-mailadres klopt.
  • Informatie over de tijdzone bevestigen.
  • Eventuele aanvullende verplichte velden voor het Cal.com-evenementtype verzamelen.
4

Vergadering maken

De agent:

  • Roept de tool book_meeting aan nadat alle informatie is gecontroleerd.
  • Volgt de structuur van de boekingstemplate.
  • Bevestigt dat de vergadering is gemaakt met de deelnemer.
  • Informeert de deelnemer dat die een agenda-uitnodiging ontvangt.

Handmatige webhookconfiguratie

Als je de native Cal.com-integratie gebruikt, worden tools automatisch geconfigureerd. De onderstaande stappen gelden alleen voor handmatige webhookconfiguratie.

1

Sla je Cal.com-secret op

Sla je API-sleutel veilig op voordat je geauthenticeerde requests uitvoert. Genereer een nieuwe Cal.com API-sleutel als je dat nog niet hebt gedaan.

De Cal.com API verwacht de volgende authenticatieheader:

Structuur van Cal-requestheader
'Authorization': 'Bearer YOUR_API_KEY'

Sla de sleutel op in de secretopslag van de agent, zodat deze veilig en toegankelijk is bij het uitvoeren van requests.

Vergeet niet om bij het maken van het secret Bearer vóór de API-sleutel te zetten, zodat de vereiste authenticatiestructuur van Cal.com overeenkomt.

Toolsecrets

2

Voeg tools toe aan de agent

Schakel agendaboekingen in door twee tools te maken:

  1. get_available_slots: Wanneer een gebruiker vraagt “Is Louis dinsdag om 10:30 uur vrij?”, gebruikt de agent het eindpunt ‘Get available slots’ van Cal.com om beschikbare tijdslots te controleren.

  2. book_meeting: Nadat de agent een geschikte tijd heeft gevonden, boekt deze de vergadering met het eindpunt ‘Create a booking’ van Cal.com.

Ga naar het gedeelte Tools van het dashboard en selecteer Add Tool. Kies Webhook als type tool en vul vervolgens de volgende secties in:

Metadata die de agent gebruikt om te bepalen wanneer de tool moet worden aangeroepen:

VeldWaarde
Naamget_available_slots
BeschrijvingDeze tool controleert of een bepaald tijdslot beschikbaar is in de agenda.
MethodeGET
URLhttps://api.cal.com/v2/slots

Metadata die de agent gebruikt om te bepalen wanneer de tool moet worden aangeroepen:

VeldWaarde
Naambook_meeting
BeschrijvingDeze tool boekt een vergadering in de agenda zodra een tijd is overeengekomen.
MethodePOST
URLhttps://api.cal.com/v2/bookings

Test de agent door op de knop Test AI agent te drukken. Pas de systeemprompt waar nodig aan.

3

Voeg bewustzijn van datum en tijd toe

Standaard kent de agent de huidige datum of tijd niet. Gebruik een van de volgende methoden:

  1. Maak een tool om de tijd op te halen: Voeg een tool toe die de huidige datum en tijd ophaalt.

  2. Overrides: Gebruik de functie overrides om aan het begin van elk gesprek de huidige datum en tijd in de systeemprompt in te voegen.

Beveiligingsoverwegingen

  • Gebruik HTTPS-endpoints voor alle webhookaanroepen.
  • Sla gevoelige waarden op als secrets met de ElevenLabs Secrets Manager.
  • Controleer of alle autorisatieheaders de vereiste indeling volgen (Bearer YOUR_API_KEY).
  • Deel nooit ID’s van evenementtypen of API-details met bellers.