Skip to main content
Version: 1.3

Mattermost for Botkube Cloud

Prerequisites​

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

Create a Botkube Cloud Instance with Mattermost​

Follow the steps below to install Botkube in your Mattermost instance.

  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 Mattermost option. Mattermost Platform Select

  4. Create Botkube user in Mattermost:

    To create a Botkube user, if not already created, proceed to the menu and Get a team invite link.

    mm_botkube_user

    Logout from the admin account and paste the link in the address bar and create a user with the username Botkube.

    note

    You can also use a custom username for your bot. However, it needs to be passed during Botkube installation in one of the further steps.

  5. Paste the bot name in the form

    Bot Name in the form

  6. Manage Roles for Botkube user in Mattermost

    Login as System Admin, in the Menu, proceed to System console > Users. For Botkube user, Manage Roles and select System Admin role.

    mm_botkube_roles

  7. Create a Token for Botkube user

    Login as Botkube user, in the Menu, proceed to Account Settings > Security > Personal Access Token > Create and copy the token.

    mm_botkube_token

  8. Past the token in the form

    Personal Token in the form

  9. Add Botkube to a channel

    Make sure that the newly created bot account is added to your Mattermost team by following these instructions.

    Invite Bot Account

    Add Botkube user created to the channel you want to receive notifications in.

    Channels in the form

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

Plugins

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

Create

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

Summary

Clean up​

Remove Botkube from Mattermost Team​

  • Deactivate or remove Botkube user from Mattermost Team. Login as System Admin, in the Menu proceed to System console -> Users -> botkube -> Deactivate.
  • Archive Channel created for Botkube communication if required.

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