zulip/zerver/webhooks/trello/doc.md

Get Zulip notifications from your Trello boards!

1. {!create-stream.md!}

2. {!create-bot-construct-url-indented.md!}

3. 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.

4. {!download-python-bindings.md!}

5. 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>"
   

6. 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.

!!! tip "" To learn more, see Trello's webhooks documentation.

{!congrats.md!}