zulip/help/generate-integration-url.md

2.2 KiB

Generate URL for an integration

Many Zulip integrations are webhooks. An incoming webhook integration allows a third-party service, such as an issue tracker or an alerting tool, 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 () icon on the profile card of an Incoming webhook bot.

  2. Select the desired integration from the Integration dropdown.

  3. (optional) Select the destination channel from the Where to send notifications dropdown.

  4. (optional) Select Send all notifications to a single topic, and enter the topic name.

  5. (optional) Select Filter events that will trigger notifications?, and select which supported events should trigger notifications.

  6. 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 () icon for an Incoming webhook bot.

  2. Scroll down to the bottom, and click Generate URL for an integration.

  3. Select the desired integration from the Integration dropdown.

  4. (optional) Select the destination channel from the Where to send notifications dropdown.

  5. (optional) Select Send all notifications to a single topic, and enter the topic name.

  6. (optional) Select Filter events that will trigger notifications?, and select which supported events should trigger notifications.

  7. Click Copy URL to add the URL to your clipboard.

{end_tabs}