Google Chat is a group-messaging service developed by Google.

Torq enables quick and easy integration with Google Chat, so you can automate anything and everything within moments. Torq's public Google Chat steps include:

Ask a Question
Create Space
Create User Membership
Send Message
+4 more...

If you don't see a step you need, you can create your own in various ways, such as using the Send an HTTP Request step or Torq’s Step Builder, and share it across your organization.

Use Google Chat Steps in Torq

If you've already created a relevant project and service account in GCP, you can skip to step three below.

Step One: Create a Project in GCP

Open the Google Cloud Console: Navigate to IAM & Admin > Create a Project.
Create a New Project:
1. Enter a meaningful name for the project.
2. Select an organization.
3. Select the location.
Finalize: Click Create.

Step Two: Create a Service Account in the Project

Create a Service Account: Navigate to IAM & Admin > Service Accounts and click Create service account.
Configure the Service Account:
1. Enter a meaningful name.
2. Enter a unique ID.
3. (Optional) Provide a description.
4. Click Create and continue.
5. (Optional) Grant the service account access to a project.
6. (Optional) Grant users or groups access to the service account.
Finalize: Click Done.

Step Three: Add a Private Key to the Service Account

Go to the Service Account's Keys: Locate the service account, and in the Actions column click Actions > Manage keys.
Create a Key: Click Add key > Create new key, select JSON, and then click Create.
Finalize: Save the private key for later—you will use it when creating the Google Chat integration in Torq.

Step Four: Authorize the Service Account

If you do not want to enable domain-wide delegation, skip this section and create a Google Chat OAuth integration instead. This will allow you to authenticate with Google Chat as yourself, limiting actions to your user account only.
The Send Message, Ask a Question, and Send Interactive Form Torq workflow steps can be authenticated with the Google Chat integration without enabling GCP domain-wide delegation.

Go to the Service Account's Details: Select the Details tab.
Copy the Client ID: Open Advanced settings and under Domain-wide Delegation copy the client ID. You will need it when delegating domain-wide authority to the service account.
Open the Google Admin Console: Click View Google Workspace Admin Console.
Go to API Controls: Navigate to Security > Access and Data control > API controls.
Enable Domain-Wide Delegation: In the Domain wide delegation section, click MANAGE DOMAIN WIDE DELEGATION and then Add new.
Define Permissions:
1. Paste the Client ID that you copied earlier.
2. Enter a comma-separated list of OAuth 2.0 scopes you want to use in Torq. Make sure to include the following:
```
https://www.googleapis.com/auth/chat.bot
https://www.googleapis.com/auth/chat.memberships.app
https://www.googleapis.com/auth/chat.spaces
```
Finalize: Click AUTHORIZE.

Step Five: Enable the Google Chat API

Open the Google Cloud Console: Navigate to APIs & Services > Enabled APIs & services and click Enable APIs and services.
Enable the Google Chat API: In the API Library, select Google Chat API and click ENABLE.
Configure the Google Chat API: Select the API's CONFIGURATION tab.
1. Copy the project number and save it for later—you will need it for the Google Chat steps integration in Torq.
2. Enter a meaningful app name.
3. Enter an HTTPS URL for the app's avatar image.
4. Provide a short description of the app.
5. Set the HTTP endpoint URL to https://interactivity.torq.io/google-chat/v1/interactivity-hooks outside of the EU or https://interactivity.eu.torq.io/google-chat/v1/interactivity-hooks within the EU.
6. Select Project Number for the Authentication Audience.
7. (Optional) Disable the app's visibility to other individuals and groups in your domain.
8. Click SAVE.

Step Six: Enable the IAM Service Account Credentials API

Open the API Library: Navigate to APIs & Services > Enabled APIs & services and click Enable APIs and services.
Enable the IAM Service Account Credentials API: Select IAM Service Account Credentials API and click ENABLE.

Step Seven: Assign an IAM Role to the Service Account

Grant Access to the Service Account: Navigate to IAM & Admin > IAM and click Grant access.
Define the Access:
1. Enter the service account's name.
2. Assign the Service Account Token Creator role.
Finalize: Click Save.

Step Eight: Create a Google Chat Steps Integration in Torq

Navigate to the Integration: Go to Build > Integrations > Steps > Google Chat and click Add Instance.
Configure the Integration:
1. Enter a meaningful name for the integration.
2. Paste the project number you copied earlier.
3. Upload the private key you generated earlier.
Finalize: Click Add.

FAQs

Can I use Google Chat steps in my workflows if I do not enable GCP domain-wide delegation?

Yes, but you'll need to create a Google Chat OAuth steps integration for all Google Chat steps other than Send Message, Ask a Question, and Send an Interactive Form.

Should I create a Google Chat or Google Chat OAuth integration for Google Chat OAuth steps in my workflows?

Google Chat OAuth steps specifically require the Google Chat OAuth steps integration.

Google Cloud Platform (GCP)