Difference between revisions of "Google Chat"
JoshHowitt (talk | contribs) |
JoshHowitt (talk | contribs) |
||
| Line 39: | Line 39: | ||
* Select on '''+''' and select '''oAuth 2.0''' | * Select on '''+''' and select '''oAuth 2.0''' | ||
* Give the oAuth 2.0 KeySafe a Title (this is the name / identifier for the Google Chat account as you will see it when using the Integration Call node in your business process) | * Give the oAuth 2.0 KeySafe a Title (this is the name / identifier for the Google Chat account as you will see it when using the Integration Call node in your business process) | ||
| − | * Add your Google Chat Application Client Id, Client Secret | + | * Add your Google Chat Application Client Id, Client Secret. |
| + | * Authorize URL should be "https://accounts.google.com/o/oauth2/auth", Access URL should be "https://accounts.google.com/o/oauth2/token", and Refresh URL should be "https://oauth2.googleapis.com/token?" within the relevant fields. | ||
* Include the required oAuth Scopes (space separated like so: https://www.googleapis.com/auth/chat.memberships https://www.googleapis.com/auth/chat.messages). To enable create, read and update permissions for Google Chat Spaces the following scope can be used: "https://www.googleapis.com/auth/chat.spaces https://www.googleapis.com/auth/chat.spaces.create https://www.googleapis.com/auth/chat.delete". Alternatively you can see a full list of scopes [https://developers.google.com/chat/api/guides/auth#Chat%20API-scopes here]. | * Include the required oAuth Scopes (space separated like so: https://www.googleapis.com/auth/chat.memberships https://www.googleapis.com/auth/chat.messages). To enable create, read and update permissions for Google Chat Spaces the following scope can be used: "https://www.googleapis.com/auth/chat.spaces https://www.googleapis.com/auth/chat.spaces.create https://www.googleapis.com/auth/chat.delete". Alternatively you can see a full list of scopes [https://developers.google.com/chat/api/guides/auth#Chat%20API-scopes here]. | ||
* Finally to enable re-authentication set the Additional Params to 'access_type=offline'. | * Finally to enable re-authentication set the Additional Params to 'access_type=offline'. | ||
Revision as of 14:54, 17 July 2023
Home > Integration > Business Process Automation & Orchestration > Hornbill iBridge > Google Chat
Google ChatGoogle Chat is a cloud based application created by Google enabling the creation of messaging spaces. Gain the ability to Manage Google Spaces and Messages using the Hornbill integration service Google Chat is a Premium Integration |
Related Articles |
Authentication
In order to integrate with Google Chat, you will first need to configure, and securely store the authentication credentials for the Google Chat account/s you want to use with the Hornbill platform within oAuth 2.0. You can configure your Google Chat account authentication in KeySafe, as below.
Storing Credentials
- In Administration, navigate to System > Security > KeySafe;
- Select on + and select oAuth 2.0
- Give the oAuth 2.0 KeySafe a Title (this is the name / identifier for the Google Chat account as you will see it when using the Integration Call node in your business process)
- Add your Google Chat Application Client Id, Client Secret.
- Authorize URL should be "https://accounts.google.com/o/oauth2/auth", Access URL should be "https://accounts.google.com/o/oauth2/token", and Refresh URL should be "https://oauth2.googleapis.com/token?" within the relevant fields.
- Include the required oAuth Scopes (space separated like so: https://www.googleapis.com/auth/chat.memberships https://www.googleapis.com/auth/chat.messages). To enable create, read and update permissions for Google Chat Spaces the following scope can be used: "https://www.googleapis.com/auth/chat.spaces https://www.googleapis.com/auth/chat.spaces.create https://www.googleapis.com/auth/chat.delete". Alternatively you can see a full list of scopes here.
- Finally to enable re-authentication set the Additional Params to 'access_type=offline'.
- Optionally add a description
- Select Create Key to save
- Once the Key is created, you will need to connect to Google Chat and your account, in order to authorize the Hornbill App to perform the listed Google Chat options. Click Connect and you will be redirected to Google Chat in a popup window
- Log in to your Google Chat account, and then you will be prompted to review the operations you are authorising the Hornbill App to be allowed to perform with the chosen Google Chat account
- Select the relevant scopes, click Continue, you will be returned to your Keysafe key
Revoking Access
If at any point you wish to revoke the Hornbill platform's access to Google Chat, just hit the Revoke button against your Google Chat Keysafe key.
NOTE: This will revoke the rights of any existing Google Workspace Integration Calls in your Business Processes/Custom Buttons/Auto Tasks/Runbooks that are using the revoked Google Chat account, so you will need to edit these accordingly.
Cloud Automation Operations
You can automate the use of the operations listed below using Cloud Automations from within the Business Process Designer, Auto Tasks, Custom Buttons or Runbooks.
- Spaces
- Create - Creates a Chat Space
- Delete = Removes a Chat Space
- Get - Gets the details of a Chat Space
- History - Enables or Disabled the logging of changes to the Chat
- Update - Updates the details of a Chat Space
- Messages
- Create - Creates a Message
- Delete - Removes a Message
- Get - Retrieves additional details about a Message
- Update - Updates a Sent Message
Read more about using the Integration Call from the Related Articles section, and learn how to work with input and output parameters for each of the Google Chat operations.