Dodaj Cal.com do swojej aplikacji
Jeden przycisk łączy konta Cal.com Twoich użytkowników. Twoja aplikacja odczytuje potem ich dostępność i rezerwuje w ich imieniu przez API v2, tylko z zakresami, na które pozwolą. Gotowe? Dodaj ją do Cal.com App Store.
- See your bookings
BOOKING_READ - Create, reschedule and cancel bookings
BOOKING_WRITE - See your scheduling links
EVENT_TYPE_READ
Zaufali nam szybko rosnące firmy z całego świata
Kontynuuj z Cal.com
Oficjalne przyciski serwowane z app.cal.com. Sprawdź każdy na jasnym lub ciemnym tle, skopiuj go jako HTML, React, Markdown albo URL, a potem wstaw swój identyfikator klienta i URI przekierowania.
Od przycisku do rezerwacji
Standardowy OAuth 2.0 z przepływem kodu autoryzacyjnego. Przycisk wysyła użytkowników do Cal.com, gdzie wybierają, co Twoja aplikacja może zrobić, a Ty wymieniasz kod na tokeny.
- Klienci poufni trzymają sekret na serwerze; klienci publiczni używają PKCE (S256).
- Tokeny dostępu są ważne 30 minut; tokeny odświeżania pobierają nowe.
- Do 10 dokładnych URI przekierowania na klienta, bez symboli wieloznacznych.
- Token wywołuje tylko endpointy objęte jego zakresami.
Wyślij użytkowników do Cal.com
Link przycisku. Cal.com pokazuje ekran zgody i przekierowuje z powrotem z kodem.
1GET https://app.cal.com/auth/oauth2/authorize2 ?client_id=YOUR_CLIENT_ID3 &redirect_uri=https://your-app.com/callback4 &state=YOUR_STATE5 &scope=BOOKING_READ%20BOOKING_WRITE67# z powrotem po Twojej stronie8https://your-app.com/callback?code=AUTHORIZATION_CODE&state=YOUR_STATE
Trzy kroki do App Store
Klient OAuth łączy Twoją aplikację z kontami użytkowników. Wpis w App Store to sposób, w jaki użytkownicy Cal.com ją znajdują.
01
Utwórz klienta OAuth
W Ustawienia → Deweloper → OAuth, nazwij swoją aplikację, wybierz co najmniej jeden zakres i dodaj URI przekierowania. Klient zaczyna jako oczekujący; Cal.com sprawdzi go i wyśle Ci e-mail, gdy zostanie zaakceptowany.
02
Dodaj przycisk
Umieść przycisk Kontynuuj z Cal.com tam, gdzie Twoi użytkownicy łączą narzędzia. Otwiera on ekran zgody Cal.com, a Twój callback wymienia kod na tokeny.
03
Dodaj ją do App Store
Cal.com ma otwarty kod źródłowy: utwórz wpis swojej aplikacji w packages/app-store za pomocą yarn create-app, a potem otwórz pull request w calcom/cal.com. Przewodnik przeprowadzi Cię przez cały proces.
Proś tylko o to, czego potrzebuje Twoja aplikacja
Użytkownicy widzą każdy zakres na ekranie zgody, zanim go zaakceptują, a token może dotrzeć tylko do endpointów objętych jego zakresami.
01
Użytkownik
Własne konto użytkownika: BOOKING_*, EVENT_TYPE_*, SCHEDULE_*, APPS_*, PROFILE_*, WEBHOOK_* i INSIGHTS_READ.
02
Zespół
Zespoły, do których należą, z zakresami TEAM_*: zespołowe linki do planowania, rezerwacje, harmonogramy i członkostwa.
03
Organizacja
Dostęp w całej organizacji z zakresami ORG_*. Każdy z nich przyznaje też odpowiadający mu zakres TEAM_*.
Potrzebujesz planowania pod własną marką w swojej aplikacji?
Skorzystaj z coss.com Scheduling, stworzonego przez zespół Cal.com. To infrastruktura, która obsługuje miliony rezerwacji — pod twoją marką i dla twoich użytkowników.
coss.scheduling.bookings.create()
const result = await coss.scheduling.bookings.create({ event_type: eventTypeId, start: "2026-03-10T14:00:00Z", attendee: { uid: "customer_77", name: "Sam Lee", email: "[email protected]", time_zone: "America/New_York", }, }); if (result.error?.code === "slot_unavailable") { // Someone got there first: show the times again. }
Trial lesson with Ana Reyes
30 minutes, 10 minute buffer
| Time | Mon 9 | Tue 10 | Wed 11 | Thu 12 | Fri 13 |
|---|---|---|---|---|---|
| 09:00 | busy | open | booked | open | open |
| 10:00 | open | Sam | open | busy | open |
| 11:00 | open | open | busy | open | open |
| 13:00 | booked | open | open | booked | open |
| 14:00 | open | busy | open | booked | open |
| 15:00 | open | busy | open | open | busy |
- confirmedCalendar invitations to Sam and Ana
- scheduling.
booking. confirmed
Pytania o tworzenie na Cal.com
Krótkie odpowiedzi znajdziesz tutaj. O wszystko inne zapytaj poniżej.
Zadaj pytanieNowy klient oczekuje, dopóki Cal.com go nie sprawdzi. Dostaniesz e-mail z wynikiem, a gdy zostanie zaakceptowany, klient będzie gotowy do użycia.
Nie musi. Zarejestruj aplikację jako klienta publicznego i użyj PKCE: wyślij code_challenge (S256) podczas autoryzacji oraz code_verifier podczas wymiany kodu. Sekret klienta nie jest potrzebny.
Tokeny dostępu wygasają po 30 minutach. Użyj tokena odświeżania, żeby dostać nowy bez odsyłania osoby z powrotem przez ekran zgody.
Klucz API służy do twojego własnego konta Cal.com. OAuth służy do działania na kontach innych osób, za ich zgodą i tylko z zakresami, na które pozwolą.
Przygotuj wpis w repozytorium open source za pomocą yarn create-app w katalogu packages/app-store, a potem otwórz pull request w repozytorium calcom/cal.com. Pytania kieruj do GitHub Discussions.
To coss.com Scheduling, infrastruktura planowania pod własną marką stworzona przez zespół Cal.com.
Cal.com Atoms są w trybie utrzymania: istniejące integracje nadal dostają poprawki i nowe wersje npm, ale nie będzie nowych komponentów Atoms. Dokumentacja Atoms pozostaje dostępna.
Połącz swoją aplikację z Cal.com
Utwórz klienta OAuth, dodaj przycisk i pokaż swoją aplikację każdemu użytkownikowi Cal.com.
Utwórz klienta OAuthPrzeczytaj dokumentację OAuth