Cal.com
Połącz agentów ElevenLabs z harmonogramem Cal.com.
Omówienie
Połącz agentów AI ElevenLabs z Cal.com, aby zarządzać harmonogramem i rezerwacjami w kalendarzu. Ta integracja pozwala agentom sprawdzać dostępność, rezerwować spotkania, anulować lub zmieniać ich termin oraz wyszukiwać istniejące rezerwacje w naturalnej rozmowie.
Możliwości
Konfiguracja
Ta integracja używa do uwierzytelniania klucza API Cal.com (nie aplikacji OAuth).
Wygeneruj klucz API w Cal.com
Przejdź do Settings > Developer > API Keys na koncie Cal.com i kliknij New. Od razu skopiuj wygenerowany klucz — nie zostanie wyświetlony ponownie.
Demo
To demo używa starszych narzędzi webhook. Jeśli korzystasz z natywnej integracji Cal.com, narzędzia są konfigurowane automatycznie — ręczna konfiguracja webhooka nie jest potrzebna.
Jak to działa
Agent planuje spotkania, używając wywołań narzędzi na kolejnych etapach rezerwacji. Karty poniżej pokazują ogólne podsumowanie i szczegółowy prompt systemowy.
Ogólne omówienie
Szczegółowy prompt systemowy
Pierwsze zapytanie i szczegóły spotkania
Agent pyta o cel spotkania, preferowaną datę i godzinę oraz czas trwania, aby zebrać informacje potrzebne do zaplanowania spotkania.
Sprawdzenie dostępności w kalendarzu
Agent sprawdza dostępność w kalendarzu, wykonując następujące kroki:
- Używa narzędzia
get_available_slots, aby pobrać wolne terminy. - Sprawdza, czy wybrana godzina jest dostępna.
- Proponuje alternatywy, jeśli wybrana godzina nie jest dostępna.
- Potwierdza wybrany termin z rozmówcą.
Ręczna konfiguracja webhooka
Jeśli używasz natywnej integracji Cal.com, narzędzia są konfigurowane automatycznie. Poniższe kroki dotyczą tylko ręcznej konfiguracji webhooka.
Zapisz sekret Cal.com
Bezpiecznie zapisz klucz API przed wysłaniem uwierzytelnionych żądań. Wygeneruj nowy klucz API Cal.com, jeśli jeszcze go nie masz.
Interfejs API Cal.com oczekuje następującego nagłówka uwierzytelniania:
Zapisz klucz w magazynie sekretów agenta, aby zachować jego bezpieczeństwo i dostępność podczas wysyłania żądań.
Aby zachować oczekiwaną strukturę uwierzytelniania Cal.com, podczas tworzenia sekretu pamiętaj, aby poprzedzić klucz API wartością Bearer .
Dodaj narzędzia do agenta
Włącz rezerwacje w kalendarzu, tworząc dwa narzędzia:
-
get_available_slots: Gdy użytkownik pyta “Czy Louis ma wolne we wtorek o 10:30?”, agent używa endpointu Cal.com „Get available slots”, aby sprawdzić wolne terminy. -
book_meeting: Po znalezieniu odpowiedniego terminu agent rezerwuje spotkanie za pomocą endpointu Cal.com „Create a booking”.
Przejdź do sekcji Tools w panelu i wybierz Add Tool. Jako typ narzędzia wybierz Webhook, a następnie uzupełnij poniższe sekcje:
Narzędzie 1: get_available_slots
Konfiguracja
Nagłówki
Parametry zapytania
Metadane, których agent używa, aby określić, kiedy wywołać narzędzie:
Narzędzie 2: book_meeting
Konfiguracja
Nagłówki
Parametry body
Metadane, których agent używa, aby określić, kiedy wywołać narzędzie:
Przetestuj agenta, klikając przycisk Test AI agent. W razie potrzeby dostosuj prompt systemowy.
Dodaj świadomość daty i godziny
Domyślnie agent nie zna bieżącej daty ani godziny. Skorzystaj z jednego z poniższych podejść:
-
Utwórz narzędzie do pobierania czasu: Dodaj narzędzie, które pobiera bieżącą datę i godzinę.
-
Nadpisania: Użyj funkcji nadpisań, aby na początku każdej rozmowy wstawić bieżącą datę i godzinę do promptu systemowego.
Kwestie bezpieczeństwa
- Używaj endpointów HTTPS do wszystkich wywołań webhooków.
- Przechowuj poufne wartości jako sekrety w Menedżerze sekretów ElevenLabs.
- Sprawdzaj, czy wszystkie nagłówki autoryzacji mają wymagany format (
Bearer YOUR_API_KEY). - Nigdy nie ujawniaj rozmówcom ID typów wydarzeń ani szczegółów API.