Koppelen met een Microsoft 365-mailbox via de Graph API

Beschikbaarheid

Dit artikel is van toepassing op de volgende koppeling(en):

Inleiding

Je kan in Elvy een Microsoft 365-mailbox koppelen via de Microsoft Graph API. Dit is te gebruiken voor mailboxen die binnen een Azure/Entra-omgeving zijn aangemaakt. 

Aanmaken authenticatie

Ga in Elvy naar het menu Instellingen > Instellingen, Tabblad Authenticatie

Druk op Toevoegen.

Vul de Omschrijving van de authenticatieregel in. Kies bij Soort voor Microsoft Azure - eMail (Graph) en selecteer als Type de optie Azure - OAuth 2.0. Je mag bij Gebruikersnaam het e-mailadres invullen, maar dit is niet verplicht.

Druk vervolgens op Opnieuw autoriseren en daarna op Ja, wanneer gevraagd wordt of de verbindingsgegevens wilt herstellen.

Autoriseren

Om de koppeling met een mailbox tot stand te brengen, heb je één van de volgende Azure-accounts nodig:

1. Een account voor de mailbox zelf (hiervoor moet een wachtwoord op de mailbox worden ingesteld)
2. Een gebruikersaccount met volledige toegang tot de mailbox

Vanaf Elvy 2103 wordt een extra scherm getoond waarin je de webbrowser kan kiezen waarin je het autorisatieproces wil doorlopen:

Zodra je de webbrowser gekozen hebt, wordt de inlogpagina van Microsoft geopend, waar je inlogt met een account wat toegang heeft tot de mailbox die in Elvy gekoppeld zal worden.

Wanneer je hier bent ingelogd, krijg je de volgende melding te zien:

Druk hier op Accepteren. Je krijgt vervolgens in Elvy de melding dat de autorisatie succesvol is. 

Let op: Het is niet mogelijk om dit proces te doorlopen, als in Azure/Entra is ingesteld dat, 'Beheerderstoestemming' vereist is. Het account waarmee de autorisatie wordt uitgevoerd, moet direct (in de bovenstaande stap) de machtigingen kunnen verlenen.

Permissies

In de Elvy Mail Connector zijn de volgende permissies ingesteld:

Hiermee kan Elvy de volgende acties uitvoeren:

• E-mailberichten lezen uit de (gedeelde) mailbox en bijlagen hieruit downloaden
• E-mailberichten verplaatsen binnen de (gedeelde) mailbox
• Verwerkingsbevestigingen versturen

Mailbox uitlezen

Wanneer de koppeling succesvol is geautoriseerd, kan deze gebruikt worden in een serviceregel binnen Elvy:

Selecteer bij Type de authenticatieregel die je eerder hebt aangemaakt. Wanneer je een gedeelde mailbox wil uitlezen, vul je het e-mailadres van deze mailbox in bij Gebruikersnaam.

Door op de knop achter Bronmap te drukken, worden alle mappen binnen de (gedeelde) mailbox opgehaald. Hier kun je vervolgens kiezen welke map wordt uitgelezen, en naar welke mappen de verwerkte en onverwerkte e-mails verplaatst worden.

Lees meer over het uitlezen van de mailbox in het volgende artikel: Hoe laat ik Elvy een mailbox uitlezen?