diff --git a/static/images/integrations/errbot/000.png b/static/images/integrations/errbot/000.png new file mode 100644 index 0000000000..05e7e88879 Binary files /dev/null and b/static/images/integrations/errbot/000.png differ diff --git a/static/images/integrations/logos/errbot.svg b/static/images/integrations/logos/errbot.svg new file mode 100644 index 0000000000..ede2c4eeed --- /dev/null +++ b/static/images/integrations/logos/errbot.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/templates/zerver/integrations/errbot.md b/templates/zerver/integrations/errbot.md new file mode 100644 index 0000000000..829508c8c0 --- /dev/null +++ b/templates/zerver/integrations/errbot.md @@ -0,0 +1,49 @@ +# Run your favorite chatbot in Zulip! + +0. [Install errbot](http://errbot.io/en/latest/user_guide/setup.html) + and follow to instructions to setup a `config.py`. + +0. Check our our [Errbot integration package for Zulip](https://github.com/zulip/errbot-backend-zulip) + Clone this repository somewhere convenient. + +0. Install the requirements listed in `errbot-backend-zulip/requirements.txt`. + +0. Next, on your {{ settings_html|safe }}, [create a bot](/help/add-a-bot-or-integration) for + {{ integration_display_name }}. Make sure that you select **Generic bot** as the **Bot type**. + +0. Download your Zulip bot's `zuliprc` config file. You will need its content for the next step. + +0. Edit your ErrBot's `config.py`. Use the following template for a minimal configuration: + + import logging + + BACKEND = 'Zulip' + + BOT_EXTRA_BACKEND_DIR = r'' + BOT_DATA_DIR = r'' + BOT_EXTRA_PLUGIN_DIR = r'' + + BOT_LOG_FILE = r'' + BOT_LOG_LEVEL = logging.INFO + + BOT_IDENTITY = { # Fill this with the corresponding values in your bot's `.zuliprc` + 'email': '', + 'key': '', + 'site': '' + } + BOT_ADMINS = ('`. + +7. [Start ErrBot](http://errbot.io/en/latest/user_guide/setup.html#starting-the-daemon). + +{!congrats.md!} + +![](/static/images/integrations/errbot/000.png) + +Tips +---- + +* Rooms in ErrBot are streams in Zulip. diff --git a/zerver/lib/integrations.py b/zerver/lib/integrations.py index c796432ad1..36fb397a89 100644 --- a/zerver/lib/integrations.py +++ b/zerver/lib/integrations.py @@ -373,6 +373,7 @@ INTEGRATIONS = { doc='zerver/integrations/discourse.md'), 'email': EmailIntegration('email', 'email', ['communication'], doc='zerver/integrations/email.md'), + 'errbot': Integration('errbot', 'errbot', ['meta-integration', 'bots'], doc='zerver/integrations/errbot.md'), 'git': Integration('git', 'git', ['version-control'], doc='zerver/integrations/git.md'), 'google-calendar': Integration( 'google-calendar',