Meta MessengerExecution
CertifiedSend execution summary via Messenger
Meta MessengerExecution
Send execution summary via Messenger
Sends a Facebook Messenger notification with the execution link, ID, namespace, flow name, start time, duration, and status. Defaults to the current execution; set executionId to {{ trigger.executionId }} in Flow triggers to reference the original run.
type: io.kestra.plugin.meta.messenger.MessengerExecutionExamples
Send a Messenger notification on a failed flow execution.
id: failure_alert
namespace: company.team
tasks:
- id: send_messenger_alert
type: io.kestra.plugin.meta.messenger.MessengerExecution
pageId: "9876543214587"
accessToken: "{{ secret('MESSENGER_ACCESS_TOKEN') }}"
recipientIds:
- "24745216345137108"
executionId: "{{trigger.executionId}}"
customMessage: "Production workflow failed!"
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
accessToken *string
Page Access Token
Page access token with pages_messaging permission for the sender Page.
pageId *string
Facebook Page ID
Page that sends the messages; must match the access token permissions.
recipientIds *array
Recipient PSIDs
Page-scoped recipient IDs; at least one is required or the task fails.
apiBaseUrl string
https://graph.facebook.comBase API URL
Base Graph API URL. Defaults to https://graph.facebook.com.
apiVersion string
v23.0API Version
Graph API version to call. Defaults to v23.0.
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 added to the template
Key/value pairs injected into the Pebble template as customFields.
customMessage string
Extra message body
Additional text appended after the generated execution summary.
executionId string
{{ execution.id }}Execution ID
Execution to describe in the notification. Defaults to the current run; set to {{ trigger.executionId }} inside Flow triggers to report on the triggering execution.
messagingType string
UPDATERESPONSEUPDATEMESSAGE_TAGMessaging type
Messaging type passed to the Graph API (RESPONSE, UPDATE, MESSAGE_TAG). Defaults to UPDATE.
options
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.
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.
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.
templateRenderMap object
Template variables
Values injected into the Pebble template before sending.
textBody string
Message text body
Direct message text; bypasses the template when provided.
url string
Override URL for testing
Optional Graph API endpoint override; defaults to https://graph.facebook.com/v23.0/{pageId}/messages. When set, or when options is set, the request is posted directly instead of through the SDK.
