> ## Documentation Index
> Fetch the complete documentation index at: https://danswer-kanban-documentation-language-support.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Zulip

> Access messages from Zulip streams

## How it works

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

## Setting up

### Authorization

<Steps>
  <Step title="Understand Zulip bot auth">
    Onyx 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)
  </Step>

  <Step title="Create a Zulip Bot">
    Start by creating a Zulip Bot.

    <img className="rounded-image" src="https://mintcdn.com/danswer-kanban-documentation-language-support/atEzCGikq27XtxXt/assets/admins/connectors/zulip/ZulipBot.png?fit=max&auto=format&n=atEzCGikq27XtxXt&q=85&s=c255f13fa4f2fc21950e02364640fce6" alt="Creating a bot user in Zulip settings" width="1568" height="1718" data-path="assets/admins/connectors/zulip/ZulipBot.png" />
  </Step>

  <Step title="Copy zuliprc contents">
    Copy the Bot authentication info (`zuliprc` contents), see red arrow below:

    <img className="rounded-image" src="https://mintcdn.com/danswer-kanban-documentation-language-support/atEzCGikq27XtxXt/assets/admins/connectors/zulip/ZulipRC.png?fit=max&auto=format&n=atEzCGikq27XtxXt&q=85&s=a02ca8a4fbc621ead40154fd6a9e6151" alt="Zulip bot page highlighting the zuliprc configuration download" width="1274" height="996" data-path="assets/admins/connectors/zulip/ZulipRC.png" />

    Keep this copied text to provide to Onyx in the next step
  </Step>
</Steps>

### Indexing

<Steps>
  <Step title="Open Zulip connector">
    Navigate to the Admin Panel and select the **Zulip** Connector
  </Step>

  <Step title="Paste zuliprc">
    In **Step 1**, paste in the copied `zuliprc` value
  </Step>

  <Step title="Get Realm/URL">
    Grab your Zulip Realm/URL info, see below:

    <img className="rounded-image" src="https://mintcdn.com/danswer-kanban-documentation-language-support/atEzCGikq27XtxXt/assets/admins/connectors/zulip/ZulipRealmURL.png?fit=max&auto=format&n=atEzCGikq27XtxXt&q=85&s=7f7c80d7252ec0ba4352f155450bbd01" alt="Zulip UI showing Realm and URL details" width="526" height="566" data-path="assets/admins/connectors/zulip/ZulipRealmURL.png" />
  </Step>

  <Step title="Enter Realm and URL">
    In **Step 2**, provide the values for the Realm and URL

    <img className="rounded-image" src="https://mintcdn.com/danswer-kanban-documentation-language-support/atEzCGikq27XtxXt/assets/admins/connectors/zulip/OnyxZulipConfig.png?fit=max&auto=format&n=atEzCGikq27XtxXt&q=85&s=6e24bc4b8e43acf719b4b1d77126f711" alt="Onyx Zulip connector configuration with realm, URL, and zuliprc" width="1256" height="1440" data-path="assets/admins/connectors/zulip/OnyxZulipConfig.png" />
  </Step>
</Steps>