# Zulip

Follow the below steps to integrate Zulip with Economize, allowing you to receive configured [notifications](https://docs.economize.cloud/product-features/notifications) 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="https://4121990823-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn3X3NsKiruYotJHSzbQX%2Fuploads%2FFDg8AzAyYui8Wyd8Crsw%2Fimage.png?alt=media&#x26;token=1a96ee2e-ea0e-4f3e-b686-e5d1322537ec" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://4121990823-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn3X3NsKiruYotJHSzbQX%2Fuploads%2FD7BKlHQdmxgvIKFMUqeG%2Fimage.png?alt=media&#x26;token=fc61bbbb-444d-4795-ad4f-784f9a44336c" 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="https://4121990823-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn3X3NsKiruYotJHSzbQX%2Fuploads%2FkFAPnnqsgeKHS09iQ956%2Fimage.png?alt=media&#x26;token=01f2a09c-84d1-4ebd-98d5-359d45ead00d" 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="https://4121990823-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn3X3NsKiruYotJHSzbQX%2Fuploads%2FijQ4wpv2pWSjnfEPIJGO%2Fimage.png?alt=media&#x26;token=d4e23ae9-9287-4c71-9452-e883250415ca" 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="https://4121990823-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn3X3NsKiruYotJHSzbQX%2Fuploads%2FUKsmC9yabD9P8HtqBqhR%2Fimage.png?alt=media&#x26;token=c3afdab6-e3af-479f-9e67-8b6f8deff9be" 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="https://4121990823-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn3X3NsKiruYotJHSzbQX%2Fuploads%2FeU2bs15WFGZhr8T2ErGS%2Fimage.png?alt=media&#x26;token=dbd06df9-f4da-48eb-ba37-2ef7ad3d0242" 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.
