# Installeer en configureer de Zivver Chrome Extension

Volg de stappen in de aangegeven volgorde om Zivver met Gmail te gebruiken. Deze instructies leggen uit hoe je als Google Super Admin de Zivver Chrome-extensie voor Google Workspace installeert, zodat gebruikers Zivver-berichten kunnen verzenden en ontvangen in Gmail.

## Installatie en configuratie van de Zivver Chrome-extensie

Het instellen van de Zivver Chrome-extensie bestaat uit twee stappen. Zorg ervoor dat je beide stappen uitvoert om Zivver met Gmail te kunnen gebruiken.

1. **Installeer de Zivver Chrome-extensie**  
2. **Maak een serviceaccount aan voor de Zivver Chrome-extensie**

**Zorg ervoor dat je vóór de installatie aan de volgende technische vereisten voldoet**:

- Super Admin-rechten in de [Google Cloud Platform Console](https://console.cloud.google.com/) en de [Google Beheerdersconsole](https://admin.google.com/).
- Zivver-beheerdersrechten.

Tip  
Bekijk onze [installatie-instructievideo](https://youtu.be/V2e83j_EtYs)

## Installeer de Zivver Chrome-extensie

**Stappen**

1. Log in met je beheerdersgegevens op de [Google Beheerdersconsole](https://admin.google.com/) van je organisatie.

2. _Optioneel_: Je kunt de Zivver-extensie beschikbaar maken voor een specifieke groep gebruikers in plaats van voor je hele organisatie — bijvoorbeeld een bepaald team of een pilotgroep. Maak hiervoor eerst een nieuwe organisatie-eenheid (OE) aan en wijs de betreffende gebruikers eraan toe.

Opmerking  
Onderliggende organisatie-eenheden (OE’s) nemen apps automatisch over van hun bovenliggende OE, tenzij je overerving uitschakelt voor de onderliggende OE. Zie de Google-pagina [Hoe de organisatiestructuur werkt](https://support.google.com/a/answer/4352075?hl=nl) voor meer informatie.

3. Ga in het navigatiemenu links naar **Apparaten > Chrome > Apps en extensies > Gebruikers en browsers**.

4. Selecteer de OE waaraan je de extensie wilt toewijzen.

5. Beweeg de muis over het **+**-icoon rechtsonder en selecteer **Chrome-app of -extensie toevoegen met de ID**.

6. Voer de ID van de Zivver-extensie in: `kckcdkheokdjcdgdfmpkgppflhdbmmhl`. Klik vervolgens op OPSLAAN.

Zivver verschijnt nu in de lijst met geïnstalleerde apps en extensies.

7. Pas het installatiebeleid aan.  
Gebruik het dropdownmenu aan de rechterkant om **Afgedwongen installeren** te selecteren.

8. Klik rechtsboven op OPSLAAN.

**Wat je daarna moet doen**  
Ga verder met [**Maak een serviceaccount aan voor de Zivver Chrome-extensie**](https://docs.zivver.com/nl/admin/gmail/install-and-configure-the-zivver-chrome-extension.html#create-a-service-account-for-the-zivver-chrome-extension).  
**Deze stap is essentieel** om de extensie goed te laten functioneren.

## Maak een serviceaccount aan voor de Zivver Chrome-extensie

Na het installeren van de Zivver Chrome-extensie maak je een serviceaccount aan om toegang te verlenen aan je gebruikers.

Je hebt een Google Workspace-account nodig om de Zivver Chrome-extensie te gebruiken.

### Een project aanmaken

**Technische vereisten**

Opmerking  
Zorg dat je de Zivver Chrome-extensie succesvol hebt geïnstalleerd. Zie [**Zivver Chrome-extensie installeren**](https://docs.zivver.com/nl/admin/gmail/install-and-configure-the-zivver-chrome-extension.html#install-the-zivver-chrome-extensie).

- Super Admin-rechten in de [Google Cloud Platform Console](https://console.cloud.google.com/) en [Google Admin Console](https://admin.google.com/)
- Zivver-beheerdersrechten

**Procedure**

1. Ga naar de [Google Cloud Platform Console](https://console.cloud.google.com/) en log in.

2. Klik bovenaan het scherm op de naam van je organisatie.

3. Klik in het pop-upvenster op New project.

4. Geef het project een naam die aansluit bij het doel.  
De velden **Organization** en **Location** moeten de naam van je organisatie bevatten.  
_Voorbeeld: Zivver_

5. Klik op **Create**.  
Het project is nu aangemaakt. Het projectdashboard verschijnt.

### Gmail API inschakelen voor het project

**Procedure**

1. Selecteer dit project in het dropdownmenu naast het Google Cloud-pictogram.

2. Ga in het linkerpaneel naar **APIs and services > Library**.

3. Typ _Gmail API_ in de zoekbalk van de API-bibliotheek en selecteer deze uit de lijst.  
Je wordt doorgestuurd naar de startpagina van de **Gmail API**.

4. Klik op Enable.

De Gmail API is nu ingeschakeld voor je project.

### Serviceaccount aanmaken

1. Ga naar **Credentials** en klik op _add_ Create credentials.

2. Selecteer in het dropdownmenu **Service account**.

3. Geef de serviceaccount een duidelijke naam.  
**Voorbeeld**: Zivver

4. Klik op **Done**.  
De serviceaccount verschijnt onderaan het scherm met een e-mailadres dat eindigt op `gserviceaccount.com`.

5. Klik op het e-mailadres van de serviceaccount.

6. Ga naar het tabblad **Keys** en klik op Add key _arrow_drop_down_.

Tip

Heb je problemen met het aanmaken van een nieuwe sleutel? Dan heeft je account waarschijnlijk niet de vereiste rechten. Zie [Google Cloud-beleidsinstellingen aanpassen](https://docs.zivver.com/nl/admin/gmail/troubleshooting/modify-google-cloud-policy.html) voor instructies om de juiste machtigingen toe te kennen.

7. Selecteer **Create new key**.

Er verschijnt een pop-up waarin je het type sleutel moet kiezen.

8. Kies het type **JSON** en klik op Create.

Je wordt gevraagd om de privésleutel op te slaan in een JSON-bestand.  
Na het aanmaken van de serviceaccount genereer je een sleutel om toegang te krijgen tot deze serviceaccount en je Gmail-omgeving. Je hebt deze sleutel maar één keer nodig, tenzij je hem per ongeluk verwijdert in Zivver.

De sleutel wordt opgeslagen in een JSON-bestand dat Zivver versleutelt. Let op: je kunt dit bestand later niet opnieuw downloaden — sla het dus veilig op en zorg dat alleen geautoriseerde personen er toegang toe hebben.

9. Klik op het tabblad **Details**.

10. Klik op **Advanced Settings**.

11. Kopieer de Client-ID.

**Wat nu?**  
Gebruik de Client-ID in de volgende sectie.

### Verbind de serviceaccount met de Google Workspace-omgeving

**Voor je begint**  
Je hebt de client-ID gekopieerd naar het klembord van je besturingssysteem. Zie [**Serviceaccount aanmaken**](https://docs.zivver.com/nl/admin/gmail/install-and-configure-the-zivver-chrome-extension.html#create-the-service-account).

**Procedure**

1. Ga naar de [Google Admin Console](https://admin.google.com/).

2. Klik op **Beveiliging > Toegangs- en gegevensbeheer > API-functies**.

3. Klik op DOMEINBREDE MACHTIGEN BEHEREN.

4. Klik op **Nieuw toevoegen**.

5. Plak bij **Client-ID** de client-ID die je eerder hebt gekopieerd.

6. Vul bij OAuth-scopes (komma-gescheiden) het volgende in:

`https://www.googleapis.com/auth/gmail.insert`

7. Klik op **AUTORISEREN**.

Je hebt nu API-machtigingen ingesteld voor de serviceaccount.

**Problemen oplossen**

Opmerking  
Als er een fout optreedt, is de client-ID mogelijk onjuist, bestaat er al een serviceaccount met die ID, of is de opgegeven scope niet ondersteund.

## Stel de serviceaccount-sleutel in Zivver in

**Procedure**

1. Ga naar de pagina [Google Workspace-instellingen](https://app.zivver.com/admin/google-workspace-settings) in de Zivver WebApp.

2. Open het JSON-bestand uit de [serviceaccountsectie](https://docs.zivver.com/nl/admin/gmail/install-and-configure-the-zivver-chrome-extension.html#create-the-service-account) in een teksteditor op je computer.

3. Klik op Voeg een sleutel toe.

4. Plak de volledige inhoud van het bestand in het tekstvak bij **Google Workspace Service-accountsleutel**.

5. Klik op Opslaan.

Het tekstvak verdwijnt dan om veiligheidsredenen. Je ziet nu alleen de knoppen Bewerken en Verwijderen. Gebruik deze knoppen niet, tenzij je bijvoorbeeld migreert naar een andere Google-omgeving.

6. Als je de oranje waarschuwing  Er zijn x gebruiker(s) die geen toegang hebben tot de servicesleutel. Als gevolg hiervan kunnen ze de Chrome-extensie niet gebruiken voor Gmail. ziet, klik je op Verleen nu toegang.

Daarna kunnen alle gebruikers zich authenticeren met de Serviceaccount-sleutel.

Info  
Je moet toegang verlenen tot de servicesleutel voor elk account dat **handmatig** is aangemaakt in Zivver.

Gebruikers die zijn aangemaakt met de Zivver Synctool krijgen automatisch toegang tot de service key, dus er is geen extra actie voor hen vereist.

**Je Zivver Chrome Extension (wanneer uitgerold) is nu klaar voor gebruik.**

## Verleen toegang tot de Zivver Chrome Extension

**Over deze taak**

Als je een gebruiker hebt aangemaakt zonder de Zivver Synctool, moet je die gebruiker handmatig toegang geven tot de Zivver Chrome Extension op de pagina Google Workspace-instellingen. Gebruikers zonder toegang zien dit bericht in het Zivver-paneel in Gmail:

`Zivver is not set up correctly, speak to your administrator`

**Procedure**

1. Ga naar de pagina [Google Workspace-instellingen](https://app.zivver.com/admin/google-workspace-settings) in de Zivver WebApp.

2. Klik op Verleen nu toegang in de oranje waarschuwing  Er zijn x gebruiker(s) die geen toegang hebben tot de servicesleutel. Als gevolg hiervan kunnen ze de Chrome-extensie niet gebruiken voor Gmail..

**Na het vernieuwen van de pagina kunnen de gebruikers de Zivver Chrome Extension gebruiken.**

Laatst bijgewerkt op 2026-06-18