zulip/help/generate-integration-url.md

63 lines
1.9 KiB
Markdown

# Generate URL for an integration
Many [Zulip integrations](/integrations/) are webhooks. An incoming webhook
integration allows a third-party service, such as an [issue
tracker](/integrations/doc/github) or an [alerting
tool](/integrations/doc/pagerduty), to post updates to Zulip. To configure
where these updates will be posted, you need to generate a special Zulip
integration URL.
{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)