snapshot of https://github.com/zulip/zulip.git @ 48c69911c7dd4e03b20552eb3bd77ad8151c1357 (2026-09-15)

starlight_help/src/content/docs/add-a-bot-or-integration.mdx

@@ -0,0 +1,59 @@
+---
+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)