MessengerExecutionMessengerExecution
MessengerExecutionCertified

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.

yaml
type: "io.kestra.plugin.notifications.messenger.MessengerExecution"

Send a Messenger notification on a failed flow execution.

yaml
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

Page Access Token

Facebook Page Access Token with pages_messaging permission

Facebook Page ID

Facebook Page ID that will send the messages

SubTypestring

List of recipient PSIDs (Page-scoped IDs)

At least one recipient PSID is required

Custom fields to be added in the notification

Custom message to be added in the notification

Default{{ 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.

DefaultUPDATE
Possible Values
RESPONSEUPDATEMESSAGE_TAG

Messaging type

Type of message (RESPONSE, UPDATE, MESSAGE_TAG)

Options

The options to set to customize the HTTP client

Definitions
connectTimeoutstring
Formatduration

The time allowed to establish a connection to the server before failing.

connectionPoolIdleTimeoutstring
DefaultPT0S
Formatduration

The time an idle connection can remain in the client's connection pool before being closed.

defaultCharsetstring
DefaultUTF-8

The default charset for the request.

headersobject
SubTypestring

HTTP headers

HTTP headers to include in the request

maxContentLengthintegerstring
Default10485760

The maximum content length of the response.

readIdleTimeoutstring
DefaultPT5M
Formatduration

The time allowed for a read connection to remain idle before closing it.

readTimeoutstring
DefaultPT10S
Formatduration

The maximum time allowed for reading data from the server before failing.

Map of variables to use for the message template

Message text body

Direct message text (bypasses template)

Override URL for testing

Optional URL to override the default Facebook Graph API endpoint (for testing purposes)