← All channels

Discord

stable

Gateway + slash commands, threads, voice transcripts.

In
Out
Auth
Application token
§ Required environment

Env vars

IRIS_DISCORD_BOT_TOKEN
Required

Bot token from the Discord developer portal.

IRIS_DISCORD_APPLICATION_ID
Required

Application ID used to register slash commands.

IRIS_DISCORD_GUILD_IDS
Optional

Comma-separated guild IDs the bot is scoped to.

§ Setup

Step by step

  1. 01

    Create an application

    In the Discord developer portal, create a new application, add a Bot user, and enable the Message Content intent.

  2. 02

    Invite the bot

    Generate an OAuth2 URL with the bot and applications.commands scopes, then invite it to your guild.

  3. 03

    Export credentials

    Save the token and application ID.

    export IRIS_DISCORD_BOT_TOKEN="..."
    export IRIS_DISCORD_APPLICATION_ID="..."
  4. 04

    Register commands

    Register slash commands and start the gateway listener.

    iris channels enable discord
    iris discord sync-commands
§ Success

You're done when

  • Bot has Message Content intent enabled
  • Bot is a member of at least one guild
  • /iris ping responds in under a second
  • iris logs --follow shows discord gateway: connected