# Zulip

Follow the below steps to integrate Zulip with Economize, allowing you to receive configured [notifications](/product-features/notifications.md) in your preferred stream.

1. **Create a Zulip account:**

* Go to the Zulip website (<https://zulip.com/>) and create an account.
* After creating the account, log in to your Zulip account.

2. **Create a Zulip Stream:**

* In Zulip, streams are used to organize conversations around specific topics. Therefore, you need to create a stream in Zulip that will be used to receive notifications from Economize.
* Click on the gear icon on the top right corner of the Zulip interface, and select `Manage Streams`.

<figure><img src="/files/TcFraLM8mxdsHrB6VIV7" alt=""><figcaption></figcaption></figure>

* Click on the `Create Stream` button and give the stream a name (e.g., Economize).

<figure><img src="/files/lEPKZcDcuO9nF7Hzp2lH" alt=""><figcaption></figcaption></figure>

* Once the stream is created, note down the name of the stream as it will be used in the integration process.

3. **Obtain Zulip Email and API Key:**

* To send messages to the Zulip stream, you will need to use the Zulip Email and API key.
* In Zulip, click on the gear icon on the top right corner of the Zulip interface, and select `Settings`.
* Scroll down to the `Personal settings` section and navigate to the `Bots` section.

<figure><img src="/files/aEFDBdr1GIHFPz2tyTHj" alt=""><figcaption></figcaption></figure>

* You can create a new bot or use an existing one as per your liking.
* Copy the `Bot Email` & `API Key` as it will be needed later

4. **Configure Economize:**

* Log in to your Economize account and navigate to `Settings -> Integrations`.
* In the Integrations settings, click on `Manage Integration` for Zulip.

<figure><img src="/files/tMKLL5dN2By0ndkcrkwY" alt=""><figcaption></figcaption></figure>

* You will be presented with existing Zulip Streams which have been added before, in order to add a new one, simply click on `Add Zulip Integration` button.

<figure><img src="/files/NghnZORJ4WZRmknK2ZwD" alt=""><figcaption></figcaption></figure>

* Enter the Zulip Email, Zulip API key, and the Zulip stream name you created earlier in the respective fields.

<figure><img src="/files/YPbetZEUQXVieF5TiVKY" alt=""><figcaption></figcaption></figure>

* Enter the Zulip URL (e.g., <https://sample-org.zulipchat.com/api/v1/messages>) in the URL field.
* Click on the **Connect** button.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.economize.cloud/integrations/zulip.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.