Google Workspace GoogleChatIncomingWebhook
CertifiedSend Google Chat message via webhook
Google Workspace GoogleChatIncomingWebhook
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.
type: io.kestra.plugin.googleworkspace.chat.GoogleChatIncomingWebhookExamples
Send a Google Chat notification on a failed flow execution.
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.
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
url *string
1Incoming Google Chat webhook URL
Full Chat webhook endpoint (e.g. https://chat.googleapis.com/v1/spaces/.../messages); threadKey may be included
assets
Assets this task consumes as inputs or produces as outputs, for lineage tracking and the asset graph (Enterprise Edition). A flow declaring this property on a task is rejected in the open-source edition.
io.kestra.core.models.assets.AssetsDeclaration
IGNOREFAILWARNAsset failure behavior
Behavior applied to the task state when a declared asset fails to render, emit, or be persisted (e.g. a lock conflict): FAIL escalates it to FAILED, WARN (default) warns it if it would otherwise succeed, IGNORE leaves the state untouched.
Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.
The assets consumed as inputs.
io.kestra.core.models.assets.AssetIdentifier
1The assets produced as outputs.
io.kestra.plugin.ee.assets.Dataset
1150{}1150io.kestra.plugin.ee.assets.File
1150{}1150io.kestra.plugin.ee.assets.Table
1150{}1150io.kestra.plugin.ee.assets.VM
1150{}1150io.kestra.core.models.assets.External
1150{}1150io.kestra.core.models.assets.Custom
11501Custom asset type
{}1150options
Configure HTTP client options
Optional HTTP settings (timeouts, charset, headers) applied to webhook calls
io.kestra.plugin.googleworkspace.chat.AbstractChatConnection-RequestOptions
Connect timeout for webhook calls
Max time to open the connection before failing
PT0SConnection pool idle timeout
How long an idle connection stays in the pool; default PT0S
UTF-8Default charset for requests
Request charset, default UTF-8. Only applies when the URL is not a Chat API message path, the Chat API is UTF-8 only.
java.nio.charset.Charset
Custom HTTP request headers
Optional headers to add to every request
10485760Maximum response body size
Maximum response body length; default 10MB
PT5MIdle timeout during read
Idle time on an open connection before closing; default PT5M
PT10SRead timeout for responses
Max time to read data before failing; default PT10S
payload string
JSON payload sent to Chat
Raw JSON body sent to Chat
