Slack backend configuration

This backend lets you connect to the Slack messaging service. To select this backend, set BACKEND = 'Slack'.

Extra Dependencies

You need to install this dependency before using Errbot with Slack:

pip install slackclient

Account setup

You will need to have an account at Slack for the bot to use, either a bot account (recommended) or a regular user account.

We will assume you're using a bot account for errbot, which may be created here. Make note of the API Token you receive as you will need it next.

With the bot account created on Slack, you may configure the account in errbot by setting up BOT_IDENTITY as follows:

BOT_IDENTITY = {
    'token': 'xoxb-4426949411-aEM7...',
}

Bot admins

You can set BOT_ADMINS to configure which Slack users are bot administrators. Make sure to include the @ sign:

BOT_ADMINS = ('@gbin', '@zoni')

Bot mentions using @

To enable using the bot's name in BOT_ALT_PREFIXES for @mentions in Slack, simply add the bot's name as follows:

BOT_ALT_PREFIXES = ('@botname',)

Channels/groups

If you're using a bot account you should set CHATROOM_PRESENCE = (). Bot accounts on Slack are not allowed to join/leave channels on their own (they must be invited by a user instead) so having any rooms setup in CHATROOM_PRESENCE will result in an error.

If you are using a regular user account for the bot then you can set CHATROOM_PRESENCE to a list of channels and groups to join.

Note

You may leave the value for CHATROOM_FN at its default as it is ignored by this backend.