PluginsNotificationsTasksDiscordDiscordIncomingWebhook

DiscordIncomingWebhook

yaml

type: "io.kestra.plugin.notifications.discord.DiscordIncomingWebhook"

Send a Discord message using an Incoming Webhook

Add this task to a list of errors tasks to implement custom flow-level failure notifications. Check the Discord documentation for more details..

Examples

Send a Discord notification on a failed flow execution

yaml

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.notifications.discord.DiscordIncomingWebhook
    url: "{{ secret('DISCORD_WEBHOOK') }}" # https://discord.com/api/webhooks/000000/xxxxxxxxxxx
    payload: |
      {
        "username": "MyUsername",
        "content": "Failure alert for flow {{ flow.namespace }}.{{ flow.id }} with ID {{ execution.id }}"
        "embedList": [{
                "title": "Discord Notification"
            }]
      }

Send a Discord message via incoming webhook

yaml

id: discord_incoming_webhook
namespace: company.team

tasks:
  - id: send_discord_message
    type: io.kestra.plugin.notifications.discord.DiscordIncomingWebhook
    url: "{{ secret('DISCORD_WEBHOOK') }}"
    payload: |
      {
        "username": "MyUsername",
        "tts": false,
        "content": "Hello from the workflow {{ flow.id }}",
        "embeds": [
            {
                "title": "Hello from Kestra",
                "color": 16777215
                "description": "This is a test message from Kestra",
                "footer": {
                    "text": "Footer text"
                }
            }
        ]
      }