> ## Documentation Index
> Fetch the complete documentation index at: https://docs.utopikai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Zulip Connector

> Capture discussions from Zulip Streams and Topics

## How it works

The Zulip connector pulls in all streams and topics according to the permissions assigned to the bot user.

## Setting up

### Authorization

1. UtopikAI interfaces with Zulip as a Zulip Bot which is authenticated using the `zuliprc` config format.
   For more context directly from Zulip, refer to the following docs:
   * [https://zulip.com/api/running-bots](https://zulip.com/api/running-bots)
   * [https://zulip.com/api/configuring-python-bindings](https://zulip.com/api/configuring-python-bindings)
2. Start by creating a Zulip Bot

<img src="https://mintcdn.com/utopikai/5TAKgT3IAyEwTGK_/images/connectors/zulip/ZulipBot.png?fit=max&auto=format&n=5TAKgT3IAyEwTGK_&q=85&s=b748eabcb710687027b3ff59e5dcd14f" alt="ZulipBot" width="1568" height="1718" data-path="images/connectors/zulip/ZulipBot.png" />

3. Copy the Bot authentication info (`zuliprc` contents), see red arrow below:

<img src="https://mintcdn.com/utopikai/5TAKgT3IAyEwTGK_/images/connectors/zulip/ZulipRC.png?fit=max&auto=format&n=5TAKgT3IAyEwTGK_&q=85&s=a0d76c34fbe8fd0314a2030a402efb42" alt="ZulipRC" width="1274" height="996" data-path="images/connectors/zulip/ZulipRC.png" />

Keep this copied text to provide to UtopikAI in the next step

### Indexing

1. Navigate to the Admin Dashboard and select the **Zulip** Connector
2. In **Step 1**, paste in the copied `zuliprc` value
3. Grab your Zulip Realm/URL info, see below:

<img src="https://mintcdn.com/utopikai/5TAKgT3IAyEwTGK_/images/connectors/zulip/ZulipRealmURL.png?fit=max&auto=format&n=5TAKgT3IAyEwTGK_&q=85&s=70afc42cfaec128dd82af6937b5f9856" alt="ZulipRealmURL" width="526" height="566" data-path="images/connectors/zulip/ZulipRealmURL.png" />

4. In **Step 2**, provide the values for the Realm and URL

<img src="https://mintlify.s3.us-west-1.amazonaws.com/utopikai/images/connectors/zulip/UtopikAIZulipConfig.png" alt="UtopikAIZulipConfig" />