Cal.com-Integration
Verbinde Cal.com, und dein KI-Agent bucht Termine im Chat
Füge einen Cal.com-API-Key ein, wähle einen Termintyp, und dein intoCHAT-Agent zeigt unter seiner Antwort echte freie Zeiten. Der Besucher wählt eine, trägt Name und E-Mail ein, und die Buchung wird in Cal.com angelegt, das wie gewohnt die Bestätigung verschickt.
So arbeiten intoCHAT und Cal.com zusammen
intoCHAT spricht mit der API von Cal.com (Version 2, unter api.cal.com), mit einem API-Key aus deinem Cal.com-Konto. Mit diesem Key macht intoCHAT genau drei Dinge und sonst nichts: Es listet deine Termintypen auf, damit du einen auswählen kannst, es liest die freien Zeiten dieses Termintyps, und es legt eine Buchung an, wenn ein Besucher eine Zeit bestätigt. Deine Verfügbarkeitsregeln, Pufferzeiten und verbundenen Kalender bleiben in Cal.com, und von dort kommen die freien Zeiten. Das KI-Modell erfindet nie eine Uhrzeit. Wann der Agent die Zeitauswahl zeigt, entscheidet er anhand eines kurzen Textes, den du schreibst: When to offer booking. Passt das Gespräch, etwa weil ein Besucher nach einer Demo fragt oder wissen will, wann jemand Zeit hat, zeigt er die freien Zeiten unter seiner Antwort. Er schreibt keine Zeiten in seinen Text und fragt im Chat nicht nach Name oder E-Mail: Die trägt der Besucher in der Zeitauswahl ein. Direkt vor der Buchung fragt intoCHAT Cal.com noch einmal, ob die Zeit noch frei ist. Hat jemand anderes sie inzwischen genommen, wird der Besucher gebeten, eine andere zu wählen, und nichts wird doppelt gebucht. Muss dein Termintyp Buchungen erst von dir bestätigt bekommen, beginnt die Bestätigung im Chat mit „Angefragt:“ statt „Gebucht:“ und sagt, dass der Termin noch bestätigt werden muss. Diese Seite behandelt die Verbindung zu Cal.com selbst: Einrichtung, was synchronisiert wird und die Grenzen. Wie die Buchung im Chat für Besucher aussieht und wie du sie in Vertrieb und Support einsetzt, steht auf der Funktionsseite zur Terminbuchung.
Cal.com mit deinem intoCHAT-Agenten verbinden
Einen API-Key in Cal.com erstellen
Öffne in Cal.com Settings, Developer, API keys und erstelle einen Key. Er beginnt mit cal_. Außerdem brauchst du mindestens einen Termintyp, etwa ein 30-minütiges Kennenlerngespräch.
Die Booking-Karte öffnen
Öffne in intoCHAT deinen Agenten und geh zum Tab Actions. Die Karte Booking steht unter deinen Aktionen und Formularen. Wähle unter Calendar die Option Cal.com.
Key einfügen und auf Connect klicken
Füge ihn in das Feld Cal.com API key ein. intoCHAT prüft den Key, indem es deine Termintypen lädt, speichert ihn verschlüsselt und zeigt danach nur noch cal_… und die letzten vier Zeichen.
Den Termintyp wählen, den Besucher buchen
Jeder Termintyp zeigt Titel und Dauer. Einer mit dem Vermerk „(hidden in Cal.com)“ ist auf deiner öffentlichen Buchungsseite ausgeblendet, kann im Chat aber trotzdem gebucht werden.
Festlegen, wann gebucht wird, dann speichern
Fülle optional When to offer booking aus, bis zu 1.000 Zeichen. Der Agent liest den Text, Besucher sehen ihn nie. Klicke auf Save: Die Buchung ist aktiv, sobald gespeichert ist.
Einen Testtermin buchen
Bitte im Playground um einen Termin und buche eine Zeit. Buchungen im Playground sind echt: Sie legen den Termin in Cal.com an und lösen dessen E-Mails aus. Storniere Testbuchungen danach in Cal.com.
When to offer booking, wenn du das Feld leer lässt
When the visitor wants to book a meeting, call, demo or appointment, or asks when the team is available.Das Feld zeigt diesen englischen Standardtext. Schreib einen eigenen, um es einzugrenzen, zum Beispiel erst, nachdem der Besucher gesagt hat, welches Produkt ihn interessiert.
Was zwischen intoCHAT und Cal.com synchronisiert wird
Freie Zeiten, live gelesen
Die Zeiten kommen jedes Mal aus Cal.com, wenn die Auswahl erscheint: bis zu 5 Tage mit freien Zeiten und bis zu 8 Uhrzeiten pro Tag, standardmäßig 7 Tage im Voraus oder die Tage, nach denen der Besucher fragt, bis zu ein Jahr im Voraus.
Buchungen in Cal.com angelegt
Eine bestätigte Zeit wird zur Cal.com-Buchung mit Name, E-Mail und Zeitzone des Besuchers. Cal.com verschickt wie gewohnt E-Mails und Kalendereinladungen; intoCHAT sendet keine eigene E-Mail.
Die Zeitzone des Besuchers
Die Zeiten erscheinen in der Zeitzone des Browsers, etwa „Zeiten in Europe/Berlin“, und so formatiert, wie der Browser Datum und Uhrzeit schreibt.
Eine Buchungsliste in intoCHAT
Die Karte Bookings im Tab Leads listet jeden im Chat gebuchten Termin mit Name, E-Mail und Zeitzone des Besuchers und einem Link zum Gespräch.
Webhook und Slack-Hinweis
Abonniere einen Webhook für Meeting booked, um booking.created mit dem provider calcom und der Buchungs-ID aus Cal.com zu erhalten, oder hake Booked meeting unter Slack alerts an.
Ein Key nur für Buchungen
Der Key wird verschlüsselt gespeichert und nie wieder angezeigt. intoCHAT liest damit Termintypen und freie Zeiten und legt Buchungen an, sonst nichts in Cal.com.
Häufige Fragen
Welchen intoCHAT-Tarif brauche ich für Cal.com?
Jeden, auch Free: Die Buchung mit Cal.com ist an keinen bezahlten intoCHAT-Tarif gebunden. Eine Zeit zu buchen verbraucht keine Nachricht; die Antwort, die die Zeiten zeigt, zählt wie jede andere Antwort. Prozeduren, ab Starter, können den Agenten außerdem anweisen, die Buchung nach ein paar qualifizierenden Fragen anzubieten.
Taucht eine Stornierung in Cal.com in intoCHAT auf?
Nein. Aus Cal.com wird nichts zurücksynchronisiert. Wird ein Termin dort verschoben oder storniert, zeigen die Buchungsliste und das Gespräch weiterhin die ursprüngliche Buchung, und es wird kein Webhook gesendet. Besucher stornieren oder verschieben über die E-Mails von Cal.com, nicht im Chat.
Kann ich eine selbst gehostete Cal.com-Instanz verbinden?
Derzeit nicht. intoCHAT verbindet sich mit der gehosteten API von Cal.com unter api.cal.com, der API-Key muss also aus einem Konto dort stammen.
Kann ein Agent mehrere Termintypen anbieten?
Nein. Jeder Agent bucht jeweils einen Termintyp aus einem Kalender. Mit Change event type auf der Booking-Karte wechselst du ihn. Willst du eine Vertriebsdemo und einen Supporttermin anbieten, erstelle zwei Agenten mit je eigenem Termintyp.
Was, wenn Cal.com meinen Key ablehnt?
Die Karte meldet „Cal.com didn't accept this API key.“ Prüfe, ob du den ganzen Key kopiert hast und ob er in Cal.com nicht abgelaufen ist oder gelöscht wurde. Hat dein Konto noch keine Termintypen, lege einen an und klicke erneut auf Connect. Du kannst Keys bis zu 10-mal in 10 Minuten prüfen.
Was passiert, wenn die Zeit gerade vergeben wurde?
intoCHAT fragt Cal.com direkt vor der Buchung noch einmal. Ist die Zeit weg, sieht der Besucher „Diese Uhrzeit wurde gerade vergeben. Bitte wählen Sie eine andere.“, und die Zeit verschwindet aus der Liste.
Wird eine Buchung auch als Lead gespeichert?
Nein. Eine Buchung hat ihre eigene Liste, ihren eigenen Webhook (booking.created) und ihren eigenen Slack-Hinweis. Name und E-Mail aus der Zeitauswahl legen keinen Lead an und lösen keinen Lead-Hinweis aus, und Buchungen werden auf dem Dashboard nicht unter Outcomes gezählt.
Wie pausiere ich die Buchung, ohne die Einrichtung zu verlieren?
Nutze den Schalter On / Off im Kopf der Booking-Karte. Disconnect beendet die Buchung und löscht den gespeicherten Key; bereits gebuchte Termine bleiben in Cal.com und in der Buchungsliste. Ein duplizierter Agent übernimmt die Cal.com-Verbindung nicht, verbinde sie in der Kopie also neu.
Sieh, wie er mit deiner Website antwortet
Gib die Adresse deiner Website ein und chatte mit einem Agenten, der aus deinen Seiten gebaut wird. Das dauert etwa eine Minute.
Agent kostenlos erstellenKostenloser Plan, keine Kreditkarte nötig.