Some checks failed
Code scanning / CodeQL (push) Failing after 15s
Zulip production suite / Ubuntu 22.04 production build (push) Failing after 26s
Zulip production suite / Debian 12 production install with custom db name and user (push) Has been skipped
Zulip production suite / Ubuntu 22.04 production install and PostgreSQL upgrade with pgroonga (push) Has been skipped
Zulip production suite / Ubuntu 24.04 production install (push) Has been skipped
Zulip production suite / Ubuntu 26.04 production install (push) Has been skipped
Zulip production suite / Debian 13 production install (push) Has been skipped
Zulip production suite / 7.0 Version Upgrade (push) Has been skipped
Zulip production suite / 8.0 Version Upgrade (push) Has been skipped
Zulip production suite / 6.0 Version Upgrade (push) Has been skipped
Zulip production suite / 10.0 Version Upgrade (push) Has been skipped
Zulip production suite / 9.0 Version Upgrade (push) Has been skipped
Zulip production suite / 12.0 Version Upgrade (push) Has been skipped
Zulip production suite / 11.0 Version Upgrade (push) Has been skipped
GitHub Actions Security Analysis with zizmor / zizmor (push) Failing after 3s
Zulip CI / Debian 12 (Python 3.11, backend + documentation) (push) Failing after 26s
Zulip CI / Ubuntu 22.04 (Python 3.10, backend + frontend) (push) Failing after 3s
Zulip CI / Ubuntu 24.04 (Python 3.12, backend) (push) Failing after 25s
Zulip CI / Ubuntu 26.04 (Python 3.14, backend) (push) Failing after 25s
Zulip CI / Debian 13 (Python 3.13, backend) (push) Failing after 28s
Zulip production suite / Required jobs (push) Has been cancelled
Zulip CI / Required jobs (push) Has been cancelled
API Documentation Update Check / check-feature-level-updated (push) Has been cancelled
API Documentation Update Check / notify-if-api-docs-changed (push) Has been cancelled
60 lines
1.9 KiB
Plaintext
60 lines
1.9 KiB
Plaintext
---
|
|
title: Add a bot or integration
|
|
---
|
|
|
|
import {TabItem, Tabs} from "@astrojs/starlight/components";
|
|
|
|
import FlattenedSteps from "../../components/FlattenedSteps.astro";
|
|
import NavigationSteps from "../../components/NavigationSteps.astro";
|
|
import ZulipNote from "../../components/ZulipNote.astro";
|
|
|
|
By default, anyone other than guests can add a bot to a Zulip organization.
|
|
A bot that sends content to or from another product is often called an
|
|
[integration](/help/integrations-overview).
|
|
|
|
Organization administrators can also
|
|
[restrict bot creation](/help/restrict-bot-creation). Any bot that is added
|
|
is visible and available for anyone to use.
|
|
|
|
## Add a bot or integration
|
|
|
|
<Tabs>
|
|
<TabItem label="Your bots">
|
|
<FlattenedSteps>
|
|
<NavigationSteps target="settings/your-bots" />
|
|
|
|
1. Click **Add a new bot**.
|
|
1. Fill out the fields, and click **Add**.
|
|
</FlattenedSteps>
|
|
</TabItem>
|
|
|
|
<TabItem label="All bots">
|
|
<FlattenedSteps>
|
|
<NavigationSteps target="settings/bots" />
|
|
|
|
1. Click **Add a new bot**.
|
|
1. Fill out the fields, and click **Add**.
|
|
</FlattenedSteps>
|
|
</TabItem>
|
|
</Tabs>
|
|
|
|
<ZulipNote>
|
|
See [bots overview](/help/bots-overview) for more information about
|
|
the various fields.
|
|
Nearly all third-party integrations should use **Incoming webhook**
|
|
as the **bot type**.
|
|
</ZulipNote>
|
|
|
|
Depending on the type of bot you're creating, you may need to download its
|
|
[`zuliprc` configuration file](/help/manage-a-bot#download-zuliprc-configuration-file).
|
|
|
|
## Related articles
|
|
|
|
* [Bots overview](/help/bots-overview)
|
|
* [Integrations overview](/help/integrations-overview)
|
|
* [Manage a bot](/help/manage-a-bot)
|
|
* [Deactivate or reactivate a bot](/help/deactivate-or-reactivate-a-bot)
|
|
* [Restrict bot creation](/help/restrict-bot-creation)
|
|
* [View all bots in your organization](/help/view-all-bots-in-your-organization)
|
|
* [Generate URL for an integration](/help/generate-integration-url)
|