zulip/templates/zerver/integrations/codebase.md

41 lines
1.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Get Codebase notifications in Zulip!
1. First, create the streams youd like to use for Codebase notifications. There
will be two types of messages: commit-related updates and issue-related
updates. We recommend naming the streams `codebase` and `tickets`, respectively.
After creating these streams, make sure to subscribe all interested parties.
1. {!create-an-incoming-webhook.md!}
1. {!download-python-bindings.md!}
1. {!change-zulip-config-file.md!}
You may also need to update the value of `ZULIP_TICKETS_STREAM_NAME` and
`ZULIP_COMMITS_STREAM_NAME`.
1. Go to your Codebase settings, and click on **My Profile**. Under
**API Credentials**, you will find your API key and username.
Edit the following lines in `zulip_codebase_config.py` to add your Codebase
credentials:
```
CODEBASE_API_USERNAME = "zulip-inc/leo-franchi-15"
CODEBASE_API_KEY = 0123456789abcdef0123456789abcdef
```
Before your first run of the script, you may also want to configure the
integration to mirror some number of hours of prior Codebase activity:
```
CODEBASE_INITIAL_HISTORY_HOURS = 10
```
1. Run the `/usr/local/share/zulip/integrations/codebase/zulip_codebase_mirror`
script. If needed, this script may be restarted, and it will automatically
resume from when it was last running.
{!congrats.md!}
![Codebase bot message](/static/images/integrations/codebase/001.png)