Skip to main content

Google Chat Receipe

  • Official Website: https://chat.google.com/
  • Icon Support: No
  • Message Format: Markdown
  • Message Limit: 4000 Characters per message

For this to work correctly you a GSuite account (there are free trials if you don't have one). You then need to create a Webhook; they can be done as follows:

  1. Open Google Chat in your browser
  2. Go to the room to which you want to add a bot.
  3. From the room menu at the top of the page, select Manage webhooks.
  4. Provide it a name and optional avatar and click SAVE
  5. Copy the URL associated with your new webhook.
  6. Click outside the dialog box to close.

When you've completed, you'll get a URL that looks a little like this:

https://chat.googleapis.com/v1/spaces/AAAAkM/messages?key=AIzaSSjMm-WEfqKqqsHI&token=O7bnyri_WEXKcyFk%3D
^ ^ ^ ^ ^ ^
| | | | | |
workspace ... webhook_key... ..webhook_token..

Simplified, it looks like this:

  • https://chat.googleapis.com/v1/spaces/WORKSPACE/messages?key=WEBHOOK_KEY&token=WEBHOOK_TOKEN

Now it's important to note that while this Magic Receipe plugin uses gchat://, you can also just use this URL exactly the way it was provided to you from Google when you copied and pasted. This is a perfectly valid Google Chat Magic Receipe URL as well.

Receipe#

Valid syntax is as follows:

  • https://chat.googleapis.com/v1/spaces/{workspace}/messages?key={webhook_key}&token={webhook_token}
  • gchat://{workspace}/{webhook_key}/{webhook_token}

Parameter Breakdown#

VariableRequiredDescription
workspaceYesThe workspace associated with your Google Chat account.
webhook_keyYesThe webhook key associated with your Google Chat account.
webhook_tokenYesThe webhook token associated with your Google Chat account.