Integrate a ServiceNow instance and Google Hangouts by using G Suite credentials to authenticate ServiceNow requests.

Before you begin

  • Request an Integration Hub subscription.
  • Activate the Google Hangouts spoke.
  • Role required: admin.

Configure Google Hangouts application

Create a custom OAuth application from your G Suite account to enable OAuth 2.0 authentication with the Google Hangouts spoke.

Before you begin

Google Hangouts integration requirements:
  • A domain and an email address associated with the domain. For example, www.mydomain.com and jane-admin@mydomain.com. Note that you can only register one email address per domain in G Suite.
  • A Google G Suite or login created with the domain.

Role required: admin.

About this task

Complete these steps from your Google G Suite account. See the G Suite product documentation for instructions on creating and configuring custom applications.

Procedure

  1. Register a new custom application.
    1. Navigate to https://console.developers.google.com.
    2. Create a project with your G Suite administrator credentials, and open the project.
    3. From the APIs & Services menu, select OAuth consent screen, enter the application name.
    4. Specify the Authorized domain service-now.com. Click Save.
  2. Search for the Google Hangouts API and enable it.
  3. From the APIs & Services menu, select Credentials, and select Create OAuth client ID from the Create credentials list.
  4. Select the application type Web application.
  5. Enter the following Authorized redirect URI: https://<instance>.service-now.com/oauth_redirect.do and click Create.
    This redirect URI must match the Redirect URL you provide when you configure a connection for the Google Hangouts spoke.
  6. From the OAuth client window, copy your client ID and client secret to a text file so that you can use them when you configure a connection for the Google Hangouts spoke.
    The client ID and secret can always be accessed in the Google APIs & Services interface. Click Credentials and select the OAuth 2.0 client ID name.

Configure a connection for the Google Hangouts spoke

Add and configure a Google Hangouts connection to authenticate ServiceNow requests in Google Hangouts spoke.

Before you begin

Role required: admin

Procedure

  1. Navigate to Process Automation > Workflow Studio.
  2. Select the Integrations tab.
  3. Select the Connections tab.
  4. In the Search all connections field, enter Google_Hangouts.
  5. On the Google_Hangouts card, select View Details.
    Google Hangouts spoke alias card.
  6. Select Configure.
    Button to open Google Hangout connection form.
  7. On the Connection form, fill in the fields.
    FieldDescription
    Connection Name Name to identify the connection record. For example, Google_Hangouts.
    Connection URL Enter the URL https://www.googleapis.com/.
    OAuth Entity Name Name to identify the OAuth entity record. For example, Google Hangout entity.1.
    OAuth Client ID Enter the Client ID of the Google Hangouts application you created in G Suite.
    OAuth Client Secret Enter the Client Secret you generated when you created the application in G Suite.
    OAuth Redirect URL Redirect URL of your ServiceNow instance in this format: https://<ServiceNow-Instance-Name>.service-now.com/oauth_redirect.do.
    Google Hangout connection form.
  8. Click Configure and Get OAuth Token.
  9. Log in to Google to get the OAuth token.

Result

The spoke connection is configured and ready to be used.