Install and configure the Zivver Chrome Extension

To use Zivver with Gmail, follow the steps in the specified order. These instructions explain how to install the Zivver Chrome Extension for Google Workspace as a Google Super Admin, allowing users to send and receive Zivver messages in Gmail.

Installation and configuration of the Zivver Chrome Extension

Setting up the Zivver Chrome Extension consists of two steps. Make sure to complete both steps to use Zivver with Gmail.

  1. Install the Zivver Chrome Extension
  2. Create a service account for the Zivver Chrome Extension

Before you begin, make sure that you meet the following technical requirements:

Install the Zivver Chrome Extension

Procedure

  1. Log in with your admin credentials to your organization’s Google Workspace Google Admin Console.

  2. Optional: You can make the Zivver extension available only to a specific group of users instead of your entire organization — for example, a specific team or pilot group. To do this, first create a new organizational unit (OU) and assign the relevant users to it.

Note
Child organizational units automatically inherit apps from their parent unless you disable inheritance for the child OU. For background information, refer to the Google page How the organizational structure works.
  1. From the navigation menu on the left, go to Devices > Chrome > Apps & Extensions > Users & Browsers.

    image

  2. Select the OU to which you want to assign the extension.

    image

  3. Hover over the + icon at the bottom-right corner and select Add Chrome app or extension by ID.

    image

  4. Enter the ID of the Zivver extension: kckcdkheokdjcdgdfmpkgppflhdbmmhl. Then click .

    image

Zivver will now appear in the list of installed apps and extensions.

  1. Change the installation policy. Use the dropdown menu on the right to select Force install.

    image

  2. Click in the top-right corner.

    image

What to do next

Continue with Create a Service Account for the Zivver Chrome Extension. This is a critical step for the extension to function.

Create a service account for the Zivver Chrome Extension

After installing the Zivver Chrome Extension, create a service account to grant access to your users.
You must have a Google Workspace account to use the Zivver Chrome Extension.

Create a project

Technical requirements

Note
Make sure that you successfully installed the Zivver Chrome Extension. Refer to Install the Zivver Chrome Extension.

Procedure

  1. Go to the Google Cloud Platform Console and sign in.

  2. Click your organization’s name at the top of the screen.

    image

  3. In the pop-up that appears, click .

    image

  4. Give the project a name that fits its purpose.
    The fields Organization and Location must contain the name of your organization.
    Example: Zivver

  5. Click CREATE.
    You have now created a project. The project dashboard will appear.

Enable Gmail API for the project

Procedure

  1. Select this project in the dropdown next to the Google Cloud icon.

    image

  2. In the left panel, go to API’s & Services > Library.

    image

  3. Enter Gmail API in the API Library search bar and select it from the list.
    You will be redirected to the Gmail API landing page.

  4. Click .

    image

You have now enabled the Gmail API for your project.

Create the service account

  1. Go to Credentials and click .

  2. In the dropdown menu, select Service account.

    image

  3. Give the service account a descriptive name.
    Example: Zivver

  4. Click DONE.
    The service account will appear at the bottom of the screen with an email address that ends with gserviceaccount.com.

  5. Click on the email address for the service account.

    image

  6. Go to the KEYS tab, then click .

    Tip
    If you have trouble creating a new key, your account probably does not have the required permissions. See Modify Google Cloud Policy for instructions on how you can grant your account the required permissions.

  7. Select Create new key.

    image

A popup will appear asking you to select the key type.

  1. Choose the JSON key type and click .


    image

You will be prompted to save the private key in a JSON file.
After creating the service account, you will generate a key to access this service account and your Gmail environment. You will only need the key once unless you accidentally remove it in Zivver.
The key is stored in a JSON file, and Zivver encrypts that file. However, neither Google nor Zivver allow you to download the file again, so make sure to store the file in a secure location where only authorized persons can access it.

  1. Still on the Service account details page, click Advanced settings.

  2. Copy the Client ID.

    image

What to do next

Use the Client ID in the next section.

Connect the service account to the Google Workspace environment

Before you begin

You copied the client ID to the clipboard of your operating system. Please refer to Create the service account.

Procedure

  1. Go to the Google Admin Console.

  2. Click Security > Access and data control > API controls.

  3. Click .

    image

  4. Click Add new.

  5. At Client ID, paste the client ID that you copied.

  6. At OAuth scopes (comma-delimited), write this:
    https://www.googleapis.com/auth/gmail.insert

  7. Click AUTHORIZE.
    You now set API permissions for the service account.

Troubleshooting

Note
If an error occurs, the client ID might be incorrect, there might be a duplicate service account, or the scope is unsupported.

Configure the service account key in Zivver

Procedure

  1. Go to the Google workspace settings page in the Zivver WebApp.

  2. Open the JSON file from the service account section in a text editor on your computer.

  3. Click .

  4. Paste the full content of the file in the text box at Google Workspace Service Account Key.

  5. Click .
    The text box then disappears for security reasons. You now only see the and buttons. Do not use these buttons, unless, for example, you migrate to a different Google environment.

  6. If you see the orange warning There are x user(s) that cannot access the service key. As a result, they will not be able to use the Chrome Extension for Gmail., click .


    image

    Then, all the users can authenticate with the Service Account key.

    Info
    You need to grant access to the service key for every account that is manually created in Zivver.
    This is not necessary for users created with the Zivver Synctool, as they are automatically granted access to the service key.

Your Zivver Chrome Extension (when deployed) is now ready to use.

Grant access to the Zivver Chrome Extension

About this task

If you created a user without the Zivver Synctool, you must grant them access to the Zivver Chrome Extension on the Google workspace settings page. Users without access see this message in the Zivver pane in Gmail:
Zivver is not set up correctly, speak to your administrator

Procedure

  1. Go to the Google workspace settings page in the Zivver WebApp.
  2. Click in the orange warning There are x user(s) that cannot access the service key. As a result, they will not be able to use the Chrome Extension for Gmail..

After a page refresh, the users can use the Zivver Chrome Extension.