/send-google-chat-webhook

A GitHub Action for sending a message to Google Chat via a webhook.

Primary LanguageGoApache License 2.0Apache-2.0

send-google-chat-webhook

This github action will enable users to send notification to google chat via github actions.

Prerequisites

Obtain a web hook from your google chat workspace.

  1. Go to your chat space which you want to add a webhook.
  2. At the top, click on the space title, select Apps & Integration.
  3. Click Manage webhooks
  4. Create a webhook or add another webhook if there is already one.
  5. Copy the webhook URL that you intend to use for this github action.

For your own security purposes, we would suggest to store your webhook url in github secrets, and use ${{ secrets.WEBHOOK_URL}} to get it's value.

Usage

jobs:
  job_id:
    # ...

    permissions:
      contents: 'read'
      id-token: 'write'

    steps:
    # ...

    - id: 'notify_google_chat'
      uses: 'google-github-actions/send-google-chat-webhook@v0.0.2'
      with:
        webhook_url: '${{ secrets.WEBHOOK_URL }}'
        mention: "<users/all>"

You can customize the condition for when you want this action is called..

- id: 'notify google chat'
  if: ${{ inputs.fail_intentionally }}
  uses: 'google-github-actions/send-google-chat-webhook@v0.0.2'
  with:
    webhook_url: '${{ secrets.WEBHOOK_URL }}'
    mention: "<users/all>"

Helpful references: