mirror of
				https://github.com/zulip/zulip.git
				synced 2025-11-04 14:03:30 +00:00 
			
		
		
		
	integration-docs: Update Zapier for new doc format.
Part of zulip #29592. Co-authored-by: Lauryn Menard <lauryn@zulip.com>
This commit is contained in:
		@@ -1,46 +1,47 @@
 | 
				
			|||||||
 | 
					# Zulip Zapier integration
 | 
				
			||||||
 | 
					
 | 
				
			||||||
Zapier supports integrations with
 | 
					Zapier supports integrations with
 | 
				
			||||||
[hundreds of popular products](https://zapier.com/apps). Get notifications
 | 
					[hundreds of popular products](https://zapier.com/apps). Get notifications
 | 
				
			||||||
sent by Zapier directly in Zulip.
 | 
					sent by Zapier directly in Zulip.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					{start_tabs}
 | 
				
			||||||
 | 
					
 | 
				
			||||||
1. {!create-channel.md!}
 | 
					1. {!create-channel.md!}
 | 
				
			||||||
 | 
					
 | 
				
			||||||
1. {!create-an-incoming-webhook.md!}
 | 
					1. {!create-an-incoming-webhook.md!}
 | 
				
			||||||
 | 
					
 | 
				
			||||||
1. Create an account on [Zapier](https://zapier.com).
 | 
					1. Create an account on [Zapier](https://zapier.com). Go to [Zulip
 | 
				
			||||||
 | 
					   Integrations][1], and select the app you want to connect to Zulip.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
1. Go to [Zulip Integrations](https://zapier.com/apps/zulip/integrations).
 | 
					1. Under **Choose a Trigger**, select an event in the app you are
 | 
				
			||||||
 | 
					   connecting to Zulip. Under **Choose an Action**, select **Send a
 | 
				
			||||||
 | 
					   Private Message** or **Send a Stream Message**. Click **Connect**.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
1. Scroll down to click on the app you want to connect to Zulip, or find it via
 | 
					1. Follow the instructions in the right sidebar to set up the trigger
 | 
				
			||||||
   the search box.
 | 
					   event.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
1. Under **Choose a Trigger**, select an event in the app you are connecting to Zulip.
 | 
					1. Select the Zulip action in the center panel, and under **Account** in
 | 
				
			||||||
 | 
					   the right sidebar, click **Sign in** to connect your bot to Zapier.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
1. Under **Choose an Action**, select **Send a Private Message** or **Send a
 | 
					1. On the **Allow Zapier to access your Zulip Account** screen, enter
 | 
				
			||||||
   Stream Message**.
 | 
					   the URL for your Zulip organization, and the email address and API
 | 
				
			||||||
 | 
					   key of the bot you created above.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
1. Follow the instructions in the right sidebar to set up the trigger event.
 | 
					1. Under **Action** in the right sidebar, configure **Recipients** for
 | 
				
			||||||
 | 
					   direct messages, or **Stream name** and **Topic** for channel
 | 
				
			||||||
1. Click on the Zulip action you selected in the center panel.
 | 
					   messages. Configure **Message content**.
 | 
				
			||||||
 | 
					 | 
				
			||||||
1. Under **Account** in the right sidebar, click **Sign in** to connect your bot
 | 
					 | 
				
			||||||
   to Zapier.
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
1. On the **Allow Zapier to access your Zulip Account?** screen, enter the URL for
 | 
					 | 
				
			||||||
   your Zulip organization, and the email address and API key of the bot you
 | 
					 | 
				
			||||||
   created above.
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
1. Under **Action** in the right sidebar, configure **Recipients** for a direct
 | 
					 | 
				
			||||||
   message, or **Stream name** and **Topic**, as well as **Message content**.
 | 
					 | 
				
			||||||
 | 
					
 | 
				
			||||||
    !!! tip ""
 | 
					    !!! tip ""
 | 
				
			||||||
        To send direct messages, enter a **Zulip account email** in the
 | 
					        To receive notifications as direct messages, if your email
 | 
				
			||||||
        **Recipients** box, if the email is [configured](/help/configure-email-visibility)
 | 
					        in Zulip is [configured](/help/configure-email-visibility)
 | 
				
			||||||
        to be visible to **Admins, moderators, members and guests**. Otherwise, enter
 | 
					        to be visible to **Admins, moderators, members and guests**,
 | 
				
			||||||
        `user` + [user ID](/help/view-someones-profile) + `@your Zulip domain`. For
 | 
					        enter the email associated with your Zulip account in the
 | 
				
			||||||
        example: `user123@acme.zulipchat.com`.
 | 
					        **Recipients** field. Otherwise, enter `user` +
 | 
				
			||||||
 | 
					        [your user ID](/help/view-someones-profile) +
 | 
				
			||||||
 | 
					        `@` + your Zulip domain, e.g., `user123@acme.zulipchat.com`.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
1. When everything has been configured as desired, click **Publish** to enable
 | 
					1. Click **Publish** to enable your Zap.
 | 
				
			||||||
   your Zap.
 | 
					 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					{end_tabs}
 | 
				
			||||||
 | 
					
 | 
				
			||||||
**Congratulations! You're done!**
 | 
					[1]: https://zapier.com/apps/zulip/integrations
 | 
				
			||||||
 
 | 
				
			|||||||
		Reference in New Issue
	
	Block a user