Kanały kalendarza (ICS)

Dlaczego to ważne

Nie każdy chce przyznawać dostęp OAuth do swojego kalendarza. Kanały kalendarza pozwalają pobierać zajęte przedziały czasu przez adres URL ICS. 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 pobiera kanał co 15 minut i zapisuje znalezione przedziały zajętości.

Kanały ICS nie blokują jeszcze terminów rezerwacji. Kanał jest przypisany do całego konta, więc Kit nie wie, którego prowadzącego dotyczą jego wydarzenia. Pobrane przedziały zobaczysz na stronie kanału. Aby ukrywać zajęte terminy przed kandydatami, połącz Google Calendar i włącz Sprawdzaj konflikty terminów.

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 Integracje > Kanały kalendarza
2. Kliknij Dodaj kanał kalendarza
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 Dodaj kanał kalendarza

Kit sprawdza adres URL, pobiera kanał i zapisuje przedziały zajętości.

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
Pobierane dane	Plik ICS udostępniony pod wskazanym adresem; jego zawartość zależy od ustawień kalendarza
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	Zapisywane jako całodniowe przedziały zajętości, jeśli są oznaczone jako zajęte

Zapisane przedziały zajętości są dostępne w podglądzie kanału. Obecnie nie są odejmowane od terminów widocznych na stronie rezerwacji rozmowy.

Google Calendar (integracja) a kanały kalendarza

Funkcja	Google Calendar (OAuth)	Kanały kalendarza (ICS)
Wykrywanie konfliktów	Przy pobieraniu terminów rezerwacji	Jeszcze niedostępne; zajęte przedziały są zapisywane tylko do podglądu
Zaproszenia na rozmowę	Wysyłane e-mailem jako .ics, a dodatkowo wpis wprost w kalendarzu głównego prowadzącego, jeśli włączył on opcję Zezwól na tworzenie zdarzeń w tym kalendarzu	Wysyłane e-mailem wyłącznie jako .ics. Kit nigdy nie zapisuje niczego w kanale ICS
Konfiguracja	Autoryzacja OAuth	Wklejenie adresu URL
Obsługuje	Tylko Google Calendar	Dowolnego dostawcę kalendarza
Prywatność	Wymaga uprawnień do kalendarza	Dostęp przez 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 albo chcesz, żeby zarezerwowane rozmowy trafiały do kalendarza głównego prowadzącego bez akceptowania załącznika przez kogokolwiek (zobacz Integracja kalendarza). Kanał kalendarza działa tylko do odczytu: Kit odczytuje z niego okna zajętości i nigdy w nim nie zapisuje. Tak czy inaczej, zaproszenia na rozmowę są zawsze wysyłane dodatkowo 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 podłączyć oba rodzaje źródeł jednocześnie. Przy rezerwacji rozmów Kit uwzględnia jednak tylko kalendarze Google przypisane do prowadzącego i włączone do sprawdzania konfliktów.

Zarządzanie kanałami kalendarza

Edycja kanału

Przejdź do Integracje > Kanały kalendarza, znajdź kanał w sekcji Kanały kalendarza 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 Odśwież teraz. Kit natychmiast pobiera najnowszą wersję, zamiast czekać na kolejne 15-minutowe odpytywanie.

Usuwanie kanału

Kliknij menu z trzema kropkami (⋮) i wybierz Usuń kanał. Kit przestaje pobierać kanał i usuwa zapisane przedziały zajętości. Sam kalendarz pozostaje bez zmian.

Prywatność i bezpieczeństwo

Kit ogranicza odczyt i przechowywanie danych z kanałów kalendarza:

• Przechowywane są przedziały zajętości: Kit pobiera plik ICS i wyodrębnia godziny rozpoczęcia, zakończenia oraz status zajętości. Nie zapisuje tytułów, opisów, uczestników ani lokalizacji wydarzeń w danych kanału.
• 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 Integracje > Kanały kalendarza
• Kliknij Odśwież teraz, aby wymusić natychmiastową aktualizację
• Jeśli adres URL został wygenerowany ponownie, usuń stary kanał i dodaj nowy adres URL

Brak wydarzeń w podglądzie kanału

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.

W skrócie

• Przejdź do Integracje > Kanały kalendarza
• Kliknij Dodaj kanał kalendarza
• Wklej tajny adres URL ICS kalendarza
• Sprawdź, czy kanał wyświetla status „Active” po kilku minutach
• Otwórz kanał i sprawdź, czy pobrano zajęte przedziały czasu
• Opcjonalnie dodaj kanały dla dodatkowych kalendarzy (prywatnych, zespołowych itp.)