amoorion-discord

Discord plugins of amoorion, both ways of decision Q12:

• discord: a bot posts, reads, replies and deletes in one channel, through the REST API. Secrets in amoorion’s vault: discord/token (the bot’s token, Developer Portal → the application → Bot) and discord/channel (the channel id: Developer Mode on, right click → Copy Channel ID); optional discord/uri (default https://discord.com/api/v10). The bot needs the permissions View Channel, Send Messages and Read Message History in that channel, and the Message Content intent switched on in the Developer Portal, or it reads messages of others as empty. Deleting others’ messages needs Manage Messages too.

• discord-webhook: posts, and deletes what it posted; no bot. Secret discord-webhook/url: the channel’s webhook URL (channel settings → Integrations → Webhooks).

Both send at most 2000 characters and never ping: mentions like @everyone stay plain text. Live listening through the gateway comes with the daemon’s listeners.

Links

• Documentation · as Markdown

• PyPI

• GitHub · issues

• What its vault entry holds

• amoorion · its documentation · its web page

• Discord API

Its vault entry

task vault:new makes this entry in a KeePassXC file; scopes are the keys it needs, optional the keys it can use.

{
  "vault": {
    "discord": {
      "description": "A bot in one channel, through the REST API",
      "scopes": {
        "token": "The bot's token (Developer Portal, the application, Bot)",
        "channel": "The channel id (Developer Mode on, right click, Copy Channel ID)"
      },
      "optional": {
        "uri": "The API with its version; default: https://discord.com/api/v10"
      }
    },
    "discord-webhook": {
      "description": "A channel's webhook, no bot",
      "scopes": {
        "url": "The channel's webhook URL (channel settings, Integrations, Webhooks)"
      },
      "optional": {}
    }
  }
}