mirror of
				https://github.com/zulip/zulip.git
				synced 2025-11-03 21:43:21 +00:00 
			
		
		
		
	- Cross-link as appropriate, both in related articles and in the content of the pages. Fixes #28758.
		
			
				
	
	
		
			64 lines
		
	
	
		
			2.0 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
	
			
		
		
	
	
			64 lines
		
	
	
		
			2.0 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
 | 
						|
 | 
						|
* [Integrations overview](/help/integrations-overview)
 | 
						|
* [Bots overview](/help/bots-overview)
 | 
						|
* [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)
 |