Google Integration

Google Integration Setup

This article will provide a walkthrough in setting up the Google Integration with the bvoip phone system.

Why Google Integration? 

The Google Integration is intended to be an alternative login for those who use Google Workspace. 

User Creation Notice

If you are looking to use Google Integration, the extension users would need to have the gmail account associated with their Google user account. 

How to Setup

  1. Log into the bvoip phone system.
  2. Go to the Integrations menu.
  3. Select the Google subsection. 
  4. Go to the Authorized URI field.
  5. Copy the URI listed and save it for later in the process. 
  6.  Open Google console with your organization or personal account.
  7. Go to the Select a Project option. The Select a Project pop-up will appear. 
    googleinteg2
  8. Click on New Project. The page will then refresh.googleinteg3
  9. On the New Project page, complete the project information.
    1. Project name - enter the project's name, e.g. "pbx-integration".
    2. Organization - select the correct organization (if applicable).
    3. Location - select the correct location. googleinteg4
  10. Click on the Create button to create the project. The page will refresh.
  11. Go to APIs & Services. googleinteg5
  12. Select the OAuth Consent Screen menu option.
    googleinteg6
  13. Select the appropriate User Type.
    1. Internal - Application will be accessible by the corporate Google accounts.
    2. External - Publicly accessible for any user with a Google account.googleinteg7
  14. Click on the Create button. The page will refresh. 
  15. Publish App is required on OAuth consent screen with the successful completion of the steps below.
  16. Complete the OAuth consent screen information.
    1. App information - App name - enter the app name, e.g. PBX Integration.googleinteg8
    2. App information - User support email - enter the email for support.
    3. Developer contact information - Email addresses - enter the email for development support.
      googleinteg9
  17. Click on Save and Continue. The screen will refresh to go over Scopes. 
    googleinteg10
  18. In the Scopes section, click on Save and Continue. The screen will refresh to go over Test Users.
  19. In the Test Users section, click on Save and Continue. The screen will refresh to reflect the OAuth Summary. 
  20. Select the OAuth Consent Screen menu option.
    googleinteg11
  21. Click on Create Credentials.
    googleinteg12
  22. Select the OAuth Client ID option from the drop-down menu. The screen will refresh to the Create Client OAuth ID screen.googleinteg13
  23.  In the Application Type drop-down, select Web application.
  24. Name - Enter a name for the OAuth client, e.g. PBX Integration.
  25. Scroll down to the Authorized redirect URIs section.
  26. Click on + Add URI. A text field will appear. 
  27. In the text field, paste the value from step 5.googleinteg14
  28. Click on the Create button. The screen will refresh with the OAth Client Created pop-up. googleinteg15
  29. Copy the value in the Your Client ID field and save it for later in the process.
  30. Copy the value in the Your Client Secret field and save it for later in the process.
  31. Click on Download JSON to keep the JSON file generated. 
  32. Click OK to close the window. 
  33. Go back to the bvoip phone system.
  34. Paste the Client ID into the Client ID field.
  35. Paste the Client Secret into the client secret field. 
  36. Scroll down to the Administrator Sign In section. 
  37. De-select the check box for the Administrator Sign In section.
  38. Scroll down to the User Sign In section.
  39. Ensure that the checkbox is selected.
  40. Select the Only These Users option from the drop-down. 
  41. Click on the Add button. A pop-up will appear for users to be selected. 
  42. Select the desired Google users. 
  43. Click on the Close button. 
  44. Click the Save button.