Connect
Self-Managed Only

discord

Consumes messages posted in a Discord channel.

This input works by authenticating as a bot using token based authentication. The ID of the newest message consumed and acked is stored in a cache in order to perform a backfill of unread messages each time the input is initialised. Ideally this cache should be persisted across restarts.

  • Common

  • Advanced

input:
  label: ""
  discord:
    channel_id: "" # No default (required)
    bot_token: "" # No default (required)
    cache: "" # No default (required)
    auto_replay_nacks: true
input:
  label: ""
  discord:
    channel_id: "" # No default (required)
    bot_token: "" # No default (required)
    cache: "" # No default (required)
    cache_key: last_message_id
    auto_replay_nacks: true

Fields

auto_replay_nacks

Whether to automatically replay rejected messages (negative acknowledgements, or nacks) at the output level. If the cause of rejections persists, leaving this option enabled can result in back pressure.

Set auto_replay_nacks to false to delete rejected messages. Disabling auto replays can greatly improve memory efficiency of high throughput streams, as the original shape of the data is discarded immediately upon consumption and mutation.

Requires version 4.27.0 or later.

Type: bool

Default: true

bot_token

A bot token used for authentication.

Type: string

cache

A cache resource to use for performing unread message backfills, the ID of the last message received will be stored in this cache and used for subsequent requests.

Type: string

cache_key

The key identifier used when storing the ID of the last message received.

Type: string

Default: last_message_id

channel_id

A discord channel ID to consume messages from.

Type: string