/zulip_slack_integration

Primary LanguagePython

Zulip / Slack / Groupme Bridge Bot

Features

  • Relays two-way between Zulip, Groupme, and Slack.
  • Logs all public relayed traffic to a single Zulip stream.
  • Logs private relayed traffic to a dedicated Zulip stream.

Installation

  1. Install redis. A simple way to do this if you have docker installed is:
docker run -d --rm -p 6379:6379 --name redis_master redis:5.0
  1. Create a slack bot account with bot user, add that bot to the appropriate channel on a slack.
  2. Create a zulip bot account on the zulip instance you intend to run.
  3. If you are using Groupme, get a Groupme bot account.
  4. Edit secrets.py to configure the auth credentials for the above.
  5. Configure stream/channel/topic names into PUBLIC_TWO_WAY, PUBLIC_TWO_WAY_STREAM, ZULIP_LOG_PUBLIC_STREAM, ZULIP_LOG_PRIVATE_STREAM.
  6. If using Groupme, set GROUPME_ENABLE and the cert chain paths.

Hints

If you want to run with debug logging, set the LOGLEVEL environment variable to debug, like so:

LOGLEVEL=debug python __init__.py