WhatsApp WhatsAppIncomingWebhook
CertifiedSend WhatsApp via incoming webhook
WhatsApp WhatsAppIncomingWebhook
Send WhatsApp via incoming webhook
Posts a JSON payload to a WhatsApp on-prem incoming webhook. Works well in flow-level errors tasks for failure notifications.
type: io.kestra.plugin.meta.whatsapp.WhatsAppIncomingWebhookExamples
Send a WhatsApp 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.meta.whatsapp.WhatsAppIncomingWebhook
url: "{{ secret('WHATSAPP_WEBHOOK') }}" # https://webhook.your-domain
payload: |
{
"profileName": "MyName",
"whatsAppIds": ["IdNo1, IdNo2"],
"from": 380999999999
}
Send a WhatsApp message via incoming webhook.
id: whatsapp_incoming_webhook
namespace: company.team
tasks:
- id: send_whatsapp_message
type: io.kestra.plugin.meta.whatsapp.WhatsAppIncomingWebhook
url: "{{ secret('WHATSAPP_WEBHOOK') }}"
payload: |
{
"profileName": "MyName",
"whatsAppIds": ["IdNo1, IdNo2"],
"from": 380999999999,
"messageId": "wamIdNo1"
}
Properties
url *string
1Incoming webhook URL
Webhook endpoint from the WhatsApp integration; supports expression rendering.
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
Options
The options to set to customize the HTTP client
io.kestra.plugin.meta.AbstractMetaConnection-RequestOptions
The time allowed to establish a connection to the server before failing.
PT0SThe time an idle connection can remain in the client's connection pool before being closed.
Deprecated, this option has no effect: Kestra's HTTP client does not support a connection pool idle timeout.
UTF-8The default charset for the request.
java.nio.charset.Charset
HTTP headers
HTTP headers to include in the request
10485760The maximum content length of the response.
Deprecated, this option has no effect: Kestra's HTTP client does not limit the response size.
PT5MThe time allowed for a read connection to remain idle before closing it.
PT10SThe maximum time allowed for reading data from the server before failing.
Deprecated, this option has no effect: Kestra's HTTP client has no separate read timeout. Use readIdleTimeout instead.
payload string
WhatsApp message payload
Raw JSON payload sent to the webhook; include contacts/messages per WhatsApp on-prem format.
