SHORETEL IS NOW PART OF MITEL. See how powering connections in the cloud is now brilliantly simple.

Configuring Voicemail Sync for G Suite

Content

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

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

Configuring Google OAuth2 Settings

Mitel 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 Mitel voicemail synchronization for G Suite.

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

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 Mitel voicemail synchronization for G Suite.

  1. Launch a web browser and navigate to the Google Developers console.
  2. Click User-added image 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 Connect 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 Mitel 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 Mitel voicemail synchronization for G Suite in the Connect 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 Connect 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 User-added image
    2. In the Private Key field, enter the private key specified in the JSON file, and then click User-added image

      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 User-added image.

Related Articles

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

ShoreTel Dates

Created Date 2017-03-03 - Modified Date 2017-10-26


Article: 000012993