Go on your {{ settings_html|safe }}, create a Taiga bot. Please note the bot name and API key.

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 -

     {{ external_api_uri_subdomain }}/v1/external/taiga?stream=STREAM_NAME&topic=TOPIC_NAME&api_key=BOT_API_KEY

     • STREAM_NAME - The url-encoded name of stream which you want to receive notifications. You can use an existing Zulip stream or create a new one for this.
     • TOPIC_NAME - The url-encoded topic where your Taiga notifications will be posted. (Read the notes below.)
     • BOT_API_KEY - API key created in Zulip.

   Remember to url-encode the stream and topic names. E.g. spaces need to be replaced with %20 (e.g. so if you want your stream to be called "My awesome project", STREAM_NAME should be My%20awesome%20project).

4. Secret key - once again the API key created in Zulip.

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

That's it! Your actions on Taiga should now cause notifications on the Zulip stream you specified above.

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

• Use special Zulip stream for Taiga messages - name it Taiga. (Make sure to create this stream first!) For every integrated project, provide a new topic.

  STREAM_NAME = Taiga
  TOPIC = Project

• If you already have a Zulip stream for managing a project, you can also use this existing stream and add Taiga notifications using special topic.(Remember about substituting spaces with %20).

  STREAM_NAME = My%20existing%20Zulip%20stream
  TOPIC = Taiga