
Zulip ZulipExecution
CertifiedNotify Zulip about a flow execution
Zulip ZulipExecution
Notify Zulip about a flow execution
Renders a templated Zulip message with execution metadata (link, ID, namespace, flow name, start date, duration, terminal status, and failing task when applicable). Use inside Flow triggers; for errors handlers prefer ZulipIncomingWebhook. Configure channel/user/icon via template fields.
type: io.kestra.plugin.zulip.ZulipExecutionExamples
Send a Zulip notification on a failed flow execution.
id: failure_alert
namespace: company.team
tasks:
- id: send_alert
type: io.kestra.plugin.zulip.ZulipExecution
url: "{{ secret('ZULIP_WEBHOOK') }}" # format: https://yourZulipDomain.zulipchat.com/api/v1/external/INTEGRATION_NAME?api_key=API_KEY
channel: "#general"
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 *Requiredstring
1Zulip incoming webhook URL
Full incoming webhook URL (integration path and API key); render from a secret. See Incoming Webhook Integrations for formats.
channel string
Channel destination
Optional stream or topic to target; overrides channel defined in the rendered template.
customFields 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.
iconEmoji string
Icon emoji
Emoji code to display as avatar instead of an image URL.
iconUrl string
Icon URL
HTTP URL for avatar shown with the message; ignored if emoji is set.
options
HTTP client options
Tune headers, charsets, and timeouts used by the Zulip HTTP calls. Leave empty to use Kestra defaults.
io.kestra.plugin.zulip.AbstractZulipConnection-RequestOptions
Connect timeout
Duration to open the TCP connection before failing.
PT0SConnection pool idle timeout
How long an idle pooled connection stays open before eviction; default 0s.
UTF-8Default charset
Charset used when none is provided by the response; default UTF-8.
java.nio.charset.Charset
HTTP headers
Extra headers merged into the request; values can be templated.
10485760Max response size
Maximum response body size in bytes; default 10 MB.
PT5MRead idle timeout
Allowed idle time on an open read connection before closing; default 5 minutes.
PT10SRead timeout
Max time to read data before failing; default 10s.
payload string
Zulip message payload
Rendered JSON body sent as-is to the incoming webhook; follow Zulip payload schema for your integration.
pluginDefaultsRef Non-dynamicstring
Reference (ref) of the pluginDefaults to apply to this task.
templateRenderMap object
Template variables
Key-value map rendered into the Pebble template before sending.
username string
Message author
Overrides the displayed sender name for this message.