Kanały kalendarza (ICS)

Dlaczego to ważne

Nie każdy chce przyznawać dostęp OAuth do swojego kalendarza. Kanały kalendarza pozwalają połączyć dowolny kalendarz do wykrywania konfliktów, wklejając prosty adres URL. Bez OAuth, bez okna uprawnień, bez autoryzacji aplikacji zewnętrznej.

Obsługiwane kalendarze:

• Google Calendar (prywatny lub firmowy)
• Microsoft Outlook / Office 365
• Apple Calendar (iCloud)
• Dowolna aplikacja kalendarzowa oferująca adres URL eksportu ICS/iCal

Kit odpytuje kanał kalendarza co 15 minut i ukrywa kolidujące terminy, gdy kandydaci rezerwują rozmowy – dokładnie tak samo jak integracja z Google Calendar.

Wymagania

• Konto Kit z włączonym planowaniem
• Aplikacja kalendarzowa oferująca tajny adres URL ICS/iCal (większość tak robi)

Dodawanie kanału kalendarza

1. Przejdź do Integrations > Calendar Feeds
2. Kliknij Add Calendar Feed
3. Wklej adres URL ICS kalendarza (musi zaczynać się od https://)
4. Opcjonalnie ustaw nazwę wyświetlaną (Kit wykrywa ją automatycznie z kanału)
5. Kliknij Add Calendar Feed

Kit waliduje adres URL, pobiera kanał i natychmiast rozpoczyna sprawdzanie konfliktów.

Znajdowanie adresu URL ICS

Google Calendar

1. Otwórz Google Calendar i kliknij ikonę koła zębatego (Ustawienia)
2. Kliknij nazwę kalendarza na pasku bocznym po lewej stronie
3. Przewiń do Secret address in iCal format
4. Skopiuj adres URL

Ważne: Użyj adresu tajnego, a nie publicznego, chyba że kalendarz jest celowo publiczny. Tajny adres URL zawiera token umożliwiający odczyt.

Microsoft Outlook / Office 365

1. Otwórz Outlook w przeglądarce i przejdź do Settings > Calendar
2. Kliknij Shared calendars
3. W sekcji „Publish a calendar” wybierz odpowiedni kalendarz
4. Ustaw Can view all details i kliknij Publish
5. Skopiuj link ICS (nie HTML)

Apple Calendar (iCloud)

1. Otwórz aplikację Kalendarz na Macu
2. Kliknij prawym przyciskiem myszy kalendarz, który chcesz udostępnić
3. Wybierz Share Calendar…
4. Zaznacz Public Calendar
5. Skopiuj wyświetlony adres URL

Jak to działa

Aspekt	Szczegóły
Częstotliwość odpytywania	Co 15 minut
Dostępne dane	Tylko czasy rozpoczęcia/zakończenia wydarzeń i status zajęty/wolny
Przechowywane dane	Wyłącznie okna zajętości (bez treści wydarzeń)
Zakres czasowy	Najbliższe 30 dni
Cykliczne wydarzenia	Automatycznie rozwijane (dzienne, tygodniowe, miesięczne)
Całodniowe wydarzenia	Blokują cały dzień

Gdy kandydat przegląda dostępne terminy rozmów, Kit odejmuje czasy zajętości kalendarza od harmonogramu dostępności – dokładnie tak samo jak w przypadku Google Calendar.

Google Calendar (integracja) a kanały kalendarza

Funkcja	Google Calendar (OAuth)	Kanały kalendarza (ICS)
Wykrywanie konfliktów	W czasie rzeczywistym	Opóźnienie 15 minut
Zaproszenia na rozmowę	Wysyłane e-mailem jako .ics (nigdy nie zapisywane w kalendarzu)	Wysyłane e-mailem jako .ics (nigdy nie zapisywane w kalendarzu)
Konfiguracja	Autoryzacja OAuth	Wklejenie adresu URL
Obsługuje	Tylko Google Calendar	Dowolnego dostawcę kalendarza
Prywatność	Wymaga uprawnień do kalendarza	Oparte na URL, bez dostępu do konta
Całodniowe wydarzenia	Obsługiwane	Obsługiwane
Cykliczne wydarzenia	Obsługiwane przez Google API	Rozwijane z kanału

Użyj Google Calendar, jeśli potrzebujesz wykrywania konfliktów w czasie rzeczywistym. Żadna z opcji nie zapisuje niczego w kalendarzu – zaproszenia na rozmowę są zawsze wysyłane e-mailem jako załącznik .ics.

Użyj kanałów kalendarza, jeśli wolisz nie przyznawać dostępu OAuth, korzystasz z kalendarza innego niż Google lub chcesz dodać dodatkowy kalendarz od innego dostawcy.

Możesz korzystać z obu jednocześnie. Kit łączy czasy zajętości ze wszystkich połączonych źródeł.

Zarządzanie kanałami kalendarza

Edycja kanału

Przejdź do Integrations > Calendar Feeds, znajdź kanał w sekcji Calendar Feeds i kliknij ikonę ołówka. Możesz zmienić nazwę wyświetlaną oraz włączyć lub wyłączyć sprawdzanie konfliktów.

Odświeżanie kanału

Kliknij menu z trzema kropkami (⋮) obok kanału i wybierz Refresh Now. Kit natychmiast pobiera najnowszą wersję, zamiast czekać na kolejne 15-minutowe odpytywanie.

Usuwanie kanału

Kliknij menu z trzema kropkami (⋮) i wybierz Remove Feed. Kit przestaje sprawdzać ten kalendarz pod kątem konfliktów. Sam kalendarz pozostaje bez zmian.

Prywatność i bezpieczeństwo

Kanały kalendarza zostały zaprojektowane z myślą o prywatności:

• Brak przechowywania treści wydarzeń – Kit odczytuje wyłącznie czasy rozpoczęcia/zakończenia i status zajęty/wolny. Tytuły, opisy, uczestnicy i lokalizacje wydarzeń są odrzucane natychmiast po przetworzeniu.
• Zaszyfrowane przechowywanie – Adres URL kalendarza jest zaszyfrowany w stanie spoczynku. Nigdy nie jest logowany ani ujawniany w odpowiedziach API.
• Wyłącznie HTTPS – Kit akceptuje wyłącznie adresy URL kalendarzy przez HTTPS.
• Pełna kontrola dostępu – Aby cofnąć dostęp Kit, wygeneruj ponownie tajny adres URL kalendarza w aplikacji kalendarzowej (Google, Outlook itp.). Stary adres URL natychmiast przestaje działać.

Cofanie dostępu

W przeciwieństwie do OAuth (gdzie dostęp cofa się z poziomu Kit lub konta Google), dostęp do kanału kalendarza jest kontrolowany przez sam adres URL:

1. Przejdź do ustawień aplikacji kalendarzowej
2. Znajdź opublikowany/udostępniony kalendarz
3. Kliknij „Reset” lub „Unpublish”, aby unieważnić stary adres URL
4. W Kit usuń stary kanał i dodaj nowy adres URL, jeśli to konieczne

Rozwiązywanie problemów

Kanał nie aktualizuje się

Możliwe przyczyny:

1. Adres URL kalendarza został cofnięty lub wygenerowany ponownie
2. Dostawca kalendarza jest tymczasowo niedostępny
3. Kanał jest wstrzymany po powtarzających się błędach

Rozwiązanie:

• Sprawdź status kanału w Integrations > Calendar Feeds
• Kliknij Refresh Now, aby wymusić natychmiastową aktualizację
• Jeśli adres URL został wygenerowany ponownie, usuń stary kanał i dodaj nowy adres URL

Brak wydarzeń przy sprawdzaniu konfliktów

Możliwe przyczyny:

1. Wydarzenie jest oznaczone jako „free” (przezroczyste) w kalendarzu
2. Wydarzenie używa nietypowego wzorca cykliczności, którego Kit nie może rozwinąć
3. Wydarzenie przypada za ponad 30 dni

Rozwiązanie:

• Edytuj wydarzenie w kalendarzu i ustaw status na „busy”
• W przypadku wydarzeń cyklicznych sprawdź, czy wyświetlają się poprawnie w aplikacji kalendarzowej

Kanał wyświetla „Error” lub „Paused”

Kit wstrzymuje kanały po powtarzających się błędach pobierania, aby uniknąć zbędnych żądań.

• Error (3+ błędy): Kit nadal próbuje. Sprawdź, czy adres URL jest prawidłowy.
• Paused (długotrwałe błędy): Kit przestał odpytywać. Usuń kanał i dodaj go ponownie z nowym adresem URL.

Szybka lista kontrolna

• Przejdź do Integrations > Calendar Feeds
• Kliknij Add Calendar Feed
• Wklej tajny adres URL ICS kalendarza
• Sprawdź, czy kanał wyświetla status „Active” po kilku minutach
• Przetestuj, przeglądając stronę rezerwacji kandydata i sprawdzając, czy kolidujące terminy są ukryte
• Opcjonalnie dodaj kanały dla dodatkowych kalendarzy (prywatnych, zespołowych itp.)