mirror of
https://github.com/zulip/zulip.git
synced 2025-11-10 17:07:07 +00:00
05b752bd3f
This is one of those weird webhooks where the download-python-bindings.md macro doesn't work, because the user only needs the bindings to run the one-time Trello script to register the webhook and that script can be run from anywhere and doesn't need to be "hosted" anywhere.
56 lines
1.8 KiB
Markdown
56 lines
1.8 KiB
Markdown
### Get Zulip notifications from your Trello boards!
|
|
|
|
1. {!create-stream.md!}
|
|
|
|
1. {!create-bot-construct-url-indented.md!}
|
|
|
|
1. We will first collect three items: a **Board ID**, an **API Key**, and a
|
|
**User Token**.
|
|
|
|
* **Board ID**: Go to your Trello board. The URL should look like
|
|
`https://trello.com/b/<BOARD_ID>/<BOARD_NAME>`. Note down the
|
|
`<BOARD_ID>`.
|
|
|
|
* **API Key**: Go to <https://trello.com/1/appkey/generate>. Note down the
|
|
key listed under **Developer API Keys**.
|
|
|
|
* **User Token**: Go to <https://trello.com/1/appkey/generate>. Under
|
|
**Developer API Keys**, click on the **Token** link. Click on **Allow**.
|
|
Note down the token generated.
|
|
|
|
1. Download and install our
|
|
[Python bindings and example scripts](/api/installation-instructions).
|
|
|
|
1. Open `/usr/local/share/zulip/integrations/trello/zulip_trello_config.py`
|
|
with your favorite editor and change the following lines to specify
|
|
the Trello **API Key**, **User Token**, and the webhook URL constructed
|
|
above:
|
|
|
|
```
|
|
TRELLO_API_KEY = "<Trello API key generated above>"
|
|
TRELLO_TOKEN = "<Trello User Token generated above>"
|
|
ZULIP_WEBHOOK_URL = "<URL constructed above>"
|
|
```
|
|
|
|
1. Go to the `/usr/local/share/zulip/integrations/trello/` directory
|
|
and run the `zulip_trello.py` script, like so:
|
|
|
|
```
|
|
python zulip_trello.py <trello_board_name> <trello_board_id>
|
|
```
|
|
|
|
Replace `<trello_board_name` and `<trello_board_id` with the Trello
|
|
board's name and **Board ID**, respectively.
|
|
|
|
The `zulip_trello.py` script needs to be run only once to register
|
|
the webhook, and can be run from any machine.
|
|
|
|
!!! tip ""
|
|
To learn more, see [Trello's webhooks documentation][1].
|
|
|
|
[1]: https://developers.trello.com/page/webhooks
|
|
|
|
{!congrats.md!}
|
|
|
|
|