Set up the Google Chat spoke

Integrate the ServiceNow instance and Google Chat by creating a custom OAuth application in Google Cloud console to authenticate ServiceNow requests.

Before you begin

• Request an Integration Hub subscription.

• Activate the Google Chat spoke.

• Role required: admin.

Create OAuth credentials in Google Cloud console for Google Chat spoke

Create credentials in Google Cloud console account to enable OAuth 2.0 authentication with the Google Chat spoke.

About this task

Complete these steps from the Google Cloud console.

Before you begin

• Create a Google Chat application. For more information, see Develop Google Chat apps and Google Apps Script Chat app quickstart.

• Role required: none

Procedure

1. In the Google Cloud console, navigate to Main menu > IAM & Admin > Create a Project.

   You can also directly go to https://console.cloud.google.com/projectcreate

2. Enter a descriptive name for your project in the Project Name field.

   Note: The project ID can’t be changed after the project is created, so choose an ID that meets your needs for the lifetime of the project.

3. After creating a Google Chat app, get the deployment ID of the app and record it.

   You need to provide the deployment ID for connection configuration. For more information, see Find a deployment ID.

4. Navigate to Navigation Menu > APIs & Services > Enabled APIs & Services.

5. Select Google Chat API from the list.

   [Omitted image "google-chat-spoke-select-chat-apis.png"] Alt text: Select Google Chat API in Google Cloud console

6. Click on the CREDENTIALS tab.

7. Click on + CREATE CREDENTIALS and select OAuth client ID.

   [Omitted image "google-chat-gc-console-create-creds.png"] Alt text: Create credentials for Google Chat app in Google Cloud console

8. On the Create OAuth client ID form, fill in the fields.

   Field Description Application Select Web application from the list. Name Enter a unique name to identify the OAuth 2.0 client. Authorized JavaScript origins URI Enter the URI of your ServiceNow instance. For example, https://<your-instance-name>.servicen-now.com Authorized redirect URIs Enter the redirect URI of your ServiceNow instance. For example, https://<your-instance-name>.servicen-now.com/oauth_redirect.do

   [Omitted image "google-chat-gc-create-oauth-cl-id.png"] Alt text: Create OAuth client ID for Google Chat spoke in Google Cloud console

9. Click CREATE.

   An OAuth client is created with client ID and client secret. Record the client ID and client secret.

10. Click on the CONFIGURATION tab and fill in the fields.

    Field Description App name Enter a name for your application. Avatar URL Specify an HTTPS URL for your app's avatar image. Description Enter a description for your application.

11. In Connection settings, specify the deployment ID of the Google Chat app from Step 4 in the Deployment ID field.

    Note: If you have created any Slash commands while creating the app, specify them.

    [Omitted image "google-chat-deployment-id.png"] Alt text: Add deployment ID of the app in Connection settings

12. Save the configuration of your app in Google Cloud console.

Configure a connection for Google Chat spoke

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

Before you begin

Role required: admin

Procedure

1. Navigate to All > Process Automation > Flow Designer.

2. Click the Connections tab.

3. Locate the alias for Google_Chat and and click View Details.

   Note: Don’t clickAdd Connection.

   [Omitted image "google-chat-spoke-conn-temp.png"] Alt text: Google Chat spoke connection template

4. Click Configure if you are configuring the connection for the first time.

   [Omitted image "google-chat-spoke-conn-config.png"] Alt text: Google Chat spoke connection configuration

5. On the Configure Connection form, fill in the fields.

   Field Description Connection Name Name to uniquely identify the connection record. Connection URL URL to Google Chat APIs. Enter https://chat.googleapis.com API Version Google Chat API version. Enter v1. OAuth Client ID OAuth client ID of Google Chat app in Google Cloud console. OAuth Client Secret OAuth client secret of Google Chat app in Google Cloud console. OAuth Redirect URL OAuth redirect URL of your ServiceNow instance. Enter in this formathttps://<your-instance-name>.service-now.com/oauth_redirect.do

6. Click Configure and Get OAuth Token.

   You will be redirected to Google accounts login page.

7. Enter your Google Chat API credentials.

Result

An OAuth token is generated and configured for the Google Chat spoke.