Het CRM 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 moet je per medewerker de synchronisatie activeren.
Hoe werkt de koppeling?
Het CRM 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 het CRM en krijgt beperkte, gerichte rechten op de agenda's van medewerkers.
Zodra de koppeling actief is, haalt het CRM automatisch beschikbaarheid op en verwerkt wijzigingen in Outlook via een push-abonnement. Nieuw geplande afspraken via het CRM 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 het CRM
Ga naar Instellingen. Agenda. Synchronisatie en voer de tenantId, clientId en clientSecret in. Sla de gegevens op. Het CRM 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. Het CRM begint direct met ophalen.
E-mailadres van medewerker gewijzigd
Heeft een medewerker een nieuw inlogadres of Microsoft-account gekregen? Dan moet de Outlook-koppeling opnieuw worden ingesteld. Zonder dit stap treden twee problemen op:
Synchronisatie werkt maar één richting. Afspraken van het CRM komen wel in Outlook, maar Outlook-afspraken komen niet meer in het CRM.
Oud e-mailadres staat als organiser. Afspraken die via het CRM worden aangemaakt, tonen het oude adres als organiser in Outlook. Dit komt doordat de koppeling nog op het oude account staat.
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.
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 het CRM 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 CRM-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, inlogadres aangepast