Google Chat via Webhook

Details

ID	`Google Chat via Webhook`
Provider	Google
Category	Messaging and Conferencing
From Version	6.0.0
Docker Image	`demisto/python3:3.12.8.3296088`
Supported Modules	Agentix XSIAM

README

Integration for sending notifications to a Google Chat space via Incoming Webhook.

Configure Google Chat via Webhook in Cortex

Parameter	Description	Required
Google Chat Space ID	This is located in the Webhook URL as a query parameter	True
Google Chat Space Key	Google Chat Space Key (found in Google Chat Webhook URL)	True
Google Chat Space Key		True
Google Chat Space Token	This is located in the Webhook URL as a query parameter	True
Google Chat Space Token		True
Trust any certificate (not secure)		False
Use system proxy settings		False

Commands

You can execute these commands from the CLI, as part of an automation, or in a playbook.
After you successfully execute a command, a DBot message appears in the War Room with the command details.

send-google-chat-message

Send a message to Google Chat Space via Incoming Webhook.

Base Command

send-google-chat-message

Input

Argument Name	Description	Required
message	The message to send. For example: “This is a message from Cortex XSOAR”. Default is None.	Required
threadName	If replying to a thread, use this argument to specify the thread name to reply to.	Optional

Context Output

Path	Type	Description
GoogleChatWebhook.Message.SpaceType	unknown	Google Chat space type
GoogleChatWebhook.Message.SenderName	unknown	Google Chat message sender name
GoogleChatWebhook.Message.ThreadReply	unknown	Determines if a message is in a thread reply
GoogleChatWebhook.Message.SpaceDisplayName	unknown	Google Chat space display name
GoogleChatWebhook.Message.Message	unknown	Google Chat message
GoogleChatWebhook.Message.Name	unknown	Google Chat space full name
GoogleChatWebhook.Message.SenderType	unknown	Google Chat message sender type
GoogleChatWebhook.Message.SpaceName	unknown	Google Chat space name
GoogleChatWebhook.Message.CreatedTime	unknown	Google Chat message creation time
GoogleChatWebhook.Message.ThreadName	unknown	Google Chat thread name
GoogleChatWebhook.Message.SenderDisplayName	unknown	Google Chat message sender display name

send-google-chat-custom-card

Send a customizable card to Google Chat Space via Incoming Webhook

Base Command

send-google-chat-custom-card

Input

Argument Name	Description	Required
blocks	JSON blocks copied from https://addons.gsuite.google.com/uikit/builder.	Required
threadName	If replying to a thread, use this argument to specify the thread name to reply to.	Optional

Context Output

Path	Type	Description
GoogleChatWebhook.CustomCard.Cards	unknown	Google Chat custom card details
GoogleChatWebhook.CustomCard.SpaceType	unknown	Google Chat space type
GoogleChatWebhook.CustomCard.SenderName	unknown	Google Chat custom card sender name
GoogleChatWebhook.CustomCard.ThreadReply	unknown	Determines if a custom card is in a thread reply
GoogleChatWebhook.CustomCard.SpaceDisplayName	unknown	Google Chat space display name
GoogleChatWebhook.CustomCard.Name	unknown	Google Chat space full name
GoogleChatWebhook.CustomCard.SenderType	unknown	Google Chat custom card sender type
GoogleChatWebhook.CustomCard.SpaceName	unknown	Google Chat space name
GoogleChatWebhook.CustomCard.CreatedTime	unknown	Google Chat custom card creation time
GoogleChatWebhook.CustomCard.ThreadName	unknown	Google Chat thread name
GoogleChatWebhook.CustomCard.SenderDisplayName	unknown	Google Chat custom card sender display name

Configuration parameters

space_id — Google Chat Space ID (required)
key — Google Chat Space Key (required)
token — Google Chat Space Token (required)
insecure — Trust any certificate (not secure)
proxy — Use system proxy settings

Commands (2)

send-google-chat-custom-card
Send a customizable card to Google Chat Space via Incoming Webhook.
send-google-chat-message
Send a message to Google Chat Space via Incoming Webhook.

Source

GoogleChatViaWebhook.py GoogleChatViaWebhook.yml GoogleChatViaWebhook_description.md

Download History Raw

Use the Google Chat Webhook integration to send messages/notifications, as well as customizable cards, to Spaces configured with an incoming webhook. 

**Note**: When using the `!send-google-chat-custom-card` integration command, we highly recommend using the [UI Kit Builder](https://addons.gsuite.google.com/uikit/builder) provided by Google to properly format and copy the JSON blocks required for the _blocks_ argument.

## Create an Incoming Webhook on the Space in Google Chat.  
For information, see the [Build a Google Chat app as a webhook](https://developers.google.com/workspace/chat/quickstart/webhooks) Documentation

To create an instance of the Google Chat Webhook in Cortex XSOAR, complete the following steps below:

1. [Register the Google Chat Webhook](https://developers.google.com/workspace/chat/quickstart/webhooks#register_the_incoming_webhook) and copy the webhook URL per the instructions.

2. Add an instance of the integration and use the following webhook URL as an example to configure the integration parameters below:

**Example URL**: https://chat.googleapis.com/v1/spaces/`SPACE_ID`/messages?key=`KEY`&token=`TOKEN`

  - **Google Chat Space ID**: In your webhook URL, locate the value for the **SPACE_ID** placeholder displayed in the example URL and copy/paste this value into the **Google Chat Space ID** integration parameter.

- **Google Chat Space Key**: In your webhook URL, locate the value for the **KEY** placeholder displayed in the example URL and copy/paste this value into the **Google Chat Space Key** integration parameter.

- **Google Chat Space Token**: In your webhook URL, locate the value for the **TOKEN** placeholder displayed in the example URL and copy/paste this value into the **Google Chat Space Token_* integration parameter.

3. Test the integration. If successful, you'll see a test message in the space and a success message on the test screen.

For more information, see the [integration documentation]<PLACEHOLDER>
---
[View Integration Documentation]<PLACEHOLDER>