Google Workspace GoogleChatExecution
CertifiedSend execution summary to Google Chat
Google Workspace GoogleChatExecution
Send execution summary to Google Chat
Posts a templated message with execution link, ID, namespace, flow name, start time, duration, and status; includes failing task when applicable. Use in flows triggered by Flow alerts, not in errors handlers—prefer GoogleChatIncomingWebhook there.
type: io.kestra.plugin.googleworkspace.chat.GoogleChatExecutionExamples
Send a Google Chat notification on a failed flow execution.
id: failure_alert
namespace: company.team
tasks:
- id: send_alert
type: io.kestra.plugin.googleworkspace.chat.GoogleChatExecution
url: "{{ secret('GOOGLE_WEBHOOK') }}" # format: https://chat.googleapis.com/v1/spaces/xzy/messages
text: "Google Chat Notification"
executionId: "{{trigger.executionId}}"
triggers:
- id: failed_prod_workflows
type: io.kestra.plugin.core.trigger.Flow
conditions:
- type: io.kestra.plugin.core.condition.ExecutionStatus
in:
- FAILED
- WARNING
- type: io.kestra.plugin.core.condition.ExecutionNamespace
namespace: prod
prefix: true
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
{}1150customFields object
Custom fields to be added on notification
customMessage string
Custom message to be added on notification
executionId string
{{ execution.id }}The execution id to use
Default is the current execution, change it to {{ trigger.executionId }} if you use this task with a Flow trigger to use the original execution.
options
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
templateRenderMap object
Variables used to render template
Map rendered into the template context
text string
Text override for message
Plain text that overrides or supplements the template output
