Configuring Voicemail Sync for G Suite

MiCloud Decision Makers and Phone Managers can enable MiCloud voicemail synchronization for G Suite. When MiCloud voicemail synchronization for G Suite is enabled, users on your account can manage their MiCloud voicemail boxes from their business Gmail accounts. 

The following features are available with MiCloud voicemail synchronization for G Suite:

• An email notification, with an attached audio file, is sent to a user's Gmail address each time the user receives a MiCloud voicemail message.
• When a user reads a voicemail notification email, the voicemail is marked as heard in the MiCloud voicemail system.
• When a user deletes a voicemail notification email, the voicemail is deleted from the MiCloud voicemail system.

Configuring Google OAuth2 Settings

MiCloud voicemail synchronization with G Suite uses Google Apps OAuth2 client email, private key, and domain name. This section describes how to generate the OAuth2 client email and private key required for configuring MiCloud voicemail synchronization for G Suite.

The following tasks must be completed prior to configuring MiCloud voicemail synchronization for G Suite in the Account Portal:

• Create a service account.
• Delegate domain-wide authority to the service account.

Disclaimer: The Google OAuth2 settings are subject to changes at any time. For more information about Google OAuth2 settings, visit the Using OAuth 2.0 for Server to Server Applications page on the Google Developers website.

Creating a Service Account

Your G Suite administrator must create a service account to obtain the OAuth2 client email and private key required for configuring MiCloud voicemail synchronization for G Suite.

1. Launch a web browser and navigate to the Google Developers console.
2. Click Products & services to the left of Google APIs on the console toolbar.
3. Click IAM & admin and select Service accounts.
   NOTE: To create a service account, either select an existing project from the drop-down on the Google APIs console toolbar or click + to create a new project.
4. (Optional) If you choose to create a new project, do the following:
   1. In the Project name field, enter the name of the project.
      NOTE: The project ID is automatically created.
   2. Choose the desired option for receiving emails, updates regarding feature announcements, performance suggestions, feedback surveys, and special offers from Google.
   3. Click Accept the terms of service from Google.
   4. Click Create.
5. Click Create service account.
6. In the Service account name field, enter the name for the service account.
   NOTE: The Service Account ID is automatically created.
7. In the Role list, select an appropriate role. 
8. Select the Furnish a new private key check box, and select JSON as the key type.
9. Select the Enable G Suite Domain-wide Delegation check box.
10. In the Product name for the consent screen field, enter the product name as it should appear on the consent screen.
    NOTE: The product name field appears only when you create the service account for the first time in a new project.
11. Click Create.

IMPORTANT: Your new private key pair is generated and downloaded to your computer.  Save this file as you will need the information to configure voicemail synchronization for G Suite.

Delegating Domain-Wide Authority

After the service account is created, you must delegate domain-wide authority to the service account before configuring voicemail synchronization for G Suite in the Account Portal.

Disclaimer: The Google OAuth2 settings for delegating domain-wide authority are subject to changes at any time. For more information about Google OAuth2 settings, visit the Using OAuth 2.0 for Server to Server Applications page on the Google Developers website.

To grant domain-wide authority to the service account, do the following:

1. Go to the Admin console of the Google Apps domain.
2. On the gray bar at the bottom of the page, select More controls, and then select Security from the list of controls.
   NOTE: You must be signed in as an administrator to view the list of controls.
3. From the list of options, select Advanced settings.
4. In the Authentication section, select Manage API Client access.
5. In the Client name field, enter the Client ID for the service account.
6. The Client ID is located in the JSON file that downloaded when you created the service account.
7. In the One or More API Scopes field, enter https://mail.google.com/.
   This allows user’s voicemail boxes to synchronize with their Gmail accounts.
8. Click Authorize.

The MiCloud voicemail email synchronizer can now give access to impersonate the users and also make API calls on behalf of the user.

Enabling Voicemail Sync for G Suite

To enable MiCloud voicemail synchronization for G Suite in the Account Portal, you need the OAuth2 client email, private key, and G Suite domain name provided in the JSON file that was downloaded when your G Suite administrator created the service account.

To enable voicemail sync for G Suite:

1. Log in to the Account Portal.
2. On the Phone System menu, click Add-On Features.
   The Add-on Features page is displayed.
3. Click the App Integrations tab.
4. In the Gmail Sync with Voicemail section, do the following:
   1. In the Client Email field, enter the OAuth2 client email specified in the JSON file, and then click 
   2. In the Private Key field, enter the private key specified in the JSON file, and then click .
      NOTE: To copy the private key from the JSON file, select the content within the quotes, "-----BEGIN PRIVATE  to END PRIVATE KEY-----\n”<.
   3. In the Domain Name field, enter your G Suite domain name, and click .

Using the Voicemail System to Manage Voicemail
Managing Voicemail
Managing Mailbox Options
Using Visual Voicemail
Editing Voicemail Settings