📅 Kalendarz Google połączony z CRM
Integracja Google Calendar z CRM
Zespół dalej planuje w Kalendarzu Google, a CRM sam wie, kto, z kim i kiedy się spotkał. Budujemy synchronizację w obie strony przez Google Calendar API: wydarzenia z kalendarzy trafiają do CRM, a terminy zapisane w CRM do kalendarza właściwej osoby.
Integracja Google Calendar z CRM w skrócie
Integracja Google Calendar z CRM to synchronizacja kalendarzy Google z systemem do obsługi klientów, dzięki której spotkania, wizyty i zajęcia z kalendarzy trafiają do CRM jako wpisy przypisane do klienta i pracownika. Budujemy ją przez Google Calendar API, z odczytem samych zmian i zapisem w obie strony.
Każdy kalendarz ma właściciela.
Parujemy kalendarz z pracownikiem w CRM. Kalendarz bez pary system pomija, zamiast zgadywać.
Klient z tytułu wydarzenia.
Imię i nazwisko w tytule porównywane z klientami w CRM, bez znaczenia polskich znaków i wielkości liter.
Bez zgadywania.
Nieznane nazwisko albo dwa pasujące rekordy trafiają do kolejki do wyjaśnienia.
Ręczna poprawka wygrywa.
Decyzji wpisanej w CRM kolejna synchronizacja nie cofa.
Kalendarz Google i CRM bez przepisywania
Dziś: Grafik w Kalendarzu Google, rozliczenia osobno
Po wdrożeniu: Wydarzenia z kalendarzy same trafiają do CRM
Dziś: Ktoś co tydzień przepisuje spotkania z kalendarzy
Po wdrożeniu: Odczyt zmian z Google co kilkanaście minut, np. co 15
Dziś: Wizytę umówioną w CRM trzeba dopisać do kalendarza
Po wdrożeniu: Termin z CRM trafia do kalendarza właściwej osoby
Dziś: Nikt nie wie, kogo dotyczy skrót w tytule wydarzenia
Po wdrożeniu: Sprawa w kolejce do wyjaśnienia, decyzja zostaje jako reguła
Dziś: Odwołanie albo przesunięcie widać dopiero przy rozliczeniu
Po wdrożeniu: Przesunięcia i odwołania na liście zmian do odhaczenia
Zespół pracuje w kalendarzu jak dotąd. CRM liczy, rozlicza i pyta, gdy czegoś nie wie.
Co łączymy z Kalendarzem Google
Zakres ustalamy na konsultacji. Najczęściej obejmuje te elementy.
Wiele kalendarzy naraz.
Osobny kalendarz dla każdego pracownika, wszystkie w jednym grafiku w CRM.
Dopasowanie klientów.
Klient rozpoznany po imieniu i nazwisku w tytule, a gdy w tytule nie ma nazwiska, po adresie e-mail uczestnika wydarzenia.
Zapis z CRM do Google.
Wizyta umówiona w CRM pojawia się w kalendarzu właściwej osoby przy najbliższej synchronizacji.
Rozliczenie spotkań.
Odbyte zajęcia schodzą z pakietu klienta, a odwołane według Twojej reguły, np. 24 godzin.
Kolejka do wyjaśnienia.
Wydarzenia, których nie da się jednoznacznie przypisać, czekają na decyzję człowieka.
Lista zmian.
Przesunięty termin, usunięte wydarzenie i zmiana uczestników jako lista do odhaczenia, nie log techniczny.
Kalendarz Google w naszych wdrożeniach
Studio treningu personalnego: zajęcia z kalendarzy trenerów
Sześć kalendarzy trenerów synchronizowanych z CRM co 15 minut. Odbyte treningi same schodzą z pakietów klientów, niejasne przypadki czekają w kolejce.
- Kalendarz Google
- dopasowanie klienta
- rozliczenie
- CRM
Jak pracujemy
Konsultacja
Ustalamy, kto ma które kalendarze, jak zespół nazywa wydarzenia i co CRM ma z nimi zrobić.
Reguły dopasowania
Konwencja tytułów, parowanie kalendarzy z pracownikami, rodzaje wizyt i to, co trafia do kolejki do wyjaśnienia.
Integracja
Projekt w Google Cloud, zgoda OAuth na koncie właściciela kalendarzy, synchronizacja przyrostowa i zapis w obie strony.
Test i uruchomienie
Pierwsza synchronizacja, przegląd kolejki z zespołem, potem stały harmonogram i opieka po wdrożeniu.
Czego nie robimy
- Nie przypisujemy wydarzenia klientowi na oko. Niejednoznaczne przypadki rozstrzyga człowiek.
- Nie cofamy ręcznych poprawek przy kolejnej synchronizacji.
- Nie prosimy o hasło do konta Google. Dostęp daje zgoda OAuth, którą można cofnąć w każdej chwili.
- Nie rozliczamy po cichu wydarzeń z przeszłości dopisanych do kalendarza po fakcie.
Narzędzia
Google Calendar API
Lista kalendarzy, wydarzenia, odczyt przyrostowy i zapis nowych terminów.
OAuth 2.0 Google
Zgoda na koncie właściciela kalendarzy, tylko na wydarzenia, listę kalendarzy i adres konta.
Python i Django
Synchronizacja, reguły rozliczeń, kolejka do wyjaśnienia i zadania cykliczne.
Next.js
Panel CRM na telefon i komputer.
n8n lub Make
Prostsze przepływy, np. nowe wydarzenie jako zadanie albo powiadomienie.
Opisz, jak Twój zespół korzysta z kalendarza
Napisz, czym zajmuje się Twoja firma i co chcesz usprawnić.
Wrócimy z konkretną propozycją, a nie z ogólną prezentacją.
Co dzieje się dalej
- Odpisujemy w ciągu 1 dnia roboczego.
- Umawiamy 30-minutową rozmowę.
- Przygotowujemy propozycję i wycenę.
Najczęstsze pytania
Jak zsynchronizować Kalendarz Google z CRM?
Przez Google Calendar API: właściciel kalendarzy raz daje zgodę OAuth, a CRM pobiera wydarzenia i zapisuje nowe terminy. Pierwszy przebieg wczytuje wydarzenia z ustalonego okresu, kolejne pobierają tylko zmiany. Do tego dochodzą reguły: który kalendarz należy do kogo i jak rozpoznać klienta w wydarzeniu.
Czy synchronizacja Google Calendar z CRM działa w obie strony?
Tak, jeśli tak ją zbudujemy. W naszym wdrożeniu wydarzenia z Google trafiają do CRM, a wizyta umówiona w CRM pojawia się w kalendarzu właściwego trenera przy najbliższej synchronizacji. Ustalamy też, która strona o czym decyduje: kalendarz o terminie, CRM o rozliczeniu.
Co to jest syncToken w Google Calendar API?
To znacznik, dzięki któremu kolejne zapytanie zwraca tylko wydarzenia zmienione od poprzedniego, łącznie z usuniętymi. Google podaje go na ostatniej stronie wyników. Gdy token straci ważność, API odpowiada błędem 410 i integracja musi zrobić pełny odczyt od nowa.
Jak CRM rozpoznaje klienta w wydarzeniu z kalendarza?
Po imieniu i nazwisku w tytule, a gdy w tytule nie ma nazwiska, po adresie e-mail uczestnika. Porównanie jest dokładne, ale bez znaczenia polskich znaków i wielkości liter. Gdy pasuje kilku klientów albo żaden, wydarzenie trafia do kolejki, a odpowiedź właściciela zapisuje się jako reguła na kolejne wydarzenia.
Dlaczego integracja z Kalendarzem Google przestała działać po tygodniu?
Najczęściej dlatego, że aplikacja w Google Cloud została w trybie testowym. Dla aplikacji zewnętrznej w stanie Testing Google wydaje token odświeżania ważny 7 dni, więc trzeba ją opublikować. Dostęp znika też, gdy użytkownik cofnie zgodę albo token nie jest używany przez 6 miesięcy.
Czy można użyć powiadomień push zamiast odpytywania kalendarza?
Tak, Google Calendar API ma kanały powiadomień (metoda watch). Powiadomienie mówi tylko, że coś się zmieniło, więc integracja i tak pobiera zmiany przez API. Kanał wygasa i trzeba go odnawiać, a adres odbiorcy musi mieć ważny certyfikat HTTPS. W studiu treningowym odczytujemy zmiany co 15 minut, bez kanałów push.
Czy integracja kalendarza z CRM jest bezpieczna?
Tak, jeśli dostęp idzie przez OAuth, a nie przez hasło. Prosimy tylko o zakresy potrzebne do wydarzeń, listy kalendarzy i adresu konta, a tokeny trzymamy w bazie zaszyfrowane. Zgodę można cofnąć w ustawieniach konta Google, a dane już zapisane w CRM zostają.
Co daje integracja Kalendarza Google z CRM?
W wielu firmach usługowych grafik żyje w Kalendarzu Google, a rozliczenia w osobnym systemie albo w arkuszu. Ktoś musi sprawdzać, kto przyszedł, kto odwołał i z czego to odliczyć. Integracja kalendarza z CRM robi to na bieżąco: wydarzenie zamienia się w wizytę przypisaną do klienta i pracownika, a CRM rozlicza ją według reguł firmy.
Równie ważne jest to, czego integracja nie robi. Tytuł wydarzenia to wolny tekst: skróty, literówki, dwie osoby o tym samym nazwisku. Dlatego wszystko, czego nie da się przypisać jednoznacznie, trafia do kolejki, a nie do rozliczenia.
Jak działa synchronizacja przez Google Calendar API krok po kroku
- Zgoda OAuth właściciela kalendarzy, raz, na koncie, które je posiada.
- Parowanie kalendarzy z pracownikami w CRM. Kalendarz bez pary jest pomijany.
- Pierwszy odczyt wydarzeń w ustalonym oknie, np. od dziś na 4 miesiące w przód.
- Odczyt przyrostowy co kilkanaście minut: tylko zmienione i usunięte wydarzenia, z tokenem synchronizacji.
- Dopasowanie i rozliczenie: klient z tytułu, odliczenie z pakietu albo sprawa w kolejce.
- Zapis do Google wizyt umówionych w CRM.
Co robi CRM, gdy wydarzenie z kalendarza jest niejasne?
Każde wydarzenie, którego nie da się rozliczyć jednoznacznie, idzie do kolejki z powodem zapisanym po ludzku. Tak to wygląda w naszym wdrożeniu dla studia treningowego.
| Sytuacja | Co robi system | Co robi człowiek |
|---|---|---|
| nieznane nazwisko w tytule | nie rozlicza, grupuje wydarzenia z tym zapisem | wskazuje klienta albo oznacza „to nie klient”, powstaje reguła |
| dwóch klientów o tym samym nazwisku | nie wybiera żadnego | wskazuje właściwą osobę |
| klient bez aktywnego pakietu | nie odlicza | sprzedaje albo przedłuża pakiet |
| trening dopisany do kalendarza po fakcie | nie rozlicza automatycznie | odlicza z pakietu przyciskiem albo zamyka sprawę |
Ręczna decyzja jest dla synchronizacji nietykalna. Bez tego kolejny przebieg po 15 minutach cofałby poprawki właściciela.
Bezpieczeństwo i RODO przy integracji kalendarza z CRM
Zgodę OAuth daje właściciel kalendarzy, a integracja prosi tylko o dostęp do wydarzeń, listy kalendarzy i adresu konta. Tokeny dostępu leżą w bazie zaszyfrowane i nie pojawiają się w logach. Gdy w CRM są dane wrażliwe, np. wywiad zdrowotny, pracownik widzi tylko przypisanych sobie klientów, a w tytule wydarzenia zostaje samo imię i nazwisko.
Takie systemy budujemy jako oprogramowanie dedykowane, a prostsze przepływy, np. powiadomienie o nowym wydarzeniu, także w n8n.

