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.

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

Examples

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

accessToken *string

Page Access Token

Facebook Page Access Token with pages_messaging permission

pageId *string

Facebook Page ID

Facebook Page ID that will send the messages

recipientIds *array

SubType string

List of recipient PSIDs (Page-scoped IDs)

At least one recipient PSID is required

customFields object

Custom fields to be added in the notification

customMessage string

Custom message to be added in the notification

executionId string

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.

messagingType string

Default UPDATE

Possible Values

RESPONSEUPDATEMESSAGE_TAG

Messaging type

Type of message (RESPONSE, UPDATE, MESSAGE_TAG)

options AbstractHttpOptionsTask-RequestOptions

Options

The options to set to customize the HTTP client

templateRenderMap object

Map of variables to use for the message template

textBody string

Message text body

Direct message text (bypasses template)

url string

Override URL for testing

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

Definitions

java.nio.charset.Charset

io.kestra.plugin.notifications.AbstractHttpOptionsTask-RequestOptions

connectTimeout string

Format duration

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

connectionPoolIdleTimeout string

Default PT0S

Format duration

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

defaultCharset Charsetstring

Default UTF-8

The default charset for the request.

headers object

SubType string

HTTP headers

HTTP headers to include in the request

maxContentLength integerstring

Default 10485760

The maximum content length of the response.

readIdleTimeout string

Default PT5M

Format duration

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

readTimeout string

Default PT10S

Format duration

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

​Messenger​Execution

MessengerExecution