Google integratie instellen

Met de Google-integratie synchroniseer je elke boeking automatisch tussen jouw boekingssysteem en de Google Agenda van je medewerkers. Een nieuwe boeking landt direct in hun agenda, en bestaande agenda-blokkades houden Bloomsite tegen om die tijden als beschikbaar te tonen.

De configuratie bestaat uit drie delen: eerst pak je in Bloomsite de Redirect URI, vervolgens maak je in Google Cloud Console een project met OAuth-gegevens aan, en tot slot koppelt elke medewerker zijn of haar eigen Google-account.

1. Bloomsite: open de Google Agenda-instellingen

1. Open Instellingen → Google Agenda
   Open Instellingen1 in de zijbalk en klik op de kaart Google Agenda2.

   

2. Noteer de Redirect URI
   Op de Google Agenda-instellingenpagina vind je drie velden: Client ID, Client Secret en Redirect URI. Kopieer de Redirect URI naar je klembord — die heb je straks in Google Cloud Console nodig — en houd dit tabblad open. Hier kom je later op terug om je Client ID en Client Secret te plakken.

   

2. Google Cloud Console: project en OAuth-gegevens aanmaken

De volgende stappen voer je uit op console.cloud.google.com. Log in met het Google-account dat de integratie gaat beheren. De UI van Google Cloud Console kan in details veranderen, maar de hoofdstappen blijven hetzelfde.

2.1 Maak een Google Cloud-project aan

Klik linksboven op de project-picker (naast het Google Cloud-logo) en kies NEW PROJECT. Kies No Organisation als je geen Google Workspace gebruikt, geef het project een herkenbare naam (bijvoorbeeld Bloomsite GCal) en klik op CREATE.

2.2 Schakel de Google Calendar API in

Open na het aanmaken het hamburger-menu (☰ linksboven) en ga naar APIs & Services → Library. Typ google calendar api in de zoekbalk, open Google Calendar API en klik op Enable.

2.3 Maak OAuth-gegevens aan

Klik rechtsboven op Create Credentials (of via APIs & Services → Credentials → + Create Credentials → OAuth client ID). Kies bij API de optie Google Calendar API, bij Type of data de optie User Data en klik op Next.

Vul vervolgens de app-informatie in: een App name (bijvoorbeeld Bloomsite GCal) en in beide e-mailvelden (User support email en Developer contact information) je eigen e-mailadres. Klik op Save and Continue.

2.4 Vul de Redirect URI in

Op het Scopes-scherm klik je direct op Save and Continue (geen wijzigingen nodig). Kies daarna bij Application type de optie Web Application, geef de client een naam, en plak onder Authorized redirect URIs de URI die je in stap 1 in Bloomsite kopieerde. Klik op Create.

Let op: dit moet het veld Authorized redirect URIs zijn (niet JavaScript origins). De Redirect URI moet exact overeenkomen met de waarde uit Bloomsite — een puntkomma of trailing slash extra/te weinig zorgt al voor een mislukte koppeling.

2.5 Kopieer Client ID en Client Secret

Google toont nu een pop-up met je Client ID. Kopieer deze waarde.

Heb je de pop-up gesloten, ga dan terug naar APIs & Services → Credentials, klik onder OAuth 2.0 Client IDs op je app-naam en kopieer daar zowel Client ID als Client Secret.

3. Plak je gegevens terug in Bloomsite
   Ga terug naar de Bloomsite-pagina uit sectie 1. Plak je Client ID in het Klant-ID1-veld en je Client Secret in het Clientgeheim2-veld. Bevestig daarna via de Opslaan-knop onderaan dat scherm.

   

2.6 Zet de app op Production

Open in Google Cloud Console het menu en ga naar APIs & Services → OAuth consent screen → Audience. Klik onder Publishing Status op Publish app en bevestig met Push to production?. Zonder deze stap blijft de app in Testing-modus en kunnen alleen handmatig toegevoegde testers koppelen.

3. Bloomsite: koppel een medewerker aan zijn of haar Google Agenda

Nu de site-brede koppeling staat, koppelt elke medewerker zijn of haar eigen Google-account vanuit het bewerkscherm. De medewerker logt zelf in — Bloomsite slaat geen wachtwoorden op.

1. Open Medewerkers
   Klik vanuit Instellingen op de kaart Medewerkers om naar de personeelslijst te gaan.

   

2. Open het bewerkscherm van een medewerker
   Klik op de regel van een medewerker in de lijst — het detail-paneel schuift aan de rechterkant open. Klik daarin op Medewerker bewerken om naar het volledige bewerkscherm te gaan.

   

3. Open het Integraties-tabblad
   Klik in de linker navigatie op het tabblad Integraties om naar het scherm met externe agenda-koppelingen te gaan.

   

4. Open het Google Agenda-detailscherm
   De medewerker klikt op de Google Agenda-kaart om het detailscherm te openen.

   

5. Klik op Verbinden
   Op het detailscherm klikt de medewerker op de Verbinden-knop om de Google-OAuth-popup te starten.

   

Na de klik opent een Google-loginpopup. De medewerker kiest daar het juiste Google-account, controleert de gevraagde rechten (Bloomsite leest beschikbaarheid en schrijft afspraken in de gekozen agenda) en bevestigt met de Toestaan-knop van Google. Na de bevestiging keert hij of zij terug naar het detailscherm — de kaart toont nu Verbonden, met daaronder een keuzelijst voor de agenda waarin nieuwe afspraken geplaatst worden en een tweede lijst voor de agenda's die op beschikbaarheid gecheckt worden. Eén medewerker kan op deze manier maximaal zes Google-accounts koppelen.

Klaar — de koppeling is nu actief. Elke nieuwe boeking voor deze medewerker verschijnt automatisch in zijn of haar Google Agenda, en bestaande blokkades in Google worden gerespecteerd bij het tonen van vrije tijden in het boekingsformulier.