help: Document modal to generate bot URL.

Adds a help center article to document the new modal for generating
an integration URL, and links /integrations docs to this article.

Fixes #27744.

help/add-a-bot-or-integration.md

@@ -48,3 +48,4 @@ Depending on the type of bot you're creating, you may need to download its
 * [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)

help/bots-and-integrations.md

@@ -89,3 +89,4 @@ is visible and available for anyone to use.
 * [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)

help/generate-integration-url.md

@@ -0,0 +1,55 @@
+# Generate URL for an integration
+
+{start_tabs}
+
+{tab|via-personal-settings}
+
+{settings_tab|your-bots}
+
+1. Click the **link** (<i class="fa fa-link"></i>) icon on the profile card of
+   an **Incoming webhook** bot.
+
+1. Select the desired integration from the **Integration** dropdown.
+
+1. _(optional)_ Select the destination stream from the
+   **Where to send notifications** dropdown.
+
+1. _(optional)_ Select **Send all notifications to a single topic**, and
+   enter the topic name.
+
+1. Click **Copy URL** to add the URL to your clipboard.
+
+!!! tip ""
+
+    You can also click the **pencil** (<i class="fa fa-pencil"></i>) icon,
+    scroll down to the bottom, and click **Generate URL for an integration**.
+
+{tab|via-organization-settings}
+
+{!admin-only.md!}
+
+{settings_tab|bot-list-admin}
+
+1. In the **Actions** column, click the **pencil** (<i class="fa fa-pencil"></i>)
+   icon for an **Incoming webhook** bot.
+
+1. Scroll down to the bottom, and click **Generate URL for an integration**.
+
+1. Select the desired integration from the **Integration** dropdown.
+
+1. _(optional)_ Select the destination stream from the
+   **Where to send notifications** dropdown.
+
+1. _(optional)_ Select **Send all notifications to a single topic**, and
+   enter the topic name.
+
+1. Click **Copy URL** to add the URL to your clipboard.
+
+{end_tabs}
+
+## Related articles
+
+* [Bots and integrations](/help/bots-and-integrations)
+* [Add a bot or integration](/help/add-a-bot-or-integration)
+* [View all bots in your organization](/help/view-all-bots-in-your-organization)
+* [Request an integration](/help/request-an-integration)

help/include/sidebar_index.md

@@ -228,6 +228,7 @@
 ## Bots & integrations
 * [Bots and integrations](/help/bots-and-integrations)
 * [Add a bot or integration](/help/add-a-bot-or-integration)
+* [Generate integration URL](/help/generate-integration-url)
 * [Edit a bot](/help/edit-a-bot)
 * [Deactivate or reactivate a bot](/help/deactivate-or-reactivate-a-bot)
 * [Request an integration](/help/request-an-integration)

templates/zerver/integrations/include/generate-integration-url.md

@@ -1,6 +1,6 @@
-Generate the URL for your {{ integration_display_name }} integration,
-with the stream (and topic) you want notifications sent to, by [viewing
-the bot you created](/help/view-your-bots) and clicking the **link**
+[Generate the URL][generate-url] for your {{ integration_display_name }}
+integration, with the stream (and topic) you want notifications sent to,
+by [viewing the bot you created][view-your-bots] and clicking the **link**
 (<i class="fa fa-link"></i>) icon on the bot's profile card.
 
 The generated URL will be something like:
@@ -16,4 +16,6 @@ see [the webhook URLs specification][incoming-webhook-urls].*
 
 {% endif %}
 
+[generate-url]: /help/generate-integration-url
+[view-your-bots]: /help/view-your-bots
 [incoming-webhook-urls]: /api/incoming-webhooks-overview#urls