Google Workspace GoogleChatIncomingWebhook

Google Workspace GoogleChatIncomingWebhook

Certified

Send Google Chat message via webhook

Posts JSON to a Google Chat incoming webhook. Commonly used in errors handlers for flow-level alerts. Configure the webhook in Chat first; no OAuth needed.

yaml
type: io.kestra.plugin.googleworkspace.chat.GoogleChatIncomingWebhook

Send a Google Chat notification on a failed flow execution.

yaml
id: unreliable_flow
namespace: company.team

tasks:
  - id: fail
    type: io.kestra.plugin.scripts.shell.Commands
    runner: PROCESS
    commands:
      - exit 1

errors:
  - id: alert_on_failure
    type: io.kestra.plugin.googleworkspace.chat.GoogleChatIncomingWebhook
    url: "{{ secret('GOOGLE_WEBHOOK') }}" # https://chat.googleapis.com/v1/spaces/xzy/messages?threadKey=errorThread
    payload: |
      {
        "text": "Google Chat Alert"
      }

Send a Google Chat message via incoming webhook.

yaml
id: google_incoming_webhook
namespace: company.team

tasks:
  - id: send_google_chat_message
    type: io.kestra.plugin.googleworkspace.chat.GoogleChatIncomingWebhook
    url: "{{ secret('GOOGLE_WEBHOOK') }}"
    payload: |
      {
        "text": "Google Chat Hello"
      }
Properties
Min length1

Incoming Google Chat webhook URL

Full Chat webhook endpoint (e.g. https://chat.googleapis.com/v1/spaces/.../messages); threadKey may be included

Configure HTTP client options

Optional HTTP settings (timeouts, charset, headers) applied to webhook calls

Definitions
connectTimeoutstring

Connect timeout for webhook calls

Max time to open the connection before failing

connectionPoolIdleTimeoutstring
DefaultPT0S

Connection pool idle timeout

How long an idle connection stays in the pool; default PT0S

defaultCharsetstring
DefaultUTF-8

Default charset for requests

Request charset; default UTF-8

headersobject

Custom HTTP request headers

Optional headers to add to every request

maxContentLengthintegerstring
Default10485760

Maximum response body size

Maximum response body length; default 10MB

readIdleTimeoutstring
DefaultPT5M

Idle timeout during read

Idle time on an open connection before closing; default PT5M

readTimeoutstring
DefaultPT10S

Read timeout for responses

Max time to read data before failing; default PT10S

JSON payload sent to Chat

Raw JSON body sent to Chat

Reference (ref) of the pluginDefaults to apply to this task.