
MessengerExecution
Send a Messenger message with execution information.
Send execution details via Facebook Messenger including execution link, ID, namespace, flow name, start date, duration, and status.
type: "io.kestra.plugin.notifications.messenger.MessengerExecution"Examples
Send a Messenger notification on a failed flow execution.
id: failure_alert
namespace: company.team
tasks:
- id: send_messenger_alert
type: io.kestra.plugin.notifications.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*RequiredNon-dynamicstring
Page Access Token
Facebook Page Access Token with pages_messaging permission
pageId*RequiredNon-dynamicstring
Facebook Page ID
Facebook Page ID that will send the messages
recipientIds*Requiredarray
List of recipient PSIDs (Page-scoped IDs)
At least one recipient PSID is required
customFieldsobject
Custom fields to be added in the notification
customMessagestring
Custom message to be added in the notification
executionIdstring
{{ execution.id }}The execution ID to use
Default is the current execution, change it to if you use this task with a Flow trigger to use the original execution.
messagingTypestring
UPDATERESPONSEUPDATEMESSAGE_TAGMessaging type
Type of message (RESPONSE, UPDATE, MESSAGE_TAG)
options
Options
The options to set to customize the HTTP client
io.kestra.plugin.notifications.AbstractHttpOptionsTask-RequestOptions
durationThe time allowed to establish a connection to the server before failing.
PT0SdurationThe 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.
PT5MdurationThe time allowed for a read connection to remain idle before closing it.
PT10SdurationThe maximum time allowed for reading data from the server before failing.
templateRenderMapobject
Map of variables to use for the message template
textBodystring
Message text body
Direct message text (bypasses template)
urlstring
Override URL for testing
Optional URL to override the default Facebook Graph API endpoint (for testing purposes)