Navigeer in Zenvoices in de betreffende administratie naar Beheer / Administratie / Kanalen

Kies rechtsboven voor Nieuw kanaal

Selecteer E-mail en vervolgens voor Volgende

Kies bovenin voor het tabje Instellingen

Selecteer bij categorie E-mail instellingen de Protocol (POP3/IMAP) en voer de gegevens in die uit de eigen e-mailserver te raadplegen zijn.
​

Ga naar https://console.cloud.google.com/ en login met het g-mailaccount dat met Zenvoices gekoppeld moet worden

Kies linksboven voor de button Select a project en kies in het nieuwe venster rechtsboven voor New project

Geef voor het veld Project name een herkenbare naam. Bijvoorbeeld: Zenvoices koppeling

Bevestig dit project met de Create button

Kies opnieuw bovenin voor de button Select a project en kies het project dat zojuist aangemaakt is

Open het menu met de button met de horizontale strepen linksboven

Navigeer naar APIs & Services / Libary

Typ in zoekveld: Gmail API en open deze tool

Kies linksboven voor de button: Enable (het laden kan enkele seconden duren)

Kies linksboven in het menu voor: OAuth consent screen en vervolgens voor Get started
​
​Project Configuration

· App Information: Geef voor het veld App name een herkenbare naam. Bijvoorbeeld: Zenvoices koppeling. Selecteer bij User support email het e-mailadres dat met Zenvoices gekoppeld met worden. Bevestig dit met de button Next

· Audience: Selecteer external en bevestig dit met de button Next

· Contact information: Geef het e-mailadres op dat met Zenvoices gekoppeld moet worden en bevestig dit met de button Next

· Finish: Bevestig de stappen door dit veld te selecteren. Bevestig dit met de button Continue

- Rond bovenstaande stappen af met de button Create
​
​Branding
· Kies linksboven in het menu voor: Branding

· Typ in het veld Application homepagina de volgende url:
​ https://app.zenvoices.com

· Kies voor de button + Add Domain en typ de volgende url: zenvoices.com

· Bevestig dit met de button Save

​Audience

· Kies linksboven in het menu voor: Audience

· Kies voor de button Add users

· In het scherm wordt rechts een veld geopend. Typ in dit veld het e-mailadres dat met Zenvoices gekoppeld moet worden en bevestig dit met de button Save
​
​Clients

· Kies linksboven in het menu voor: Clients

· Kies boven in het submenu voor: Create client

· Open het veld Application type en selecteer uit de keuzelijst: Web application

· Typ in het veld Name een herkenbare naam. Bijvoorbeeld: Zenvoices koppeling

· Kies bij Authorized JavaScript origins de button Add URI en typ in het veld:
​ https://app.zenvoices.com

· Kies bij Authorized redirect URIs de button Add URI en typ in het veld:
​https://app.zenvoices.com/ChannelConnector/ProcessGmailIMAPAuthorizationResult

· Bevestig dit met de button Create

· kies in de nieuwe button rechtsonder voor OK

​Data Access

· Kies linksboven in het menu voor: Data Access

· Kies voor de button Add or remove scopes zodat rechts de rechten worden geopend

· Typ in het zoekveld: Gmail.readonly en kies voor Enter (zie afbeelding)
​

· Selecteer het recht dat gevonden wordt
· Bevestig dit recht met de button Update onderin

Kies linksboven in het menu voor: Clients

Kies voor het project dat net aangemaakt is (in dit voorbeeld: Zenvoices koppeling)
​
​Zenvoices

Open in de webbrowser een nieuw tabblad en open Zenvoices: https://app.zenvoices.com

Open de administratie waarmee het Gmail-account gekoppeld moet worden

Navigeer naar Beheer / Administratie / Kanalen en kies rechtsboven voor Nieuw kanaal

Selecteer E-mail en kies voor Volgende

Type in het veld Naam het e-mailadres waarmee gekoppeld wordt

Kies bovenin voor het tabje Instellingen

Open het veld Protocol en selecteer uit de keuzelijst: IMAP

Open het veld Authenticatie type en selecteer uit de keuzelijst: Gmail OAuth2

Voer in de velden Client id en Client secret de gegevens in die in het andere tabje te raadplegen zijn (zie afbeelding)
​

Voer in het veld Gebruikersnaam het e-mailadres van Gmail in

Kies voor Opslaan
​
​Bevestigen

Er wordt een Popup geopend om het te bevestigen, kies voor Ja

Er wordt doorgelinkt naar de E-mailinstellingen, selecteer hier het e-mailadres waarmee gekoppeld moet worden

Kies daarna telkens voor volgende en/of doorgaan totdat er weer wordt teruggelinkt naar Zenvoices waar de autorisatie bevestigd wordt

Rond af met Opslaan
​

Navigeer in Zenvoices naar Beheer / Administratie / Kanalen

Kies bij de kanaal dat zojuist is toegevoegd voor de button om documenten op te halen

​

​

Kies boven in het menu voor Uploaden & Inlezen, waar de opgehaalde documenten te raadplegen zijn

Navigeer in Zenvoices in de betreffende administratie naar Beheer / Administratie / Kanalen

Kies rechtsboven voor Nieuw kanaal

Selecteer E-mail en vervolgens voor Volgende

Kies bovenin voor het tabje Instellingen

Selecteer in het veld Protocol: IMAP

Selecteer in het veld Authenticatie type: Entra OAuth2​
​

​Open in de Entra omgeving 'Business apps', 'All applications' en zoek 'Zenvoices IMAP'.

Kies voor Create en ken een gebruiker toe via 'Assign users and groups'

Kies bovenin voor 'Add user/group' onder 'Users' voor 'None Selected', selecteer het e-mailadres waarmee je de e-mailaccount koppeling mee wil maken

Kies onderin voor 'Assign'

Kies links in het menu voor 'App registrations'

kies voor 'Zenvoices IMAP'

Kopieer de gegevens die staan in het veld: 'Directory (tenant) ID' en plak deze in Zenvoices in het veld Map-id (tenant-id):

Kopieer de gegevens die staan in het veld: 'Application (client) ID' en plak deze in Zenvoices in het veld Client Id

Kies bij Client credentials voor Add certificate or secret

Kies voor New client secret

Geef bij Description een eigen naam (bijvoorbeeld: Zenvoices)

Kies bij Expires een datum.
​Let op: oneindig wordt helaas niet ondersteund. Het advies is om een datum van zover mogelijk in de toekomst te kiezen en rond die tijd de datum weer te verlengen.

Kies voor Add en kopieer de gegevens die staan in het veld 'Value'
​Let op: gegevens zijn eenmaal zichtbaar

Plak deze in Zenvoices in het veld Client secret.

Zet in Zenvoices in het veld Gebruikersnaam het e-mailadres waar het e-mailaccount aan gekoppeld moet worden
​

Kies voor Opslaan
​Let op: Er moet op dat moment in Entra ingelogd zijn in het Microsoft e-mailaccount dat is ingevuld (dit om te voorkomen dat als er ingelogd is in een ander account, deze als koppelaccount gezocht wordt).

Selecteer het juiste e-mailaccount en geef na het kiezen van de juiste app rechten voor Accepteren.​​