Finly synchroniseert agenda's met Outlook via de Microsoft Graph API. Voor deze koppeling heb je een Azure-app nodig die drie gegevens oplevert: een tenantId, clientId en clientSecret. Daarnaast activeer je per medewerker de synchronisatie.
Hoe werkt de koppeling?
Finly gebruikt de Microsoft Graph API om agenda-informatie op te halen en bij te houden. De verbinding loopt via een app die je aanmaakt in het Azure-portaal van je organisatie. Die app vertegenwoordigt Finly en krijgt beperkte, gerichte rechten op de agenda's van medewerkers.
Zodra de koppeling actief is, haalt Finly automatisch beschikbaarheid op en verwerkt wijzigingen in Outlook via een push-abonnement. Nieuw geplande afspraken via Finly verschijnen ook direct in de Outlook-agenda van de medewerker.
Stap 1. Een app aanmaken in het Azure-portaal
Log in op het Azure-portaal en ga naar Azure Active Directory > App-registraties.
Klik op "Nieuwe registratie" en geef de app een herkenbare naam.
Na aanmaken vind je de tenantId en clientId op de overzichtspagina van de app.
Ga naar "Certificaten en geheimen" en maak een nieuw clientgeheim aan. Noteer de waarde direct. Dit is de clientSecret.
Stap 2. API-rechten toekennen
Ken aan de app de volgende Microsoft Graph-rechten toe als applicatierechten (Application permissions, niet Delegated):
Calendars.Read. Voor het uitlezen van agenda-items en beschikbaarheid.
Users.Read.All. Voor het ophalen van gebruikersgegevens die nodig zijn voor de koppeling.
Klik na het toevoegen op "Beheerderstoestemming verlenen", zodat de rechten actief worden binnen de tenant.
Stap 3. Gegevens invoeren in Finly
Ga naar Instellingen > Agenda > Synchronisatie en voer de tenantId, clientId en clientSecret in. Sla de gegevens op. Finly kan nu verbinding maken met de Microsoft Graph API.
Stap 4. Synchronisatie activeren per medewerker
Ga naar Instellingen > Agenda > Medewerkers en open de betreffende medewerker. Zet "Synchroniseren met Outlook" op "Ja", controleer het Microsoft-account en sla op. Finly begint direct met ophalen.
Let op: een medewerker heeft ook een rooster nodig voordat Finly beschikbaarheid kan berekenen. Zie Roosters van medewerkers instellen in de agendamodule.
Outlook-sync controleren en resetten
Als een medewerker niet actief is of de synchronisatie niet correct draait, is dat zichtbaar in het medewerkersbeheer. Je ziet daar de synchronisatiestatus per medewerker. Verloopt de sync niet goed? Voer dan een sync-reset uit. Finly haalt dan alle agenda-informatie opnieuw op uit Outlook.
Outlook-token herkoppelen
Heeft een medewerker geen synchronisatie meer, bijvoorbeeld na een wachtwoordwijziging of verlopen token? Ga dan naar Instellingen > Gebruikers en open de betreffende medewerker. Kies daar voor "Herkoppel Outlook-account". Let op: deze actie vereist de juiste beheerdersrechten.
E-mailadres van medewerker gewijzigd
Heeft een medewerker een nieuw inlogadres of Microsoft-account gekregen? Dan moet de Outlook-koppeling opnieuw worden ingesteld. Zonder deze stap treden twee problemen op:
Synchronisatie werkt maar één richting. Afspraken van Finly komen wel in Outlook, maar Outlook-afspraken komen niet meer in Finly.
Oud e-mailadres staat als organiser. Afspraken die via Finly worden aangemaakt, tonen het oude adres als organiser in Outlook.
Stappen na een e-mailadreswijziging:
Ga naar Instellingen > Gebruikers en open de betreffende medewerker.
Pas het Microsoft-account aan naar het nieuwe e-mailadres.
Klik op "Herkoppel Outlook-account".
Ga daarna naar Instellingen > Agenda > Medewerkers, open de medewerker en controleer of het juiste Microsoft-account staat ingesteld.
Sla op. De sync wordt opnieuw opgebouwd.
Let op: alleen een beheerder met de juiste rechten kan dit uitvoeren.
Veelvoorkomende foutmeldingen
"No availability found". Geen rooster gekoppeld aan de medewerker. Voeg een standaardrooster toe via Instellingen > Agenda > Medewerkers.
"Outlook sync failed". Het Outlook-token is verlopen. Ga naar Instellingen > Gebruikers en kies "Herkoppel Outlook-account" voor de betreffende medewerker.
"Double booking". Kamers zijn niet uniek ingesteld. Controleer de kamerinstellingen en zorg dat elk mailadres aan maximaal één kamer is gekoppeld.
Foutmelding zichtbaar bij medewerker. De Outlook-synchronisatie wordt opgehaald via Azure. Als de Azure-instellingen niet correct zijn geconfigureerd, kan Finly de sync niet ophalen. Geef de foutmelding door aan de beheerder van je organisatie.
Terugkerende afspraak uit Outlook niet direct zichtbaar in Finly. Bij een terugkerende afspraak moet de volledige reeks worden opgehaald. De blokken verschijnen vanzelf zodra de synchronisatie de reeks volledig heeft verwerkt.
Periodieke monitoring
Controleer regelmatig de status van Outlook-koppelingen in het medewerkersbeheer. Verlopen tokens leiden tot stille synchronisatiefouten: de agenda wordt niet meer bijgewerkt maar er verschijnt geen directe melding voor de gebruiker. Plan dit als periodieke beheertaak in, zeker na organisatiewijzigingen, e-mailadreswijzigingen of wachtwoordvernieuwingen.
Aandachtspunten voor de IT-organisatie
Het toekennen van beheerderstoestemming voor API-rechten vereist doorgaans een Azure-beheerder.
De organisatie bepaalt zelf welke consequenties het aanmaken van een app-registratie heeft binnen het eigen beleid.
Clientgeheimen hebben een verloopdatum. Zorg dat je dit bewaakt en op tijd verlengt om te voorkomen dat de synchronisatie stopt.
Veelgestelde vragen
Wat gebeurt er als het clientgeheim verloopt?
De synchronisatie stopt. Je ziet dit in het medewerkersbeheer doordat medewerkers als niet-syncend worden weergegeven. Maak in Azure een nieuw clientgeheim aan, update de waarde in Finly en de sync herstart automatisch.
Kan ik de synchronisatie testen voordat ik hem breed uitrol?
Ja. Zet de synchronisatie eerst aan voor één testmedewerker. Controleer of afspraken correct verschijnen en of blokkades in Outlook worden verwerkt. Rol daarna pas breed uit.
Een medewerker staat als organiser vermeld met een oud e-mailadres. Hoe los ik dit op?
Dit gebeurt wanneer het Microsoft-account in de Finly-koppeling nog naar het oude adres verwijst. Pas het account aan via Instellingen > Gebruikers en klik daarna op "Herkoppel Outlook-account". Controleer ook de instellingen bij Instellingen > Agenda > Medewerkers.
Zoekwoorden
Outlook synchronisatie, Microsoft Graph API, Azure app, tenantId, clientId, clientSecret, agendakoppeling, agenda sync, Microsoft 365, medewerker sync, push-abonnement, Calendars.Read, foutmelding sync, token verlopen, No availability found, Outlook sync failed, double booking, monitoring, e-mailadres gewijzigd, organiser oud adres, Azure instellingen, terugkerende afspraak