Files
zulip/zerver/webhooks/trello/doc.md
Eeshan Garg 05b752bd3f webhooks/trello: Mention that Trello script can be run from anywhere.
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.
2018-06-11 07:46:16 -04:00

1.8 KiB

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 and install our Python bindings and example scripts.

  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.

    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.

{!congrats.md!}