{!create-stream.md!}

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

{!append-topic.md!}

Make sure to specify the topic in the URL above. Otherwise, the
default topic `General` will be used.

Remember to URL-encode the stream and topic names in the above
URL. Spaces need to be replaced with `%20`. For instance, if
you want your stream to be called "My awesome project", it
should be encoded as `My%20awesome%20project`.

Since Taiga allows you to integrate services on a per project
basis, you have to perform the following steps for *every project*
that you want to send notifications to Zulip.

1. Go to **Admin** > **Integration** > **Webhooks** menu.

2. Click **Add a new webhook**.

3. Fill out the form by following the instructions:
    * **Name** - to recognize this service, preferably `Zulip`
    * **URL** - the URL we created above
    * **Secret key** - once again the bot API key created in Zulip

4. Click **Save** once you've finished filling out the form.

{!congrats.md!}

![](/static/images/integrations/taiga/001.png)

There are **two different ways** you may want to consider
when organizing your Taiga - Zulip integration:

* Use a separate Zulip stream for Taiga messages - name it `taiga`
  (as recommended above). For every integrated project, provide a
  new topic in the URL as described above.

* If you already have a Zulip stream for managing a project,
  you can also use this existing stream and provide `Taiga`
  as the topic in the URL.

Receive Zulip notifications for your Taiga projects!

1. {!create-stream.md!}

1. {!create-bot-construct-url-indented.md!}
   {!append-topic.md!}

    Make sure to specify the topic in the URL above. Otherwise, the
    default topic `General` will be used.

1. Go to your **Projects Dashboard** on Taiga, and select the project you'd like to
   receive notifications for. Go to **Admin**, and click on  **Integrations**.
   Click on **Add a new webhook**.

1. Set **Name** to a name of your choice, such as `Zulip`. Set **URL** to the
   URL constructed above, and set **Secret key** to the API key of the bot created
   above. Save the form.

{!congrats.md!}

![](/static/images/integrations/taiga/001.png)

Update text to conform to the new style guide.
webhooks/taiga: Update text to conform to the new style guide.

Note that the "Save" button has no text in the Taiga webhook
setup UI. There is a small floppy disk symbol for saving which
is visible right beside the form fields. So I simply said,
"Save the form".
