mirror of
https://github.com/zulip/zulip.git
synced 2025-11-22 07:21:23 +00:00
67e77ad370
As the help center article now has detailed instructions to generate an incoming webhook URL, the integration documentation only needs to link to that information.
63 lines
1.9 KiB
Markdown
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)
|