zulip/templates/zerver/integrations/errbot.md

Run your favorite chatbot in Zulip!

1. Install errbot and follow to instructions to set up a config.py.

2. Check out our Errbot integration package for Zulip. Clone this repository somewhere convenient.

3. Install the requirements listed in errbot-backend-zulip/requirements.txt.

4. {!create-a-generic-bot.md!}

5. Download your Zulip bot's zuliprc config file. You will need its content for the next step.

6. Edit your ErrBot's config.py. Use the following template for a minimal configuration:

    import logging
   
    BACKEND = 'Zulip'
   
    BOT_EXTRA_BACKEND_DIR = r'<path/to/errbot-backend-zulip>'
    BOT_DATA_DIR = r'<path/to/your/errbot/data/directory>'
    BOT_EXTRA_PLUGIN_DIR = r'<path/to/your/errbot/plugin/directory>'
   
    BOT_LOG_FILE = r'<path/to/your/errbot/logfile.log>'
    BOT_LOG_LEVEL = logging.INFO
   
    BOT_IDENTITY = {  # Fill this with the corresponding values in your bot's `.zuliprc`
      'email': '<err-bot@your.zulip.server>',
      'key': '<abcdefghijklmnopqrstuvwxyz123456>',
      'site': '<http://your.zulip.server>'
    }
    BOT_ADMINS = ('<your@email.address',)
    CHATROOM_PRESENCE = ()
    BOT_PREFIX = '<@**err-bot**>'  # Providing errbot's full name in Zulip lets it respond to @-mentions.
   

   Sections you need to edit are marked with <>.

7. Start ErrBot.

{!congrats.md!}

Tips

• Rooms in ErrBot are streams in Zulip.