64898b2c79
Some checks failed
Code scanning / CodeQL (push) Failing after 15s
Zulip production suite / Ubuntu 22.04 production build (push) Failing after 26s
Zulip production suite / Debian 12 production install with custom db name and user (push) Has been skipped
Zulip production suite / Ubuntu 22.04 production install and PostgreSQL upgrade with pgroonga (push) Has been skipped
Zulip production suite / Ubuntu 24.04 production install (push) Has been skipped
Zulip production suite / Ubuntu 26.04 production install (push) Has been skipped
Zulip production suite / Debian 13 production install (push) Has been skipped
Zulip production suite / 7.0 Version Upgrade (push) Has been skipped
Zulip production suite / 8.0 Version Upgrade (push) Has been skipped
Zulip production suite / 6.0 Version Upgrade (push) Has been skipped
Zulip production suite / 10.0 Version Upgrade (push) Has been skipped
Zulip production suite / 9.0 Version Upgrade (push) Has been skipped
Zulip production suite / 12.0 Version Upgrade (push) Has been skipped
Zulip production suite / 11.0 Version Upgrade (push) Has been skipped
GitHub Actions Security Analysis with zizmor / zizmor (push) Failing after 3s
Zulip CI / Debian 12 (Python 3.11, backend + documentation) (push) Failing after 26s
Zulip CI / Ubuntu 22.04 (Python 3.10, backend + frontend) (push) Failing after 3s
Zulip CI / Ubuntu 24.04 (Python 3.12, backend) (push) Failing after 25s
Zulip CI / Ubuntu 26.04 (Python 3.14, backend) (push) Failing after 25s
Zulip CI / Debian 13 (Python 3.13, backend) (push) Failing after 28s
Zulip production suite / Required jobs (push) Has been cancelled
Zulip CI / Required jobs (push) Has been cancelled
API Documentation Update Check / check-feature-level-updated (push) Has been cancelled
API Documentation Update Check / notify-if-api-docs-changed (push) Has been cancelled
83 lines
2.5 KiB
Markdown
83 lines
2.5 KiB
Markdown
# Zulip Trello integration
|
|
|
|
Get Zulip notifications from your Trello boards!
|
|
|
|
!!! tip ""
|
|
|
|
[Zapier](./zapier) is usually a simpler way to integrate Trello
|
|
with Zulip.
|
|
|
|
{start_tabs}
|
|
|
|
1. {!create-an-incoming-webhook.md!}
|
|
|
|
1. {!generate-webhook-url-basic.md!}
|
|
|
|
1. **Log in to Trello**, and collect the following:
|
|
|
|
* **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**: Under **Developer API Keys**, click on the **Token**
|
|
link, and click **Allow**. Note down the token generated.
|
|
|
|
1. You're now going to need to run a Trello configuration script from a
|
|
computer (any computer) connected to the internet. It won't make any
|
|
changes to the computer.
|
|
|
|
Make sure you have a working copy of Python. If you're running
|
|
macOS or Linux, you very likely already do. If you're running
|
|
Windows you may or may not. If you don't have Python, follow the
|
|
installation instructions [here][1].
|
|
|
|
!!! tip ""
|
|
|
|
You do not need the latest version of Python; anything 2.7 or
|
|
higher will do.
|
|
|
|
1. Download [zulip-trello.py][2].
|
|
|
|
!!! tip ""
|
|
|
|
<kbd>Ctrl</kbd> + <kbd>S</kbd> or <kbd>Cmd</kbd> + <kbd>S</kbd>
|
|
on that page should work in most browsers.
|
|
|
|
1. Run the `zulip-trello` script in a terminal, after replacing the all
|
|
caps arguments with the values collected above and the generated URL
|
|
above.
|
|
|
|
```
|
|
python zulip_trello.py --trello-board-name TRELLO_BOARD_NAME \
|
|
--trello-board-id TRELLO_BOARD_ID \
|
|
--trello-api-key TRELLO_API_KEY \
|
|
--trello-token TRELLO_TOKEN \
|
|
--zulip-webhook-url "GENERATED_WEBHOOK_URL"
|
|
```
|
|
|
|
!!! warn ""
|
|
|
|
**Note**: Make sure that you wrap the webhook URL generated above
|
|
in quotes when supplying it on the command-line, as shown above.
|
|
|
|
The `zulip_trello.py` script only needs to be run once, and can be run
|
|
on any computer with python.
|
|
|
|
1. You can delete `zulip_trello.py` from your computer if you'd like.
|
|
|
|
{end_tabs}
|
|
|
|
{!congrats.md!}
|
|
|
|
|
|
|
|
### Related documentation
|
|
|
|
{!webhooks-url-specification.md!}
|
|
|
|
[1]: https://realpython.com/installing-python/
|
|
[2]: https://raw.githubusercontent.com/zulip/python-zulip-api/main/zulip/integrations/trello/zulip_trello.py
|