Skip to main content
Version: Unreleased 🚧

Discord for Botkube Cloud

Prerequisites

  • Botkube Cloud account which you can create here for free.

Create a Botkube Cloud Instance with Discord

  1. Go to Botkube Cloud Web App and create a new instance.

    You can do it by clicking "Create an Instance" button on Home Page or under this link Create an Instance

  2. Fill in the Instance Display Name and click Next button.

    Instance Display Name

  3. Click Add platform dropdown, and select Discord option. Select Platform

  4. Create Botkube app at your Discord Server

    Reach https://discordapp.com/developers/applications.

    discord_applications_portal

  5. Create a "New Application" named Botkube and add a bot named Botkube into the Application.

    discord_create_new

  6. Copy the Application APPLICATION ID

    discord_copy_client_id

    and paste it in the BotID field in the form.

    bot_id_form

  7. Add a description - Botkube helps you monitor your Kubernetes cluster, debug critical deployments and gives recommendations for standard practices by running checks on the Kubernetes resources..

    Set the Botkube icon (Botkube icon can be downloaded from this link).

    Click on Save Changes to update the Bot.

  8. Now, reach the Bot page and Click Add Bot to add a Discord Bot to your application.

    discord_add_bot

  9. After Bot creation, now you can see a bot is added to your application. Click on the Reset Token button.

    discord_bot_created

  10. Copy the Token and paste it in Token field the form.

    discord_token_form

  11. Go to the OAuth2 page. Generate the URL with suitable permissions using the OAuth2 URL Generator available under the OAuth2 section to add bot to your Discord server.

discord_bot_scope

the generated URL contains YOUR_CLIENT_ID, Scope and permission details.

https://discord.com/api/oauth2/authorize?client_id={YOUR_CLIENT_ID}&permissions={SET_OF_PERMISSIONS}&scope=bot
  1. Copy and Paste the generated URL in a new tab, select the discord server to which you want to add the bot, click Continue and Authorize Bot addition.

discord_bot_auth

discord_bot_auth_2

  1. Switch to the Discord app. Navigate to User settings and select Advanced tab.

    Enable the Developer Mode.

    discord_developer_mode

  2. Create a new channel or select an existing one and copy the CHANNEL ID.

    To get the channel ID, right-click on a channel you want to receive notification in and click on Copy ID.

    discord_copy_channel_id.png

    Copy the channel ID and create it in Channel ID field in the form.

    discord_channel_id_form

  3. Add plugins you want to enable in your Botkube instance and click Next button.

    Plugins

  4. Include optional default aliases and default actions and click Create button to create Botkube Cloud instance.

    Create

  5. Follow the instructions in the summary page to deploy Botkube into your environment.

    Summary

Clean up

Remove Botkube from Discord Server

  • Go to Discord Developers Portal Applications page,
  • Click on "Botkube" and click on "Delete App" button.

Remove Botkube from Kubernetes cluster

  1. Go to Botkube Cloud instances page and click Manage button of the instance you want to remove.

  2. Click Delete instance button, type instance name in the popup and click Delete instance.

    caution

    Remember to execute the displayed command to completely remove Botkube and related resources from your cluster.

    Delete